This page explains the procedure for upgrading an existing license server (RLM) for customers who are already using the Astah Floating License.
If you are installing the Astah Floating License for the first time or planning to replace the server machine, please refer to the setup guide.
Files you need to upgrade RLM
The following files are needed to upgrade the license server:
- Reprise License Manager (Windows: rlm.exe | Linux: rlm)
- ISV server (Windows: cvastah.exe | Linux: cvastah)
- The following files from your existing license manager:
- ISV server option file (cvastah.opt)
- ISV configuration file (cvastah.set)
- License key file (file with the .lic extension)
1. Download
Click the target OS below to download the necessary programs for the license server.
RLM Version: 16.0
If You Are Using a Reprise License Manager Not Provided by Us:
Please place the following files in the same folder as your existing license manager:
- ISV server (cvastah.exe or cvastah)
- ISV server configuration file (cvastah.set)
- ISV option file (cvastah.opt) – Please adjust the output folder specified in the file as necessary.
Important Notes:
- Astah is confirmed to work with RLM versions 12.3 and 16.0 provided by us. If your RLM version is older than these, please upgrade to version 16.0 or later.
- Use a common port when retrieving licenses.
- If the ISV you are using with other programs is not compatible with RLM v16.0, it will not function correctly. The RLM provided by Astah is created using an SDK called _w4, so the ISV must also be created with either the _w3 or _w4 SDK.
2. Setup
The setup procedure varies between Windows and Linux.
Setup on Windows:
This section explains the procedure assuming the installation directory of the license manager to be upgraded is C:\Astah\Reprise.
- Log in to the Windows system where the upgrade will be performed as a user with Administrator privileges.
- Stop the RLM service.
- Copy C:\Astah\Reprise to C:\Astah\Reprise-backup (or a similar name) as a backup.
- Extract the downloaded compressed file to a desired location, and move the rlm.exe and cvastah.exe files from the extracted folder to C:\Astah\Reprise.
- Start the service.
Setup on Linux:
The following setup instructions are based on Ubuntu 24.04 LTS, assuming the license manager is installed in the /opt/rlm/ directory. The setup may vary slightly depending on your Linux distribution, so please adjust accordingly.
1. Log in to the server where the upgrade will be performed as a user with root privileges.
2. Stop the RLM service:
3. Copy /opt/rlm to /opt/rlm-backup as a backup:
cp -R /opt/rlm /opt/rlm-backup
4. Extract the downloaded compressed file to a desired location, and move the rlm, rlmutil, and cvastah files from the extracted folder to /opt/rlm:
unzip /tmp/astah_license_server_linux_x86-64_{license_server_version}.zip
cd /tmp/astah_license_server_linux_x86-64_{license_server_version}/rlm
cp rlm rlmutil cvastah /opt/rlm
5. Start the service:
Registering an Administrator
1. Access RLM web server
- Start your web browser and access your web server by typing https://<Hostname>:5054.
– Since RLM v16.0, HTTPS is enabled by default, and a self-signed certificate is generated upon first access.
– Due to the self-signed nature of the automatically generated certificate, your browser will likely display a “Not secure” warning before you can get to the web server. Traffic to the web server will still be encrypted.
– As long as you do not restart your machine or web browser, the “Not secure” alert should no longer appear on your second access or later.
– See SSL Certificate Setting to use your own SSL certificate.
- This is what the new RLM web server looks like.
- Logins are now required for access to the web interface. Login with the default information as below:
– Username: admin
– Password: admin
- On first login you will be prompted to set a new password. Please follow the on-screen instructions to set a password.
- Once the password is set, you will see the home page of the RLM web server like this:
SSL Certification
For SSL settings, please refer to the “SSL Settings”.
The upgrade process is now complete. Please start the Astah client and confirm that it successfully connects to the floating server and that the license is active.