[irc/anope/website.git] / upgrading.md

---
title: Upgrading from 2.0 to 2.1
layout: simple
---

Upgrading from 2.0 to 2.1 can be done by:

#### General

0. Update any scripts you have that execute `services` to execute `anope` instead.

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.

#### services.conf

0. Rename `services.conf` to `anope.conf`.

0. Replace `uplink:ipv6` with `uplink:protocol` ([example](https://github.com/anope/anope/blob/2.1.0/data/anope.example.conf#L172-L176)).

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.

0. If you are using the `inspircd3` protocol module then replace it with the `inspircd` module.

0. If you are using the `inspircd12` or `inspircd20` protocol modules then upgrade your IRCd and replace it with the `inspircd` module.

0. If you are using the `unreal4` protocol module then replace it with the `unrealircd` module.

0. If you are using the `unreal` protocol module then upgrade your IRCd and replace it with the `unrealircd` module.

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)).

0. Replace the `nickserv/access` privilege in operator accounts with the `nickserv/cert` privilege.

0. Add the `global/queue` and `global/server` privileges to operator accounts with the `global/global` privilege.

0. Update `serverinfo:motd` to be relative to the config directory.

0. Update `serverinfo:pid` to be relative to the data directory.

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)).

#### botserv.conf

0. Add a description to the `GREET` privilege ([example](https://github.com/anope/anope/blob/2.1.1/data/botserv.example.conf#L326)).

#### chanserv.conf

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)).

0. Add the `UNBANME` privilege for `chanserv/unban` ([example](https://github.com/anope/anope/blob/2.1.1/data/chanserv.example.conf#L791-L806)).

0. Remove the `cs_secure` option from `module:defaults` for the `chanserv` module.

#### global.conf

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)).

#### chanstats.conf

0. Remove the `m_` prefix from the `chanstats` module.

#### nickserv.conf

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])).

0. Remove the `nickserv/set/secure` and `nickserv/saset/secure` commands.

0. Remove the `ns_access` module and `nickserv/access` command.

0. Remove the `ns_getpass` module and `nickserv/getpass` command.

0. Remove the `ns_status` module and `nickserv/status` command.

0. Remove the `ns_secure` option from `module:defaults` for the `nickserv` module.

0. Rename `nickserv:passlen` to `nickserv:maxpasslen`.

0. Replace `options:strictpasswords` with `nickserv:minpasslen` ([example](https://github.com/anope/anope/blob/2.1.0/data/nickserv.example.conf#L212-L217)).

#### modules.conf

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)).

0. If enabled remove the `module:sslv3` from the `ssl_openssl` module (now always disabled).

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.

0. If enabled replace the `m_regex_pcre` module with the `regex_pcre2` module.

0. If enabled update `module:cert`, `module:dhparams`, and `module:key` for the `ssl_gnutls` module to be relative to the config directory.

0. If enabled update `module:cert` and `module:key` for the `ssl_openssl` module to be relative to the config directory.

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)).

#### operserv.conf

0. Remove the `os_oline` module and `operserv/oline` command.

#### stats.standalone.conf

0. Remove the `m_` prefix from the `mysql` module.
Commit	Line	Data
51b3b7ba SP	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
63b1d4eb SP	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.
63b1d4eb SP	13
51b3b7ba SP	14	#### services.conf
	15
	16	0. Rename `services.conf` to `anope.conf`.
	17
01f50da6	18	0. Replace `uplink:ipv6` with `uplink:protocol` ([example](https://github.com/anope/anope/blob/2.1.0/data/anope.example.conf#L172-L176)).
51b3b7ba	19
b6b8104d SP	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.
b6b8104d SP	21
51b3b7ba SP	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
678694dc	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)).
51b3b7ba	31
bd6293b1 SP	32	0. Replace the `nickserv/access` privilege in operator accounts with the `nickserv/cert` privilege.
bd6293b1 SP	33
678694dc SP	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
ebf10d4b SP	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
bd6293b1 SP	52	0. Remove the `cs_secure` option from `module:defaults` for the `chanserv` module.
bd6293b1 SP	53
678694dc SP	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
12490972	58	#### chanstats.conf
51b3b7ba	59
12490972	60	0. Remove the `m_` prefix from the `chanstats` module.
51b3b7ba	61
12490972 SP	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])).
51b3b7ba	65
bd6293b1 SP	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
51b3b7ba SP	70	0. Remove the `ns_getpass` module and `nickserv/getpass` command.
51b3b7ba SP	71
bd6293b1 SP	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
12490972 SP	76	0. Rename `nickserv:passlen` to `nickserv:maxpasslen`.
12490972 SP	77
678694dc	78	0. Replace `options:strictpasswords` with `nickserv:minpasslen` ([example](https://github.com/anope/anope/blob/2.1.0/data/nickserv.example.conf#L212-L217)).
51b3b7ba	79
ebf10d4b SP	80	#### modules.conf
ebf10d4b SP	81
12490972 SP	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.
ebf10d4b	89
678694dc SP	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
51b3b7ba SP	96	#### operserv.conf
	97
	98	0. Remove the `os_oline` module and `operserv/oline` command.
12490972 SP	99
	100	#### stats.standalone.conf
	101
	102	0. Remove the `m_` prefix from the `mysql` module.