Activating Assets Server

Using Assets Server and any of the clients that connect to it requires a license. This article describes how to activate these licenses.

Step 1. Install and start the server.

Step 2. Open the following page in your browser:

http://<yourserver>:<port number>/console

Example: localhost:8080/console

Note: You can log in using the default admin user with password changemenow, make sure to change the password in the internal user properties.

The License page opens.

Step 3. Enter your serial number, name and e-mail address and click OK.

An overview appears of the products that you can activate.

Step 4. Select a Server product.

Step 5. Specify the number of licenses to activate for each product.

Important: In case you have a Backup license available, do not activate it; these should only be used for activating a temporary system. A Backup license is only active for 30 days and once deactivated cannot be activated again. For more information, see Using a Backup license in Assets Server.

Step 6. Click Apply Changes.

A message appears asking to confirm the changes.

Step 7. Click Yes.

If all goes well your activation code is successfully activated.

The License page reloads and all options in the menu on the left are now available.

About Fallback

When a server is not licensed, it will start up in fallback mode. In this mode, only the admin page and License page are available and only super users configured in internal-users.properties.txt will be able to log in to the admin pages. All other functionality of the server is not available while in fallback mode.

Note: The server can also start up in fallback mode when it fails to properly start for other reasons. When this happens it will be indicated on the admin landing page and error details will be available in the server logs.

Known issues

On Linux after activating the license, the server does not always restart automatically. You may have to restart it manually (keep an eye on the server logs).

License renewals

Assets Server will try to contact the activation server each month to renew the license(s). This requires an Internet connection (through port 80).

Resetting an activated license

In some scenarios, it may not be possible to (re-)activate a license, for example after a trial license has expired or after restoring a backup.

When this is the case, the activated license can be reset.

Important: Only perform this action after consulting WoodWing Support. Resetting the license will remove all license details without first deactivating the license.

Step 1. Log in with Postman with a Post request such as http://localhost:8080/services/login?username=woodwing&password=ww and copy the retrieved csrfToken.

Step 2. Create a new Post request such as http://localhost:8080/controller/admin/activation/resetActivation . In the Headers section, add X-CSRF-TOKEN and paste the csrfToken you copied earlier.

Step 3. Log out of Assets Server and log in again. It should now request a new serial number.