Contents
Upgrading Feature Server
Use this procedure to upgrade from one version of SIP Feature Server 8.1.2 to another. Note the following restrictions:
- Transitioning from SIP Voicemail to SIP Feature Server requires a fresh installation.
- You cannot change installation modes (cluster to standalone or vice-versa).
Upgrading while Feature Server is running (recommended)
To upgrade a running Feature Server environment, stop and upgrade one Feature Server Cassandra cluster instance at a time, beginning with the master Feature Server.
- On the Feature Server master node (which is also the Cassandra seeds node), back up all files in the etc folder, which includes the cassandra.yaml file.
- Stop Feature Server.
- Install Feature Server from the installation package. During the upgrade, the installer uses the values provided during a fresh installation.
- Start Feature Server.
- Repeat steps 2-4 for each Feature Server instance.
- Upgrade or install and configure the Feature Server GAX Plug-in.
- If you are updating a Feature Server 8.1.200.88 environment that also uses the Feature Server dial plan, you must run a migration script.
- Optionally, create and assign voicemail profiles.
Upgrading while Feature Server is stopped
To upgrade a running Feature Server environment, upgrade one Feature Server Cassandra cluster instance at a time. Upgrade the master Feature Server last.
- On the Feature Server master node (which is also the Cassandra seeds node), back up all files in the etc folder, which includes the cassandra.yaml file. Do not upgrade the master node until after you have upgraded all other nodes.
- On a non-master node, install Feature Server from the installation package. During the upgrade, the installer uses the values provided during a fresh installation.
- Start Feature Server.
- Repeat steps 2-3 for each Feature Server instance.
- Upgrade or install and configure the Feature Server GAX Plug-in.
- If you are updating a Feature Server 8.1.200.88 environment that also uses the Feature Server dial plan, you must run a migration script.
- Optionally, create and assign voicemail profiles.
Restore HTTPS configuration
The following procedure shows how to restore HTTPS configuration of Feature Server after an upgrade. This procedure is applicable only while upgrading Feature Server to version 8.1.201.92 or above.
- After upgrading to version 8.1.201.93 or above, the Feature Server installation folder contains the following files retrieved from the folder containing the previous versions: start.ini.bak and etc.bak in both Windows and Linux operating systems. Previously, when upgrading Feature Server overwrote these files rather than retrieving existing files.
- Compare and copy the difference in the values of start.ini, start.ini.bak and etc/jetty-ssl.xml, etc.bak/jetty-ssl.xml and apply the differences in start.ini and etc/jetty-ssl.xml.
- Copy etc.bak/keystore to etc/keystore to restore the configuration.
Post upgrade steps for version 8.1.203 and later
If you have upgraded SIP Feature Server to version 8.1.203 and later and used external Cassandra in your deployment, you can deactivate the Embedded Cassandra module from the deployment. Note that deactivating the Embedded Cassandra module is recommended but it is an optional step.
To deactivate the Embedded Cassandra module:
- Locate the start.ini file in the path: <FS installation folder>/start.ini.
- Open the file with a text editor and remove the line --module=fs-cass11.
- Save the file.
- Restart SIP Feature Server if it is running.
- After restart, remove the installation files from the <FS installation folder>/lib/fs-cass11 folder.