Starting with VE license server version 1.1.13, the previous information-only web interface has been changed to a management interface. It provides the following functions:

• Displaying license information
• Displaying client information
• Creating C2V (fingerprint) files
• Updating a license using a V2C file provided by Stromasys
• Managing web GUI users

The following section describe this in detail:

Accessing the Management GUI and Logging in

The web-based management GUI is provided by the license server on TCP port 8084 by default (the port can be changed in /opt/license-server/config.ini; see also Additional Configuration Options - the config.ini File).

Use the following URL in any web browser to access the management GUI:
https://<host>:<port>/
where host is the name or address of the VE license server and port is the TCP port (8084 by default). Use localhost as the hostname for accessing the GUI of a license server running on the local system. Example: https://localhost:8084.

Please note: any intermediate firewall must allow the TCP port used for the management GUI.

Upon connecting to the URL, a login screen will be displayed.

Default credentials:

• Username: charon
• Password: stromasys

After logging in, you will be presented with a list of menu options on the left pane of the screen and the content of the selected option on the right hand. Please change the default password immediately.

Certificate Warning when Connecting to the Management GUI

When connecting to the VE license server web-based management GUI for the first time, the web browser will issue a NET::ERR_CERT_AUTHORITY_INVALID warning and inform the user that the connection is not private. This is due to the fact that the SSL certificate included with the license server kit includes a dummy hostname that does not match the real hostname of the license server system.

It is possible to override the warning and connect to the page. Otherwise, users must

• either obtain a certificate for the host from one of the commercial certification authorities, or
• they must create their own self-signed certificate and add it to the web browser.

The new certificates replace the certificates in /opt/license-server/certs (move the old certificates to a save place).

Steps to create a self-signed certificate:

• Log in as the root user.
• Go to /opt/license-server/certs.
• Move the existing content of the directory to a backup directory.
• Create a root certificate (each command must be entered on one command-line - irrespective of necessary line breaks in this document):
  

  # openssl genrsa -out ca.key.pem 2048
# openssl req -new -key ca.key.pem -out ca.csr -subj "/C=CN/ST=GD/O=STROMASYS/OU=LICENSE/CN=STROMASYS.COM"
# openssl x509 -req -days 7300 -sha256 -extensions v3_ca -signkey ca.key.pem -in ca.csr -out ca.cer
  
  

• Create a server certificate (each command must be entered on one command-line - irrespective of necessary line breaks in this document):
  

  # openssl genrsa -out servercert.key.pem 2048
# openssl req -new -key servercert.key.pem -out servercert.csr -subj "/C=CN/ST=GD/O=STROMASYS/OU=LICENSE/CN=hostname.domain"
# openssl x509 -req -extfile <(printf "subjectAltName=DNS:hostname.domain,DNS:hostname.domain")
   -days 7300 -sha256 -CA ca.cer -CAkey ca.key.pem -CAserial ca.srl -CAcreateserial -in servercert.csr -out servercert.cer
  
  

• Replace hostname.domain with the real name of the VE license server system.

• Import the root CA (ca.cer) into your browser’s Trusted Root Certification Authorities Certificate Store.

Displaying the License Information

The first screen after login is the license information screen similar to the one shown below:

It can be selected via the menu on the left (License Information).

Displaying the Client List

The client list can be displayed by selecting the Client List option on the left pane. A sample with one connected client is displayed below:

Updating a License

The license management section can be opened by selecting Update License on the left pane. This will open the license management screen as shown below:

The license management section includes two options:

• Exporting a C2V file (the fingerprint of the license server system)
• Importing a V2C file (the license file created by Stromasys after receiving the C2V file)

The result panes show the result of the operation including any errors that may have occurred.

Exporting a C2V File

As an alternative to the command-line program for C2V export, you can create your C2V file via the management GUI. The section for C2V export has two input fields described below:

Steps to export a C2V file:

1. Enter the correct License Type.
2. Select the correct Platform.
   1. If the chosen platform is VMware ESXi, there will be an additional menu indicated by three dots. Click on this option to open the esxi_bind configuration window.
      
      
      Enter the IP address and the login information of the ESXi host or vCenter Server to which the license server should bind. Then press Submit.
3. Click on Export to create the C2V file.
4. After a successful export, a download option will be displayed that allows you to download the created file to your local system.

Send the C2V file to Stromasys for them to create a license.

Importing a V2C File

In response to the C2V file sent, you will receive two files from Stromasys. One text file containing the license content in human-readable form, and the V2C license file.

You can import the V2C license file using the v2c command-line utility, or you can use the web GUI. In the section Import V2C File perform the following steps:

1. Click on Browse to open a file browser.
2. Select the V2C file to be imported as shown below.
   
3. Click on Import to import the new/updated license. You will receive a message about the license import being complete. The license server will restart and you have to re-login to the GUI.
4. Check the new license via the License Information tab.

Managing Web-GUI Users

The access to the web GUI requires a username and a password. The Users section enable the management of such users. They are separate from the Linux system users.

Default credentials:

• Username: charon
• Password: stromasys

Each user can have one of two roles: Admin or Guest. The role cannot be changed after a user has been created.

Admin users have access to all options. Guest users can only display information and change their password.

The following image shows the initial user overview:

Available options on the Users screen:

• Add User: add a new web GUI user
• Modify: change the password of a user
• Remove: available for additionally created users. Not available for the default user.

Clicking on Add User opens a pop-up-window similar to the following:

You can set the following parameters:

• Username
• Password
• Role (to change the role of a user later, the user must be deleted and recreated)

Click on Submit to create the user.

The following shows a list with two additional users for which the Remove option is also available.

Clicking on Modify will open a window similar to the Add User window - with the difference that only the password change option is enabled.

Resetting a lost Admin Password

If the password of the admin user charon is lost it can be reset via the command-line.

As the root user, use the following command:

# /opt/license-server/license_server -p

You will be prompted for the new password twice.