How-To: Activate Your InterWorx Control Panel License

Related Documentation: InterWorx Control Panel Script-based Installation Procedure

Prerequisites

  1. A fully installed InterWorx Control Panel server with no active license keys applied.
  2. An InterWorx Control Panel license key. License keys can be purchased through any authorized InterWorx Control Panel Reseller Partner

Purpose

This how-to will walk you through the process of installing / activating an InterWorx Control Panel license key on your InterWorx server.

Interactive Activation Procedure

  1. Login to your InterWorx Control Panel server via SSH and become the root user.
  2. Run the goiworx.pex script. 
root@server# cd /usr/local/interworx/bin
root@server# ./goiworx.pex

3. Enter your license key when prompted.

+----------------------------------------------------------------------+
|                            Go! InterWorx                             |
+----------------------------------------------------------------------+

+----------------------------------------------------------------------+
|                          License Key Setup                           |
+----------------------------------------------------------------------+

Please enter license key: INTERWORX_XXXXXXXXXX
You entered 'INTERWORX_XXXXXXXXXX'.

4. Setup the main NodeWorx user. This will be the administrator account for the InterWorx Control Panel installation.

  +----------------------------------------------------------------------+
  |                     Default NodeWorx User Setup                      |
  +----------------------------------------------------------------------+

  e-mail address: admin@yourbox.com

  password: your-password
  confirm : your-password

5. Once the goiworx scripts ends, login to NodeWorx by going to https://<your ip>:2443/nodeworx/ using the e-mail address and password you setup in the previous step.

Scripted Activation Procedure

1. Login to your InterWorx Control Panel server via SSH and become the root user.
2. Run the goiworx.pex script with the following parameters

# Note: Make sure the below is all one line.  Replace LICENSE_KEY, EMAIL, and PASSWORD
~iworx/bin/goiworx.pex --key=LICENSE_KEY --email=EMAIL --password=PASSWORD --ignorechecks
You should NEVER rerun goiworx.pex on a server unless it's been completely reinstalled from scratch as this script not only installs the key but also initializes the database.

Troubleshooting

  • If you get any license activation errors be sure that your server time is correct.
  • If you are moving a license from one server to another you'll need to reset the IP of your license or open a support ticket and ask us to do it for you.
  • Make sure that license.interworx.com is resolvable and pingable from your server.
  • Verify that port 2443 is open both out and inbound to the server.