How to: Change an InterWorx License Key
=======================================

.. contents::

.. 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
   :doc:`here </nodeworx/general/license_management/change-license-binding>`.

To Change the License Key from the GUI
--------------------------------------

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. In NodeWorx, navigate to **Server > Settings**
#. Under Version, update the `License Key` field with the **New InterWorx Key**
#. Click **Save**

.. image:: /images/license-key-form.png
   :alt: InterWorx license key field

To Change the License Key From the CLI
--------------------------------------

#. Log in to the server at the CLI as root, either via SSH or from the
   terminal
#. At the CLI, use a text editor to open ``/home/interworx/iworx.ini``.
#. Look for the file section labeled: ``[iworx.license]``. The section should
   look similar to this:

   .. code-block::

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

#. Edit the ``key=`` line to reference the updated key
#. 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.

#. Log in to the server at the CLI as root, either via SSH or from the terminal
#. Run the license sync command:

   .. code-block::

      ~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 <https://support.interworx.com>`__ to have the
     license binding cleared

   .. code::

      [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 ~]#