How to: Change an InterWorx License Key

Note

If moving an existing InterWorx License Key to a new server, please make sure that the IP associated with the key has been updated in the billing portal. Instructions on how to do so can be found here.

To Change the License Key from the GUI

  1. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)

  2. In NodeWorx, navigate to Server > Settings

  3. Under Version, update the License Key field with the New InterWorx Key

  4. Click Save

InterWorx license key field

To Change the License Key From the CLI

  1. Log in to the server at the CLI as root, either via SSH or from the terminal

  2. At the CLI, use a text editor to open /home/interworx/iworx.ini.

  3. Look for the file section labeled: [iworx.license]. The section should look similar to this:

    [iworx.license]
file="/home/interworx/.license"
key="INTERWORX_EXAMPLEKEY"
message_file="/home/interworx/.license-message"
upgrade-link="http://www.interworx.com/buy-now/"

  4. Edit the key= line to reference the updated key

  5. Save and exit the file

To Instantly Sync the License Key

License binding for the new key will automatically sync when the next Fively cron runs. However, this may be manually, instantly performed, as well.

  1. Log in to the server at the CLI as root, either via SSH or from the terminal

  2. Run the license sync command:

    ~iworx/cron/license.pex --sync

Troubleshooting

  • “Already been activated on a different IP” Error

    • If, after changing the license key and running the sync command, the follow error is received, submit a ticket at https://support.interworx.com to have the license binding cleared

    [root@server ~]# /usr/local/interworx/cron/license.pex --sync
The license server reports that the key 'INTERWORX_EXAMPLEKEY' has already been activated on a different IP. Please contact InterWorx Support.
[root@server ~]#