Automatically Starting the License Server on Bootup

In order for your computer to act as a Jim license server, you will normally want to automatically start the LicenseServer program on reboot. Please follow the instructions below for Linux, Mac OS, or Microsoft Windows computer systems.

Note: firewalls. The license server uses TCP/IP port 7969 (although the port number is configurable within the range 7500 to 7999). If you are running a firewall on your license server computer, this port will need be opened for TCP traffic.

On a Linux System

1. Log into your computer as root.
2. For maximum security, create a new user called "xinapse".
3. Click right on licenseserver and select "Save Link As ...". Save the file to a convenient location, such as your Desktop.
4. Copy this script into a folder containing the items that will be executed on system reboot.
   sudo cp licenseserver /etc/init.d
   Then, create a symbolic link to it:
   • If the directory /etc/rc.d/rc3.d
     exists, do: cd /etc/rc.d/rc3.d; sudo ln -s ../../init.d/licenseserver S90LicenseServer
   • If, instead, the directory /etc/rc3.d
     exists, do: cd /etc/rc3.d; sudo ln -s ../init.d/licenseserver S90LicenseServer

   N.B this startup script assumes that the license server program LicenseServer is installed in /usr/local/bin; edit the script /etc/init.d/licenseserver if it is not.

5. Make sure that new script is executable by root.
6. Start the script by hand to make sure that is correctly configured:

       cd /etc/init.d; ./licenseserver start
       

7. If all is well, reboot your system and check the LicenseServer daemon is running using the ps command:

       # ps -ef | grep LicenseServer
       root  5354     1  0 16:34:58 pts/2    0:00 /bin/csh /usr/local/bin/LicenseServer
       root  5357  5345  0 16:35:10 pts/2    0:00 grep LicenseServer
       

8. You're done. The LicenseServer will start up automatically every time your computer reboots. Note, however, that your computer can't act as a license server if it is turned off!

1. Click right on com.xinapse.licenseserver.plist and select "Download Linked File". Save the file to a convenient location, such as your Desktop.
2. Open a terminal window and go to the location where this file needs to be copied.

   cd /Library/LaunchDaemons
   

   Now copy the required file to this folder:

   sudo cp ~/Desktop/com.xinapse.licenseserver.plist .
   

   Note: there is a space and a period (".") at the end of the command above.
   Note: you will need Administrator rights to perform the above command. The sudo command above gives you administrator rights, but you will be prompted to enter your password.

   N.B the file com.xinapse.licenseserver.plist assumes that you installed the script LicenseServer in /usr/local/bin; edit the script com.xinapse.licenseserver.plist if you installed it elsewhere. You will also need to edit the LicenseServer script its self, since this also assumes that you put the scripts in /usr/local/bin.

3. Reboot your system and check the LicenseServer daemon is running using the ps command:

       # ps -ef | grep LicenseServer
       0    15     1   0   0:00.01 ??         0:00.01 /bin/csh /usr/local/bin/LicenseServer
       0    54    15   0   0:00.01 ??         0:00.01 /bin/csh /usr/local/bin/RunTool true com.xinapse.license.LicenseServer 
       0    79    54   0   0:00.79 ??         0:11.53 /System/Library/Frameworks/JavaVM.framework/Versions/17/Commands/java -Ddongle.debug=true -DOutputType=UNC -DTextMode=true -Dlicense.filename=/Applications/Xinapse/Jim9/license.txt -Dlicense.debug=false -Xms64m -Xmx1024m -classpath /Applications/Xinapse/Jim9/xinapse9.jar:/Applications/Xinapse/Jim9/cli.jar:/Applications/Xinapse/Jim9/itext.jar:/Applications/Xinapse/Jim9/j3d-vrml97.jar:/Applications/Xinapse/Jim9/templates.jar com.xinapse.license.LicenseServer
     501   213   184   0   0:00.00 ttys000    0:00.00 grep LicenseServer
       

4. You're done. The LicenseServer will start up automatically every time your computer reboots. Note, however, that your computer can't act as a license server if it is turned off!