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 #### services.conf
  13
  14 0. Rename `services.conf` to `anope.conf`.
  15
  16 0. Replace `uplink:ipv6` with `uplink:protocol` ([example](https://github.com/anope/anope/blob/2.1.0/data/anope.example.conf#L172-L176)).
  17
  18 0. If you are using the `inspircd3` protocol module then replace it with the `inspircd` module.
  19
  20 0. If you are using the `inspircd12` or `inspircd20` protocol modules then upgrade your IRCd and replace it with the `inspircd` module.
  21
  22 0. If you are using the `unreal4` protocol module then replace it with the `unrealircd` module.
  23
  24 0. If you are using the `unreal` protocol module then upgrade your IRCd and replace it with the `unrealircd` module.
  25
  26 0. Move the `enc_md5`, `enc_none` and `enc_sha1` modules to be secondary encryption modules and add `enc_bcrypt` or `enc_sha256` as a new primary encryption module ([example](https://github.com/anope/anope/blob/2.1.0/data/anope.example.conf#L1219-L1256)).
  27
  28 #### botserv.conf
  29
  30 0. Add a description to the `GREET` privilege ([example](https://github.com/anope/anope/blob/2.1.1/data/botserv.example.conf#L326)).
  31
  32 #### chanserv.conf
  33
  34 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)).
  35
  36 0. Add the `UNBANME` privilege for `chanserv/unban` ([example](https://github.com/anope/anope/blob/2.1.1/data/chanserv.example.conf#L791-L806)).
  37
  38 #### chanstats.conf
  39
  40 0. Remove the `m_` prefix from the `chanstats` module.
  41
  42 #### nickserv.conf
  43
  44 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])).
  45
  46 0. Remove the `ns_getpass` module and `nickserv/getpass` command.
  47
  48 0. Rename `nickserv:passlen` to `nickserv:maxpasslen`.
  49
  50 0. Replace `nickserv:strictpasswords` with `nickserv:minpasslen` ([example](https://github.com/anope/anope/blob/2.1.0/data/nickserv.example.conf#L212-L217)).
  51
  52 #### modules.conf
  53
  54 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)).
  55
  56 0. If enabled remove the `module:sslv3` from the `ssl_openssl` module (now always disabled).
  57
  58 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.
  59
  60 0. If enabled replace the `m_regex_pcre` module with the `regex_pcre2` module.
  61
  62 #### operserv.conf
  63
  64 0. Remove the `os_oline` module and `operserv/oline` command.
  65
  66 #### stats.standalone.conf
  67
  68 0. Remove the `m_` prefix from the `mysql` module.