Last updated on May 12, 2015

License Activation (Traditional)

Introduction

Important

This article is only applicable to traditional Cloud subscribers (i.e. Pro, Pro+, or Enterprise) that are deploying an on-premise instance of Appspace server. If you are an Omni plan subscriber (i.e. Omni-D, Omni-E, Omni-F, or Omni-G) – please refer to the License Activation (Omni Subscribers) article.

This article will guide you through the two different methods available for activating your on-premise Appspace server instance. Once you have successfully logged into your Appspace server for the first time, you will be automatically presented with the License Activation page. At this point, you may proceed with one of the following two methods of activation:

  • Automated Activation – an activation method for installations with direct, Internet-connected servers
  • Manual Activation – an activation method that can be performed without an Internet connection, but requires multiple manual steps and a separate workstation that does have Internet-connectivity

Note

You will need to have your unique 16-character Appspace product key ready prior to the activation process. If you have not obtained the license key, please contact your local Appspace sales team or reseller to obtain the code.

Prerequisites

  • Your Cloud user account must be upgraded to one of the traditional Cloud subscription plans (Pro, Pro+, or Enterprise)
  • You must have Portal Administrator privileges on your Appspace server

Note

You can check your currently Cloud subscription by logging into your Cloud account and going to the Subscription tab (extensions drop-down, System > Account > Subscription) as seen in the image below. If you need to have your account upgraded to the proper Omni subscription level, please contact your local Appspace sales or support teams.

Automated Activation

The Automated Activation method is the preferred/recommended method to activate and license your on-premise Appspace server instance. It requires an active Internet connection from your server to authenticate with Appspace Cloud services to fully complete this process successfully.

Step 1

Once your on-premise Appspace server instance has been successfully installed and accessed for the first time, the system will detect that the server needs to be activated. At the License Activation screen, enter your Cloud account credentials in the username (typically an e-mail) and password fields. Click Next to continue.

Note

Make sure you are using a Cloud account that has already been upgraded to one of the traditional subscription plans (Pro, Pro+, or Enterprise).

Step 2

Enter your 16-character product license key, and select the ‘Add Product Key’ link. The server may pause for a few seconds to add the product key. Once you see the new key listed under New Product Keys on the screen, click the Submit button to activate your server instance.

Step 3

If successful, you should be prompted with a confirmation message. Click the ‘Proceed to Login Page’ link to sign into your Appspace server. You may now proceed to follow the steps in the Accessing Appspace (On-Premise) article.

Manual Activation

The Manual Activation method is the alternate method to activate and license your on-premise Appspace server instance. It is typically utilized for servers that are isolated behind strict security policies (i.e. firewalls or proxy) that restrict Internet traffic. You will need to have a separate workstation with Internet connectivity to complete this process.

Step 1

Once your on-premise Appspace server instance has been successfully installed and accessed for the first time, the system will detect that the server needs to be activated. At the License Activation screen, click the ‘Proceed to Manual Activation’ link to continue.

Step 2

On the Manual License Activation screen, retrieving your Server Profile by clicking the Download File button under Step 1. Save the file (ServerProfile.xml) to a suitable location on your local machine.

Step 3

Log into your Appspace Cloud account (https://cloud.appspace.com) and access the System > Account from the extension drop-down menu in the upper-left corner.

Step 4

Proceed to the Licenses tab and click on the ‘Assign license key’ link.

Note

If you do not see the Licenses tab, it is because your Cloud user account has not yet been upgraded to the needed subscription level to manage license keys. Please contact your local Appspace sales team or support team for assistance.

Step 5

On the Assign License Key window, input the 16-character server license key. If done correctly with a valid key, you should be prompted with a green (success) check. Click Next to continue.

Step 6

At this point you should see the details of your license key (features that will be activated) listed in the Assign License Key window. Click on the folder icon to browse/select the previously saved Server Profile (ServerProfile.xml) from the appropriate location on your local machine. Click Assign to continue.

Step 7

The last progression of this workflow will allow you to input the Instance Name, IP/Host Value, and Location. This information will be used strictly to identify the Appspace server instance as seen in the Cloud dashboard and will not affect any on-premise server behavior. When finished, click Assign to complete the process.


If successful, you should see a green confirmation message. You may now return to the Licenses tab.

Step 8

Your newly added server instance should now be listed on the Licenses page. Click on the Download license file link that is next to the server instance to be activated. This will download the Product Activation File (usually named <Product Key Number>.bin). Save this file to an easily accessible location on your local machine.

Step 9

Back on the Manual License Activation page of your on-premise Appspace server instance, proceed to Step 2. Click the Choose File button to browse/select the previously saved Product Activation File (<Product Key Number>.bin) from your local machine. Once selected, click the Submit button to continue.

Step 10

If successful, you should be prompted with a confirmation message. You may continue to sign into your server by clicking on the ‘Proceed to Login Page’ link. You may now proceed to follow the steps in the Accessing Appspace (On-Premise) article.