Quick howto for installing, running and enrolling DSLS licences on Linux based systems.

Please make sure that the ksh shell is installed before proceeding! You can install it on RedHat based systems by running yum install ksh. Also make sure that no other programs are running on ports 4084 and 4085!

In this howto we assume you downloaded the latest DSLS archive and you extracted it in /opt/dsls.

1. Run ./startInstLicServ -noUI A typical continuation of the script would be as follows:

/opt/dsls
Check free port
Chosen port 4084

CheckAcessDir :/usr/DassaultSystemes/DSLicenseServer
CheckAcessDir :/usr/DassaultSystemes
CheckAcessDir :/usr
CheckRequiredSize :/usr
Available size : 1146
Installing server in /usr/DassaultSystemes/DSLicenseServer
Creating directory /usr/DassaultSystemes/DSLicenseServer
mkdir -p -m 755 /usr/DassaultSystemes/DSLicenseServer
Directory /usr/DassaultSystemes/DSLicenseServer was successfully created
Installation directory: /usr/DassaultSystemes/DSLicenseServer

TarCmd: tar -xf /opt/dsls_R2014/DSLS.tar
Untar DSLS.tar was successful
Server initialization: /usr/DassaultSystemes/DSLicenseServer/linux_a64/code/bin/DSLicSrv -initServer -adminPort 4084
2014/02/25 16:47:47:925 I INITSERVER Server version 6.215.4 built on Aug 27, 2013 4:44:57 PM
2014/02/25 16:47:47:929 I INITSERVER Initializing license server on /var args [-adminPort, 4084]
2014/02/25 16:47:49:021 I REPOSITORY LicenseDB.dat written to disk
2014/02/25 16:47:49:037 I INITSERVER Server successfully initialized.
2014/02/25 16:47:49:038 I INITSERVER Computer name ls01, computerId WBX-528D142590CA18EC
Server was successfully initialized

Server start: nohup /usr/DassaultSystemes/DSLicenseServer/linux_a64/code/bin/DSLicSrv -startServer >/dev/null 2>&1 &
Server was successfully started

Cannot create symbolic link /usr/lib/lsb/install_initd /etc/init.d/dsls:rc = 1
Launch /usr/DassaultSystemes/DSLicenseServer/linux_a64/code/bin/DSLicSrv -admin to start License Administration Tool in command line mode

2.  Start the configuration by running: /usr/DassaultSystemes/DSLicenseServer/linux_a64/code/bin/DSLicSrv -admin The command will drop you in the Admin shell of the DSLS software, which shows “admin >”.

License Administration Tool Version 6.216.0 Built on Oct 29, 2013 4:21:54 PM.
admin >

3. Now you must connect to the DSLS service (here we assume the IP of the server is 192.168.100.1, please use your real IP):

admin >connect 192.168.100.1 4084
Software version: 6.216.0
Build date: Oct 29, 2013 4:21:54 PM
Standalone mode
Ready: yes
Server name: dsls.local Server id: NVL-123456789456

4. Next you must set the licensing port:

admin >setConfig -lp 4085
New server configuration
Standalone mode
Licensing port: 4085 Administration port: 4084
Password protected: no Remote administration: none
License usage statistics enabled: no Automatic recycling enabled: no Offline extraction enabled: yes
Confirm (yes|no)? >

5. After you confirmed by typing yes you can check the status of your configuration:

admin >getConfig
Server configuration
Standalone mode
Computer name: dsls.local Computer ID:NVL-123456789456
Licensing port: 4085 Administration port: 4084
Password protected: no Remote administration: none
Automatic recycling enabled: no License usage statistics enabled: no
Enable offline license extraction: yes

6.  Now it’s time to enroll your licences. Here we assume the license files are located in /tmp, please make sure to use the correct path in your case:

admin >enrollLicense -dir /tmp -file MTK-5240101F742CF784_788YY-GMQL2-P0QAS-6MKER-JM0HS_0005_1.LICZ

7 license files enrolled
File /tmp/MTK-5240101F742CF784_788YY-GMQL2-P0QAS-6MKER-JM0HS_0005_1.LICZ/FEAT-1-of-7.LIC enrolled
File /tmp/MTK-5240101F742CF784_788YY-GMQL2-P0QAS-6MKER-JM0HS_0005_1.LICZ/FEAT-2-of-7.LIC enrolled
File /tmp/MTK-5240101F742CF784_788YY-GMQL2-P0QAS-6MKER-JM0HS_0005_1.LICZ/FEAT-3-of-7.LIC enrolled
File /tmp/MTK-5240101F742CF784_788YY-GMQL2-P0QAS-6MKER-JM0HS_0005_1.LICZ/FEAT-4-of-7.LIC enrolled
File /tmp/MTK-5240101F742CF784_788YY-GMQL2-P0QAS-6MKER-JM0HS_0005_1.LICZ/FEAT-5-of-7.LIC enrolled
File /tmp/MTK-5240101F742CF784_788YY-GMQL2-P0QAS-6MKER-JM0HS_0005_1.LICZ/FEAT-6-of-7.LIC enrolled
File /tmp/MTK-5240101F742CF784_788YY-GMQL2-P0QAS-6MKER-JM0HS_0005_1.LICZ/FEAT-7-of-7.LIC enrolled

admin >

If you have more than one license file repeat this step for each one.

7.  Next you may check the status of your licenses by issuing the command getLicenseInfo

8. You can check how many licenses are in use and by whom by issuing the command getLicenseUsage

Please follow your Operating Systems procedure to make DSLS start at system boot and also make sure that the firewall is not blocking ports 4084 and 4085!

NB. Although Dassault Systemes recommends (and officialy supports) only Red Hat Linux or SuSE Linux as supported Linux platforms for the DSLS service, in our experience any Red Hat derivative will do just fine (eg CentOS). Also, if you are very attached to one particular Linux distro you stand a good chance to be able to run DSLS on it, since it is more or less a question of extracting the DSLS.tar archive to a location of your choice and making the start/stop/restart script, just make sure you have ksh installed. We successfully installed DSLS on Debian/Ubuntu (so probably most distros based on them are safe) and even Arch Linux. Remember however that these are not officially supported distros so if any error occurs you will have to solve it yourselves (but you can pop a question to us and we will try and help nonetheless).

Using FreeBSD? Good choice. Install ksh93, symlink it to ksh, install FreeBSD Linux Binary Compatibility (https://www.freebsd.org/doc/handbook/linuxemu-lbc-install.html), unpack DSLS.tar, initialize the server (./DSLicSrv -initServer -adminPort 4084), start the server (./DSLicSrv -startServer) connect to it and carry on with the rest of the steps to set admin port, import licenses etc, it might just work.