Best Practices for adding a new license in Spectrum 9.0 and later

Document ID : KB000050130
Last Modified Date : 14/02/2018
Show Technical Document Details


On occasions it is necessary to apply new licenses, for example, when additional components / functionality are purchased from CA.

Whenever you get a new key to unlock new components you MUST go back and install the new components using the 9.x.0.0 base media (including 9.1 / 9.2) then reapply the latest hotfix that you are on.


The correct procedure for applying a new license to access a new feature is as follows:

  1. Stop the SpectroServer / OneClick / processes etc. as you would when installing a hotfix (see Chapter 3 of the Installation Guide for more details).

  2. If, for example, you are running 9.2.1, launch the base 9.2.0 install by running the setup.exe for 9.2.0.

  3. Input the new license key when prompted for the license.

  4. Install the new component(s).

  5. Repeat this on all SpectroServers and any standalone OneClick hosts.

  6. Reapply 9.2.1 (or the latest hotfix) for all SpectroServers and standalone OneClick servers.

  7. Any PTF or debug patches currently installed after the latest hotfix or service pack will also have to be reapplied.


  1. Always make sure to take a backup of the SpectroServer database before carrying out steps to apply the new license.

  2. If you have any custom events or alarms in place you will need to take a backup copy of the $SPECROOT/custom folder first to ensure they are not overwritten, and then copy the folder back afterwards.

  3. The reinstall as part of applying the new license will only install the new components. It will not reinstall any components already installed.

  4. You should not change the license via the Spectrum Control Panel / Configure window.

  5. 9.0 is the base install for releases 9.1.x.