Lizenzserver expecco ALM/en
Inhaltsverzeichnis
Overview[Bearbeiten]
The expecco license server is used for the central administration of expecco licenses. The license server allows expecco to be installed and executed on various computers (both development and pure test execution computers) without a dongle and local license file on all accessible computers in the network.
Licenses are requested by the expecco computers from the license server, reserved in the license server, and returned after the session or test run. This means that more users can work with expecco (but not simultaneously) than the number of licenses purchased.
Licenses are cryptographically secured files that can only be read or used in conjunction with a license server dongle supplied by eXept. Licenses are dongle-specific. It is therefore not necessary to take measures to protect against theft or copying of license files. However, loss of the dongle should be avoided for obvious reasons.
Requirements[Bearbeiten]
We recommend installing expecco ALM on a continuously available server with Windows Server 2012 / Windows 10 or higher. Installation on other operating systems (e.g. Linux) would also be possible if required. It is also possible to install the program in a cloud, where it can be operated without a dongle.
To ensure that expecco ALM can run smoothly, the following hardware requirements apply to the server:
- a “dedicated” processor with at least 2 GHz
- at least 1 GB of RAM (exclusively for expecco ALM)
- at least 10 GB hard disk space (depending on the size of the data that expecco ALM is to manage)
Make sure that this server is accessible to all clients. Clients are all computers of expecco ALM users, computers that are used to run expecco ALM tests and computers with “floating” licensed expecco. If you have any problems with accessibility, please contact your network administrator.
Installation[Bearbeiten]
Please have your license file and dongle ready for the installation of expecco ALM.
Alternatetivly, for the installation in the cloud without dongle, we provide a license file node-locked to a MAC address.
We have sent you your license file and a link to the current expecco ALM setup by e-mail.
Windows[Bearbeiten]
The installer has the following name: “expecco ALM 25.1.0.1 Setup.exe”, although the version number may differ. We have sent you your dongle by mail (unless you are evaluating expecco ALM or using the cloud version with the Mac address binding).
Please proceed as follows:
- Download the expecco ALM installer to the server on which expecco ALM is to run in the future
- Place your license file on the server as well
- Connect your dongle to the server (if you are evaluating expecco ALM or using the cloud version with the Mac address binding, skip this step)
- Run the expecco ALM installer (“expecco ALM?..?..?.. Setup.exe”)
Once the installer has been successfully executed, expecco ALM is already running as a service. A shortcut to expecco ALM has been created on your desktop. A folder for expecco ALM has also been created in your start menu. There you can change the port under “Configuration” (the default is port 8081) or use the “Logfile” to identify any problems.
You can open expecco ALM with your default browser via the shortcut on your desktop. A page for installing your expecco ALM license will be displayed (Appendix 1). You can select your license file (which you have already stored on the server) via “Install license file”. After expecco ALM has accepted your license file, you can remove it. If a valid license is already installed, the login page will be displayed instead. If this is your first installation, you can log in with the username “admin” and password “admin”.
If you get a blank page or an error page, try a different port and/or check the log file for error messages.
Linux[Bearbeiten]
For Redhat resp. Oracle Linux you need the linux packages: libXinerama libXft libXrandr unixODBC libusb libusbx bzip2 ncurses gettext isomd5sum Install them with
dnf install libXinerama libXft libXrandr unixODBC libusb libusbx bzip2 ncurses gettext isomd5sum
For Ubuntu resp. Debian Install the required packages:
apt-get update
apt-get install libxinerama1 libxft2 libxrandr2 unixodbc odbcinst libusb-1.0.0 libusb-0.1-4 coreutils \
bzip2 libglib2.0-0 software-properties-common
The installer has the following name: “expeccoALM-25.1.0.2989.package”, although the version number may differ. We have sent you your dongle by mail (unless you are evaluating expecco ALM or using the cloud version with the Mac address binding).
Please proceed as follows:
- Download the expecco ALM installer to the server on which expecco ALM is to run in the future
- Dowload the autopackage software from https://download.exept.de/download/autopackage.tar.bz2 to the same directory
- Place your license file on the server resp. the client running the browser.
- Connect your dongle to the server (if you are evaluating expecco ALM or using the cloud version with the Mac address binding, skip this step)
- Run the expecco ALM installer:
bash ./expeccoALM-25.1.0.2989.package
- Choose a unused TCP port number. You use this port number to connect to the expeccoALM web page and fetch your expecco licenses. The default port number is 8659.
- For automatic start with systemd use /opt/expecco_ALM/expeccoALM.service as a template. Change the USER parameter to the linux user the service should run under. Change the port option parameter to the port number.
- Enable the expecco ALM service with:
systemctl enable ./expeccoALM.service
- expecco ALM will be started automatically when the server is booted. When you don't want to reboot the server now, start the expecco ALM service with:
systemctl start expeccoALM
- Alternatevely, when you don't want to use autoa-start with systemd you can start expecco ALM manually:
/opt/expecco_ALM/bin/expecco_ALM -p <port number>
You can open expecco ALM with your default browser by connecting to http://<server>:<port>. A page for installing your expecco ALM license will be displayed (Appendix 1). You can select your license file (which you have already stored on the server) via “Install license file”. After expecco ALM has accepted your license file, you can remove it. If a valid license is already installed, the login page will be displayed instead. If this is your first installation, you can log in with the username “admin” and password “admin”.
If you get a blank page or an error page, try a different port and/or check the log file for error messages.
SSL encryption / proxy server[Bearbeiten]
expecco ALM does not yet support SSL encryption directly. However, this can be easily set up via a proxy server, e.g. via an Apache server. If your server is hosting other websites, this is necessary anyway, as multiple processes cannot bind to port 443 at the same time.
An Apache2 VirtualHost configuration would look like this (assuming expecco ALM is running on port 8465 - the necessary changes for your configuration are in bold):
<VirtualHost *:443>
ServerName expeccoalm.xyz.de
ServerAdmin webmaster@xyz.de
Include /etc/letsencrypt/ssl-xyz.de.conf
SSLProxyEngine On
RewriteEngine on
RewriteCond %{HTTP:Upgrade} =websocket [NC]
RewriteRule /(.*) ws://localhost:8465/$1 [P,L]
RewriteCond %{HTTP:Upgrade} !=websocket [NC]
ProxyPass / http://localhost:8465/ nocanon
ProxyPassReverse / http://localhost:8465/
</VirtualHost>
In this configuration example, the SSL parameters with the paths to your certificates and keys would be located in the Apache global file /etc/letsencrypt/ssl-xyz.de.conf.
Notes on licensing[Bearbeiten]
If you have purchased expecco ALM, you will receive a dongle and a license file. If you are evaluating expecco ALM, you will only receive the license file. The license file contains an individual expecco ALM license for you. For example, the name of your company, the modules activated for you or the validity period are stored in the license. The dongle (if you have purchased expecco ALM) must be permanently connected to the server on which expecco ALM is running. If you disconnect the dongle during operation, expecco ALM will stop working.
Change license[Bearbeiten]
If you have a current expecco ALM version, you can import a new license file “expecco ALM license *.lic” via the expecco ALM web interface. Please refer to the attached screenshot (Appendix 2).
If you have an older version of expecco ALM, you must proceed as follows:
- Since you will have to restart expecco ALM later, take the appropriate precautions (e.g. log off users, back up the database, etc.)
- Log on to the computer running expecco ALM
- Go to the following directory “C:\Windows\SysWOW64\config\systemprofile\AppData\Roaming\expecco_ALM” or, if you are using a 32-bit operating system, “C:\Windows\system32\config\systemprofile\AppData\Roaming\expecco_ALM” and delete the file “expecco_ALM.lic”
- Restart the expecco ALM service via the Windows Service Manager or end the “expecco_ALM.exe” process via the Windows Task Manager. In the latter case, the Windows Service Manager will automatically restart expecco ALM.
- Now you can access the expecco ALM web interface. A page for installing your expecco ALM license will be displayed (Appendix 1). You can select your license file via “Install license file”. After expecco ALM has accepted your license file, you can remove it.
Importing expecco floating licenses[Bearbeiten]
The license service of expecco ALM allocates available expecco floating licenses from a certain pool.
Expecco floating licenses purchased from eXept can be added to this initially empty pool.
You will receive these expecco floating licenses as license file(s) usually by e-mail.
A license file can contain one or more expecco floating licenses, even for different components (basic system, plug-ins and extensions).
You can also purchase additional expecco floating licenses at any time and add them to the pool.
expecco floating licenses are always created specifically for an expecco ALM license and can only be used with this license and its dongle.
It is therefore not necessary to keep such license files under lock and key or to exchange them via a secure connection.
However, you should keep the dongle in a safe place and prevent theft.
To install an expecco floating license, open expecco ALM and log in.
Now navigate to the “License Service” module using the top main navigation bar.
You are now in the license service and the list of installed expecco floating licenses is displayed.
Switch to the “expecco license files” tab.
Use the navigation menu on the left to navigate to “Upload”.
Here you can now upload your expecco floating licenses to the pool by simply uploading them.
The expecco floating licenses you have just uploaded will now be displayed in the list mentioned above.
From now on, these can also be accessed by remote expecco clients.
You can also purchase additional expecco floating licenses and add them to the pool at any time.
License Overview[Bearbeiten]
To find out which individual expecco floating licenses are available or assigned,
by switching to the “expecco licenses” tab.
In particular, it is possible to see which computer/user is currently using which expecco floating license.
This is useful, for example, if an expecco client has accidentally not ended its session,
and other users need a corresponding license.
