How to: Change the IP Binding of an InterWorx License
=====================================================

The IP binding for an InterWorx license key may be changed from the InterWorx billing portal. 
This may be necessary if the license is moved to a new server, or if the IPs on the server change.

.. note::

   These instructions are for licenses purchased directly from InterWorx.  

   Customers who purchased their licenses from an Authorized Reseller Partner must contact their
   reseller for assistance.


.. contents:: 

To Change the License Binding
-----------------------------

#. Log into the billing portal at `https://portal.interworx.com <https://portal.interworx.com>`__
#. Click **Services**
#. From the list of license keys, select the license for which the IP should be changed
#. Click **Current IP Address** that is shown next to Bound IP
#. Update the `Bound IP` field with the **new IP Address**
#. Click **Submit**

To Sync the License Binding
---------------------------

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 binding and running the sync command, the follow errror 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 ~]#