upgrading.md

   1 ---
   2 title: Upgrading from 2.0 to 2.1
   3 layout: simple
   4 ---
   5
   6 Upgrading from 2.0 to 2.1 can be done by:
   7
   8 #### General
   9
  10 0. Update any scripts you have that execute `services` to execute `anope` instead.
  11
  12 0. If you are using the `db_sql` or `db_sql_live` modules it is recommended that on 2.0 you load `db_flatfile` and export your database to a file and re-import on 2.1 to update the schema of your database.
  13
  14 #### services.conf
  15
  16 0. Rename `services.conf` to `anope.conf`.
  17
  18 0. Replace `uplink:ipv6` with `uplink:protocol` ([example](https://github.com/anope/anope/blob/2.1.0/data/anope.example.conf#L172-L176)).
  19
  20 0. If you are using the `charybdis` protocol module then migrate to [Solanum](https://github.com/solanum-ircd/solanum) and replace it with the `solanum` module.
  21
  22 0. If you are using the `inspircd3` protocol module then replace it with the `inspircd` module.
  23
  24 0. If you are using the `inspircd12` or `inspircd20` protocol modules then upgrade your IRCd and replace it with the `inspircd` module.
  25
  26 0. If you are using the `unreal4` protocol module then replace it with the `unrealircd` module.
  27
  28 0. If you are using the `unreal` protocol module then upgrade your IRCd and replace it with the `unrealircd` module.
  29
  30 0. Move the `enc_md5`, `enc_none`, `enc_sha1`, and `enc_sha256` modules to be secondary encryption modules and add `enc_argon2`, `enc_bcrypt`, or `enc_sha2` as a new primary encryption module ([example](https://github.com/anope/anope/blob/2.1.4/data/anope.example.conf#L1228-L1345)).
  31
  32 0. Replace the `nickserv/access` privilege in operator accounts with the `nickserv/cert` privilege.
  33
  34 0. Add the `global/queue` and `global/server` privileges to operator accounts with the `global/global` privilege.
  35
  36 0. Update `serverinfo:motd` to be relative to the config directory.
  37
  38 0. Update `serverinfo:pid` to be relative to the data directory.
  39
  40 0. If you are using email then add the `i` flag to the sendmail command ([example](https://github.com/anope/anope/blob/2.1.4/data/anope.example.conf#L953)).
  41
  42 #### botserv.conf
  43
  44 0. Add a description to the `GREET` privilege ([example](https://github.com/anope/anope/blob/2.1.1/data/botserv.example.conf#L326)).
  45
  46 #### chanserv.conf
  47
  48 0. Add a description to the `ACCESS_CHANGE`, `ACCESS_LIST`, `AKICK`, `ASSIGN`, `AUTOHALFOP`, `AUTOOP`, `AUTOOWNER`, `AUTOPROTECT`, `AUTOVOICE`, `BADWORDS`, `BAN`, `FANTASIA`, `FOUNDER`, `GETKEY`, `HALFOP`, `HALFOPME`, `INFO`, `INVITE`, `KICK`, `MEMO`, `MODE`, `NOKICK`, `OP`, `OPME`, `OWNER`, `OWNERME`, `PROTECT`, `PROTECTME`, `SAY`, `SET`, `SIGNKICK`, `TOPIC`, `UNBAN`, `UNBANME`, `VOICE`, and `VOICEME` privileges ([example](https://github.com/anope/anope/blob/2.1.1/data/chanserv.example.conf#L209-L842)).
  49
  50 0. Add the `UNBANME` privilege for `chanserv/unban` ([example](https://github.com/anope/anope/blob/2.1.1/data/chanserv.example.conf#L791-L806)).
  51
  52 0. Remove the `cs_secure` option from `module:defaults` for the `chanserv` module.
  53
  54 #### global.conf
  55
  56 0. Add the `gl_queue` and `gl_server` modules and their commands ([example](https://github.com/anope/anope/blob/2.1.4/data/global.example.conf#L117-L141)).
  57
  58 #### chanstats.conf
  59
  60 0. Remove the `m_` prefix from the `chanstats` module.
  61
  62 #### nickserv.conf
  63
  64 0. Add the `nickserv/set/neverop` and `nickserv/saset/neverop` commands ([example](https://github.com/anope/anope/blob/2.1.0/data/nickserv.example.conf#L581-L582])).
  65
  66 0. Remove the `nickserv/set/secure` and `nickserv/saset/secure` commands.
  67
  68 0. Remove the `ns_access` module and `nickserv/access` command.
  69
  70 0. Remove the `ns_getpass` module and `nickserv/getpass` command.
  71
  72 0. Remove the `ns_status` module and `nickserv/status` command.
  73
  74 0. Remove the `ns_secure` option from `module:defaults` for the `nickserv` module.
  75
  76 0. Rename `nickserv:passlen` to `nickserv:maxpasslen`.
  77
  78 0. Replace `options:strictpasswords` with `nickserv:minpasslen` ([example](https://github.com/anope/anope/blob/2.1.0/data/nickserv.example.conf#L212-L217)).
  79
  80 #### modules.conf
  81
  82 0. If enabled add `module:tlsv10`, `module:tlsv11`, and `module:tlsv12` to the `ssl_openssl` module ([example](https://github.com/anope/anope/blob/2.1.2/data/modules.example.conf#L632-L639)).
  83
  84 0. If enabled remove the `module:sslv3` from the `ssl_openssl` module (now always disabled).
  85
  86 0. If enabled remove the the `m_` prefix from the `dns`, `dnsbl`, `helpchan`, `httpd`, `ldap`, `ldap_oper`, `mysql`, `proxyscan`, `redis`, `regex_pcre2`, `regex_posix`, `regex_stdlib`, `regex_tre`, `rewrite`, `sasl`, `sql_log`, `sql_oper`, `sqlite`, `ssl_gnutls`, `ssl_openssl`, `xmlrpc`, and `xmlrpc_main` modules.
  87
  88 0. If enabled replace the `m_regex_pcre` module with the `regex_pcre2` module.
  89
  90 0. If enabled update `module:cert`, `module:dhparams`, and `module:key` for the `ssl_gnutls` module to be relative to the config directory.
  91
  92 0. If enabled update `module:cert` and `module:key` for the `ssl_openssl` module to be relative to the config directory.
  93
  94 0. If enable replace `module:template` replace for the `webcpanel` module with `module:template_dir` ([example](https://github.com/anope/anope/blob/2.1.4/data/modules.example.conf#L777-L781)).
  95
  96 #### operserv.conf
  97
  98 0. Remove the `os_oline` module and `operserv/oline` command.
  99
 100 #### stats.standalone.conf
 101
 102 0. Remove the `m_` prefix from the `mysql` module.