ManualDoc:F8D6282279F464B1696B0EE3E23023B65
Contents |
Professional Subscription Activation
After acquiring your Professional Subscription (or requesting a free trial), you will receive an email containing an attached text file, which contains your own System Key that you will use to activate your instance.
You can activate more than one instance with a (non-trial) System key. Usually you will activate one (or more) instances for development, one instance for testing and one instance for production.
The standard procedure is the Online activation, which requires the ERP server to be connected to the Internet. It is however also possible to perform the activation offline.
![]() | Note that to fully activate with a free trial subscription, you must enable the system heartbeat. |
Online Activation
Follow this procedure to activate an instance that is connected to the Internet:
- Log in to Openbravo and switch the role to System Administrator
- Open the Instance Activation window in General Setup || Application || Instance Activation.
- Click on the Activate Online button.
- Select the purpose for your instance (production, testing and development) and copy/paste the System Key you received as an email attachment.
- Now you will be asked to clean your browser's cache. Once you have done this you will be able to see your Professional Subscription Instance's information in the Instance Activation window.
Offline Activation
Follow this procedure to activate an instance that is not connected to the Internet. Note that this option is not available for trials.
- Open the Key Server page with a web browser.
- Enter your instance's purpose (production, testing and development) as well as the received System Key. Then you will be able to download your activation file into your local file system.
- Log into Openbravo ERP and switch the role to System Administrator. Then go to the General Setup || Application || Instance Activation window and click on Activate with Activation File.
- In the pop up window select the file you have just downloaded and re-enter the System Key you received.
Instance refresh
If your license conditions change, you must refresh your instance's information to make these changes available to the ERP. Here are some examples of license condition changes that require an instance refresh:
- increase the number of concurrent users
- renew your annual subscription
- upgrade your annual subscription from Basic Edition to Professional Edition
- acquire a commercial module and want to install it
- expiration of a "partner golden key" (refresh is required every 30 days)
To refresh you instance:
- Log into Openbravo
- Switch the role to System Administrator (if that is not the default role for your user)
- Access the General Setup || Application || Instance Activation window
- Click the Refresh Online button. You will see your System Key, and there is typically no need to change it.
- Click the Renew Instance button
In the same way as for activation, it is possible to refresh the license online or offline. If your instance is not connected to the Internet, download the new Activation File from Key Server in the same way it is explained in the previous subsection of this document. Once you have the new Activation File in your local file system:
- Log into Openbravo
- Switch the role to System Administrator
- Access the General Setup || Application || Instance Activation window
- Click the Refresh with Activation File button, where you will be asked to upload the activation file and type the System Key
Deactivation
You can deactivate a Professional Subscription instance at any point and transform it into a Community Edition Instance:
- Log into Openbravo and switch the role to System Administrator.
- Go to General Setup || Application || Instance Activation and click on Deactivate.
License Expiration
When the subscription for the instance or for one of the commercial modules installed expires, only users with a System Administrator role are allowed to log into the application. Such users will be able to refresh the instance license so that the updated expiration date for the renewed subscription is recognized, and normal access to all users is restored.
If a commercial module's license has expired and you do NOT want to renew your subscription to it, then the System Administrator may either disable or uninstall this module to restore access to all users.
License for Retail
More information about specifics for Retail can be found here.
Instance Purpose
First time that you login as System Administrator, it invites you to set the instance purpose, the available values are: Production, Testing, Evaluation and Development.
The purpose is shown on the home page so, in case of using different instances, it will help you to easily differentiate which one is in Production status and which are Development or Testing instances. The purpose is also mandatory to activate Professional/Basic Edition instances, the value of the drop down menu is defaulted from the selected option. If you enable heartbeat this information is also sent.
![]() | Production instances cannot have modules in "In development" status. Once the instance purpose is set to production, all modules will be marked as not "In development". |