User Manual
Contents
1. C il bio CLC License Server Administrator Manual User manual for CLC License Server 3 6 1 Windows Mac OS X and Linux April 23 2012 This software is for research purposes only CLC bio Finlandsgade 10 12 DK 8200 Aarhus N Denmark ll big Contents 1 Introduction 5 LE OVGNIOW cessrsadecis baw eee ee eo E O a 5 1 2 Server requirements 1 a a a rara 6 1 3 Network requirements 2 2 2 2 7 EO ile vetoes 2 2 7 License server installation 8 226 Windows WSO ck eae eee eee RR DE KR KR eR Be A 2 1 1 Uninstalling the Windows Service 0 205085 2 ee 8 2 1 2 Downloading license files for Windows 0 022 506 10 2 1 3 Checking that the server is ready 2 2 2 2 2 2 a a ee 10 222 NINO 2 2 s 2 iba DEAD AA ARA E E 11 2 2 1 Downloading license files for Mac OS 002 11 2 2 2 Checking that the server set up is complete 25 12 ee LI Mie RON 2 eee te eee hee ee ee eh eee ee ee ee bd as 12 eck Haste 2 2 bette ene Bee heat eR hee ee eee ee he ee 12 daa Nita Tie 11166 e ca ae ee bee ew bse EDER DESSE 12 2 3 3 Install the startup script 2 22. a specific feature for the spec O iea ost rames o ro Orne SPee ALLOW_USER_ALL One or more users Allow access to all features for the specified eee omens lee ALLOW_USER_ lt feature gt One or more uses Allow access to a specific feature for the DENY USER ALL One or more users Deny access to all features for the specified Deny access to a specific feature for the spec ified users All arguments must be specified as a space separated list IP addresses must be specified as specific addresses with the form A B C D or with wildcards A B Example 1 ALLOW IPADDR ALL 192 168 1 192 168 2 ALLOW_USER_ALL alice bob DENY PADDR ALL 4 Fera This configuration in this example will e Allow access to clients on 2 subnets perhaps a specific lab or class room e Allow access to the two users alice and bob from any host e Deny access for everyone else The restrictions will apply to all features available on the license server Example 2 DENY HOST MAIN labli officel ALLOW_IPADDR MAIN 192 168 x x DENY _IPADDR_MAIN x x x This configuration will deny the machines with hostname lab1 and office1 allow clients on the internal network and deny everyone else This applies to the feature called MAIN which corresponds to the CLC Main Workbench 3 2 3 Borrow restrictions A set of rules for restricting access to borrowing licenses are also available The available rules are almost iden
3. in the licenses folder This means that all license files should be located in this folder License files are downloaded using the 1icensedownload script To run the script right click on the file and choose Run as administrator This will present a window as shown in figure A 1 ey C Windows System32 cmd exe rt lion duo d deities HH CLC license download utilit HH ERES SSD DE AEDE ELBE BEMA OEBE PEAR DEEE ORAR PERA RARAS Hostname Host I Des3 Please enter Cor copy paste your license Order ID and press return gt Figure A 1 Download a license based on the Order ID Paste the Order ID supplied by CLC bio right click to Paste and press Enter Please contact support clcbio com if you have not received an Order ID Next you need to restart the server by running the restartservice script To do this right click on the file and choose Run as administrator You can also restart the server through the Services control panel shown in figure 2 3 Note that if you are upgrading an existing license file this needs to be deleted from the licenses folder When you run the licensedownload script it will create a new license file A 2 Downloading license files for Mac OS The license server will look for licenses in the licenses folder This means that all license files should be located in this folder License files are downloaded using the downloadlicense command script To run the script double click on the
4. look similar to this 2011 01 19 10 54 52 2011 01 19 10 54 52 2011 01 19 10 54 52 2011 01 19 10 54 52 2011 01 19 10 54 52 2011 01 19 10 54 52 Configuration file path C Program Files clclicsrv licenseserver cfg Serving following features CLCGENOMICSWB v4 99 2 license s license type exclusive Minimum user remove time set to 120 seconds Ready to serve You can see that 2 licenses for CLC Genomics Workbench are available and that the license server is ready to serve the licenses Your server installation is now complete CHAPTER 2 LICENSE SERVER INSTALLATION 11 2 2 Mac OS installation The license server is downloaded as an installer that will extract the relevant files and start the server daemon Click through the installer and the license server is installed The stopserver command startserver command and restartserver command can be used to control the server once installed Simply double click the relevant file to run it Note that this needs to be done by a user with administrative privileges Next step is to download a license file see section 2 2 1 2 2 1 Downloading license files for Mac OS The license server will look for licenses in the licenses folder This means that all license files should be located in this folder License files are downloaded using the downloadlicense command script To run the script double click on the file This will present a window as shown in f
5. oaoa oa a a a a a a ca 12 2 3 4 Modify the startup script 0 2 2 2 2 2 2 0 0 a a 13 2 3 9 SAL the NONSE Server a 2 a i esa mee Ke ee ee DE A 13 2 3 6 Enable on boot startup using chkconfig 2 2 2 2 2 2 gt 14 2 3 f Downloading license files for Linux 2 500 14 2 4 Upgrading an old server installation 2 2 2 2 2 es 14 2 4 1 Windows upgrade ke wae ee eH AE E 14 2 4 2 MacOS upgrade 1 2 a 16 CONTENTS 2 4 3 Linux upgrade 3 Monitoring and configuration of the server 3 1 Monitoring and controlling the license server all platforms 3 1 1 Using the End User Utility 3 1 2 XML output ssa oe as 3 2 Configuring the license server 3 2 1 General configuration TCP_LISTEN_PORT LICENSE HLE cs cassados REMOTE_ACCESS_PASSWO ORD 2 hae eeeee cet Rd 06 FILE 2 i es be mo LOG EXCLUDE s sus a 3 2 2 Access restrictions 3 2 3 Borrow restrictions 3 2 4 Borrow limits BORROW_LIMIT_COUNT BORROW_LIMIT_HOURS 4 Clients Borrow a license No license available Appendix A License download A 1 Downloading license files for Windows 2 000 ee eee ee A 2 Downloading license files for MacOS
6. used for automatic server discovery protocol The default TCP port is 6200 but can be changed to any port you may desire The UDP port is fixed to 6200 and cannot be changed Example TCP LISTEN PORT 6200 LICENSE FILE Specify the path to a license file which will be read by the server The filenames must be lowercase You can specify one or multiple paths as needed Examples LICENSE FILE d server network lic LICENSE FILE c lextra file lic LICENSE FILE home licserver floating license lic LICENSE FILE home licserver floating_license2 lic CHAPTER 3 MONITORING AND CONFIGURATION OF THE SERVER 19 REMOTE_ACCESS PASSWORD Specify the remote administration password which is used when remotely stopping and restarting the license server and removing users from it The password is case sensitive Example REMOTE ACCESS PASSWORD MyPassword123 LOG FILE Set the logfile path It is recommended to specify the absolute path to the log file Example LOG FILE c program files lmx server log LOG FILE var log lmx serv log LOG_EXCLUDE Exclude specific messages from the log The following messages can be excluded CHECKOUT CHECKIN STATUS BORROW BORROW_RETURN REMOVE_USER REMOTE_RESTART and REMOTE_SHUTDOWN Example LOG EXCLUDE CHECKOUT CHECKIN STATUS 3 2 2 Access restrictions This section describes various configuration options which can be used to grant or deny access for specific cl
7. 12 17 14 00 06 2010 12 17 14 00 06 2010 12 1 7 14 00 06 2010 12 17 14 00 06 2010 12 17 14 00 06 2010 12 17 14 00 06 2010 12 17 14 00 06 2010 12 17 14 00 06 2010 12 17 14 00 06 2010 12 1 7 414200206 2010 12 17 14 00 06 2010 12 17 14 00 06 2010 12 17 14 00 06 2010 12 17 14 00 06 LM X License Server v3 6 1 build RELEASE on hostname Linux _x86 Copyright C 2002 2010 X Formation All rights reserved Website url http www 1lm x com http www x formation com License server has pid 17684 Serving licenses for vendor CLCBIO License server using TCP IPv4 port 6200 License server using TCP IPv6 port 6200 License server using UDP IPv4 port 6200 Reading licenses Log file path usr local clclicsrv licenseserver log Log to stdout No Log format Normal Configuration file path usr local clclicsrv licenseserver cfg WARNING No licenses to serve Minimum user remove time set to 120 seconds Ready to serve CHAPTER 2 LICENSE SERVER INSTALLATION 14 2 3 6 Enable on boot startup using chkconfig If you are installing on a RedHat style distribution you can use the chkconfig tool to make the license server startup automatically at boot time cnkconitag Celelresrv on To check if the license server is set to startup automatically use the following command 0111 00 00119 List In the output look for a line similar to Clelacery Uori Lori Zion oon dron oron CrOEL Make sure that the service
8. 2 000 eee es A 3 Downloading license files for Linux Index 16 17 1 7 17 18 18 18 18 18 19 19 19 19 20 21 21 22 23 24 24 24 26 26 26 21 21 Chapter 1 Introduction This manual describes the installation configuration and maintenance of CLC bio s License Server which uses the LM X License Manager system It is written for system administrators and thus assumes some degree of familiarity with standard concepts on the platform used for the server If certain parts of the manual are unclear please do not hesitate to contact us on sup port clcbio com 1 1 Overview The CLC license server enables you to host a set of licenses for CLC applications on a central license server These licenses can then be checked out from any client computer on your network with access to the license server When the application is stopped the license will be returned to the server and become available for checkout by another user For an application to get a license it has to have access to the license server For users with a need to use the Workbench while off line it is possible to borrow a license for a certain period of time Throughout this manual the term feature refers to the type of application in question for example CLC Genomics Workbench CHAPTER 1 INTRODUCTION 6 Local Clients License Server _ Ethernet WLAN VPN Gateway Borrowed license Figure 1 1 Diag
9. 2 licenses for CLC Genomics Workbench are available and that the license server is ready to serve the licenses Your server installation is now complete 2 3 Linux installation The instructions below are for installing the CLC License Server on a RHEL CentOS Linux distribution With a few modifications you should be able to use the instructions on any suitable Linux distribution The instructions include adding a dedicated user account for running the license server as well as installing a startup script for automatic startup of the license server at boot time 2 3 1 Add user Create a user account for running the license server clclicsrv in this example Please ensure that this user account has a home directory such that HOME exists and can be found For some Linux flavours you can do this simply with a command like uUseradd clelrzosrv For other Linux flavours you may need to add a flag to enable the creation of a home directory 2 3 2 Install the files Extract the contents of the zip file to a suitable location usr local in this example and change the owner ship to the clclicsrv user you have just created ed ust local unzip path to clclicenseserver _linux zip chown R clclicsrv usr local clclicsrv 2 3 3 Install the startup script Copy the file usr local clclicenseserver runscript clclicsrv to your startup script directory typically etc init d cp usr local clclicenseserver runscript clclicsrv etc ini
10. Server v3 6 1 Win32_x86 gt Copyright 1C 2002 2010 K Formation All rights reserved Installing service donet The service was sucesfully installed Attempting to start the service The LA License Server CLCBIO service is starting The LM A License Server CLCBIO service was started successfully Press any key to continue Figure 2 2 The installation procedure le gis Bm gt a D Status Startu LogOnAs Manual Local Service Sih Link Layer Topology Discove Creates a EF LM X License Server CLCBIO a Started Autom Local System i ic Microsoft NET Framework N Microsoft Manual Local System 19 Microsoft NET Framework N Microsoft Manual Local System 19 Microsoft Fibre Channel Plat Registers t Manual Local Service ta Microsoft iSCSI Initiator Ser Manages I Manual Local System ich Microsoft Software Shadow Manages s Manual Local System Gh Multimedia Class Scheduler Enables rel Manual Local System Cea Net Tcp Port Sharing Service Provides a Disabled Local Service ich Netlogon Maintains a Manual Local System 19 Network Access Protection The Netwo Manual Network 5 Standard Figure 2 3 The services window can be found in the Control Panel CHAPTER 2 LICENSE SERVER INSTALLATION 10 2 1 2 Downloading license files for Windows The license server will look for licenses in the licenses folder This means
11. azards To allow your clients to connect to the license server you will have to allow incoming TCP traffic to the port that the server is listening on The default port number used by the license server is 6200 but you can configure the server to use a different port as described in section 3 2 1 If you wish to use the auto discovery feature of the license server you will also have to allow incoming broadcast UDP traffic to port number 6200 Because of the zero configuration usage of this port the port number is fixed and cannot be changed through the configuration file Please consult your operating system and or firewall documentation for instructions on how to allow incoming traffic on specific TCP and UDP ports Chapter 2 License server installation This first sections of this chapter describe how to install and run the license server on the Supported operating systems The license server can be installed as a service on Microsoft Windows as a daemon on Mac OS X and Linux or it can be run directly from the command line There are three different versions of the license server distribution one for each operating system The remaining part of the chapter describes how to monitor and control a running server and finally how to configure the license server by editing the config file 2 1 Windows installation First unzip the license server distribution to a suitable location on the computer e g C Program files clclicsrv To in
12. computer Download a License Choose this option if you have a License Order ID and would like to download a License Import a License from a File Choose this option if you have a License File on your computer and would like to import it Upgrade a license from an older Workbench Choose this option if you have an older version of this workbench with a commercial license and would like to upgrade your license Configure License Server Connection Choose this option if your company or institution is using a central CLC License Server This option also enables you to disable a license server connection If you experience any problems please contact The CLC Support Team Pro seta 09096 Pio Cree Cau Figure 4 1 Select Configure license server connection When you have selected this option and click Next you will see the dialog shown in figure 4 2 This dialog lets you specify how to connect to the license server e Connect to a license server Check this option if you wish to use the license server e Automatically detect license server By checking this option you do not have to enter more information to connect to the server e Manually specify license server There can be technical limitations which mean that the license server cannot be detected automatically and in this case you need to specify more options manually Host name Enter the address for the licenser server Port Specify whic
13. e gt One or more uses Allow the specific feature to be bor DPS MORRI famea Tor he specified uses DENY BORROW USER ALL One or more users Deny all features to be borrowed for TOMO PIONS fre speteausers 0000 DENY BORROW USER lt feature gt One or more users Deny the specific feature to be bor RR MU rowed for the spected users 00 The rules are written and used in the same way as the access restriction rules described in the previous section If you wish to disable borrowing for all users put this into the config file DENY BORROW IPADDR ALL 3 2 4 Borrow limits Two limits are available which can be used to prevent clients from borrowing all the available licenses for a given feature or from borrowing a feature for an unreasonable long time BORROW_LIMIT_COUNT Imposes a limit on the number of licenses which can be borrowed to prevent all licenses from being borrowed at the same time Borrow limits are configured separately for each feature The syntax is BORROW LIMIT COUNT lt feature name gt lt limit count gt Where lt limit count gt is number from 1 to the number of available licenses for the given feature If you wish to restrict the feature from being borrowed completely you should specify a restriction as described in the previous section Example BORROW LIMIT COUNT PROTEIN 1 BORROW LIMIT COUNT RNA 5 The configuration in the example above will allow one license for the CLC Protein Workbench t
14. erver The relevant commands are described below In all the commands the arguments enclosed in angle brackets lt and gt must be replaced an actual argument If you are running the End User Utility on the same machine as the server and on the standard port 6200 you can omit the host and port options from the commands If you omit the password option from the command you will be prompted for it when executing the command An additional advantage of entering your password in this way is that a person standing next to will not be able to read it To display the current status of the license server use the command Imxendutil licstat host lt server host port lt port gt To remove a user from the license server i e retrieve the license checked out for this user and thereby interrupt the user s Workbench session use the command Imxendutil removeuser clientusername lt user gt clienthostname lt host gt host lt host gt port lt port gt password lt password gt 1 7 CHAPTER 3 MONITORING AND CONFIGURATION OF THE SERVER 18 3 1 2 XML output If you would like to process the license server status output in some programmatic way you can use the End User Utility to extract the status in XML format Contrary to the log the XML output displays the current status of the server The syntax for displaying the license statistics in XML format is Imxendutil licstatxml host lt server host gt port lt server port g
15. eserver240 Imx sery clebio exe Path to configuration file C clelicenseserver240 licenserver cig Path to license file C clelicenseserver240 clegenomicswb4x2 cle_bio lic Path to logfile C clelicenseserver240 icenserver log Service status Service Is running Mem Server Remove Server Start Server Stop Server View Logfile Copyright C 2002 2009 Formation All rights reserved Website wew e formation com Figure 2 6 To remove the old service click Remove server LM X End user Configuration Tool v2 4 OR Hostid Client Application License Path License Server Configuration Query License Ser 4 Configure one or more license servers to run 38 4 Service Service name LM License Server CLCBIO Path to license server Path to configuration file Path to license file Path to logfile Service status New Server Remove Server Start Server Stop Server View Logfile Copyright C 4002 2009 Formation All rights reserved Website www s formation com Figure 2 7 The old service has been removed Click on the Remove Server button to remove the current running service and a dialog will inform you when done see figure 2 7 Once the server has been removed you can begin setting up the new service Please follow the instructions in section 2 1 If you have made changes to the configuration file of your current installation you can replace the configuration file of t
16. figuration files you can transfer them to the new version If you have written your own startup script for the license server you should be able to reuse it with the updated version Alternatively you may want to have a look at the included startup script located in the runscript directory You are also encouraged to have a look at the installation guide in section 2 3 for instructions A key improvement of the new license server is the ability to specify a directory for storing your license files Any files within this directory will be loaded and you no longer need to add each file to the configuration file If you are using a custom startup script you will need to make a change to the invocation of the server to use this You need to specify the 1 option with the full path to a directory as argument as shown below Iimz serv olcbio 1 xpath to license dir gt Chapter 3 Monitoring and configuration of the server 3 1 Monitoring and controlling the license server all platforms There are a number of different ways you can monitor and control a running license server using the command line LM X End user Utility which is available for all platforms Please note that you can monitor a license server running on one platform e g Linux from another computer running a different operating system e g Windows 3 1 1 Using the End User Utility The LM X End User Utillity is a command line tool for querying and controlling the license s
17. file This will present a window as shown in figure A 2 Paste the Order ID supplied by CLC bio and press Enter Please contact support clcbio com if you have not received an Order ID 26 APPENDIX A LICENSE DOWNLOAD 27 BAR Terminal bash 79x24 macbook 1 7 qondersent HHPHPHRRHHHHHHHHHEHHREEEHEEHEEHHEHHHEEHRE ADDED RR EH CLO bio License download utili ty HH FERRARA Hostname ho HostlDis xx Please enter for copy paste your License Order ID and press Figure A 2 Download a license based on the Order ID Next you need to restart the server by double clicking the restartserver command script Note that if you are upgrading an existing license file this needs to be deleted from the licenses folder When you run the downloadlicense command script it will create a new license file A 3 Downloading license files for Linux The license server will look for licenses in the usr local clclicsrv licenses directory This means that all license files should be located in this directory License files are downloaded using the downloadlicense script Run the script and paste the Order ID supplied by CLC bio Please contact support clcbio com if you have not received an Order ID Next you need to restart the server service clclicsrv restart If the service command is not available you can start the server by invoking the script directly etc init d clclicsrv restart Note that if you are upgrading an existing license file
18. h port to use e Disable license borrowing on this computer If you do not want users of the computer to borrow a license see section 4 you can check this option 23 CHAPTER 4 CLIENTS 24 License Wizard 58 m CLC Main Workbench Configure License Server connection Please choose how you would like to connect to your CLC License server V Enable license server connection Automatically detect license server Manually specify license server tname IP address Port Disable license borrowing IF you choose this option users of this computer will not be able to borrow licenses From the License Server If you experience any problems please contact The CLC Support Team Proxy Settings Previous 00 Cancel Figure 4 2 Connecting to a license server Borrow a license A floating license can only be used when you are connected to the license server If you wish to use the CLC Workbench when you are not connected to the server you can borrow a license Borrowing a license means that you take one of the floating licenses available on the server and borrow it for a specified amount of time During this time period there will be one less floating license available on the server At the point where you wish to borrow a license you have to be connected to the license server The procedure for borrowing is this 1 Click Help License Manager to display the dialog shown in figure 2 U
19. he new server once installed You may also want to save a copy of the log file A key improvement of the new server is that license file management has become a lot simpler CHAPTER 2 LICENSE SERVER INSTALLATION 16 Any license file placed in the licenses directory will be loaded by the server As a consequence you no longer need to specify each license file in the configuration file If you have configurations like this in your configuration file you can remove them 2 4 2 Mac OS upgrade Running the installer package for the new version of the License Server will update an exist ing package based installation After the installation is complete you can use the included management scripts to start stop and restart the server Please follow the instructions in section 2 2 to install the new server The old log and configuration files will be preserved If you have performed a manual installation without using the package based installer you will need to stop the running server before installing the new version After installing the package the license server will be located in the directory Application CLCLicenseServer Please migrate any existing configurations to this directory and restart the server 2 4 3 Linux upgrade Before updating make sure that your current running instance is stopped After the instance is stopped follow the installation instructions in section 2 3 to setup the new version If you have made changes to the con
20. ients or groups of clients You can for example use these options to limit access to a department or group of users Access limitations can be specified based on ip addresses host names or user names Restrictions are specified as a sequence of rules which are used in the following way e Rules are attempted to be matched in the order that they are written e f no rule matches the specific client then that client is allowed An overview of the possible rules are presented in the following table CHAPTER 3 MONITORING AND CONFIGURATION OF THE SERVER 20 Option 0000 Description ALLOW_IPADDR_ALL One or more IP addresses Allow access to all features for the specified SONORA One ene B agaresses o o S r ne speaned ALLOW_IPADDR_ lt feature gt One or more IP addresses Allow access to a specific feature for the DE eee S mea addresses o r A DENY_IPADDR_ALL One or more IP addresses Deny access to all features for the specified D ais paaaresses DENY_IPADDR_ lt feature gt One or more IP addresses Deny access to a specific feature for the spec ee ALLOW_HOST_ALL One or more host names Allow access to all features for the specified ALLOW_HOST_ lt feature gt One or more host names Allow access to a specific feature for the STARE One ormare spend hostnames DENY HOST ALL One or more host names Deny access to all features for the specified DENY HOST lt feature gt One or more host names Deny access to
21. igure A 2 AAA Terminal bash 79x24 bash macbook 1 qandersen HEREAEAESE HEHE AE EAE HE HE EE HEE HE ESE EE HE HE HE HEE EE HE EE HE HH EE HE E SEE EH CLO bio License download utility ER EEEE EEEE EE EEEE EEEE EEE EEEE EE EEEE EEE EE EEEE EEEE EEEE EEEE EEEE EEE EEE EEEE EEEE Hostname h HostiDis ji XXXEXNXXXENM MEENA ENS Please enter for copy paste your License Order I0 and press return Figure 2 5 Download a license based on the Order ID Paste the Order ID supplied by CLC bio and press Enter Please contact support clcbio com if you have not received an Order ID Next you need to restart the server by double clicking the restartserver command script Note that if you are upgrading an existing license file this needs to be deleted from the licenses folder When you run the downloadlicense command script it will create a new license file Next step is to check that the server is running as expected see section 2 2 2 CHAPTER 2 LICENSE SERVER INSTALLATION 12 2 2 2 Checking that the server set up is complete As a final check to see if the server is running as expected open the log file Li censeserver log and check the lines at the bottom of the file It should look similar to this 2011 01 19 10 54 52 Serving following features CLCGENOMICSWB v4 99 2 license s license type exclusive Minimum user remove time set to 120 seconds Ready to serve You can see that
22. is listed as on for the appropriate run level typically 3 or 5 2 3 7 Downloading license files for Linux The license server will look for licenses in the usr local clclicsrv licenses directory This means that all license files should be located in this directory License files are downloaded using the downloadlicense script Run the script and paste the Order ID supplied by CLC bio Please contact support clcbio com if you have not received an Order ID Next you need to restart the server Service clelicsrv restart If the service command is not available you can start the server by invoking the script directly etc init d clclicsrv restart Note that if you are upgrading an existing license file this needs to be deleted from the licenses folder When you run the downloadlicense script it will create a new license file 2 4 Upgrading an old server installation This section explains how to upgrade from an older version of the license server to version 3 6 1 2 4 1 Windows upgrade Before setting up the new version of the license server you have to remove the service already installed Locate your current license server installation directory and open the LMX Configuration Tool application Choose the License Server Configuration tab and you see something similar to figure 2 6 CHAPTER 2 LICENSE SERVER INSTALLATION 15 E LM X End user Configuration Tool v2 4 Service name Path to license server C clelicens
23. o be borrowed and five licenses for the CLC RNA Workbench CHAPTER 3 MONITORING AND CONFIGURATION OF THE SERVER 22 BORROW_LIMIT_HOURS Limit the number of hours which licenses can be borrowed to prevent licenses from being borrowed too long Borrow limits are configured separately for each feature The syntax is BORROW LIMIT HOURS lt feature name gt lt limit hours gt Where lt limit hours gt is a number between 1 and the maximum borrow period imposed by the license The maximum borrow limit for CLC Workbenches is one week Setting the limit to a value higher than the limit imposed by the license will result in an error when starting the license server Example BORROW_LIMIT_HOURS_PROTEIN 48 BORROW LIMIT HOURS RNA 12 The configuration in the example above will allow licenses for the CLC Protein Workbench to be borrowed and for 48 hours and licenses for the CLC RNA Workbench to be borrowed for 12 hours Chapter 4 Clients To use a floating license select Configure license server connection in the dialog shown in figure 4 1 License Wizard ez m CLC Main Workbench You need a license In order to use this application you need a valid license Please choose how you would like to obtain a license for your workbench Request an Evaluation License Choose this option if you would like to try out the application for 30 days Please note that only a single 30 day evaluation license will be allowed For each
24. ram of a license server setup 1 2 Server requirements The license server does not require much in terms of processing power and it only consumes a few megabytes of memory This means that if you are putting together a dedicated server specifically for use as a license server a modestly powered system equipped with a high number of redundant components will probably be a better investment than a system which is faster has more memory etc The license server is available for the following operating systems e Microsoft Windows XP Windows Vista or Windows 7 Windows Server 2003 or Windows Server 2008 Mac OS X 10 5 or later e Red Hat Linux e Fedora Core Linux e SUSE Linux The license server works or can be made to work on many other Linux distributions as well If you are interested please contact support clcbio com CHAPTER 1 INTRODUCTION 1 3 Network requirements In order to check out a license from the server your client needs to establish a TCP connection to the license server program running on your server This means that your server will have to be reachable on the LAN or WAN network from your clients Clients working from remote locations will also be able to contact the license server if they are connected to your network through a VPN gateway or a similar solution 1 4 Firewall settings Your server is probably running some kind of local firewall to protect it against unauthorized access and other security h
25. roperties CHAPTER 4 CLIENTS No valid license found XA CLC Network Licensing The Following problems were encountered while trying to locate a valid license Click on each error for a more detailed description Ea License Server 192 168 1 200 port 6200 a Ss No license available at the moment All licenses obtainable from the server are currently in use If the problem persists please contact your local license server administrator Additional licenses can be purchased by contacting the CLC bio sales team on sales clcbio com To import a new license or change your license server settings please click the License Assistant button lf you experience any problems please co ntact The CLC Support Team Host ID OSEDESSCEFD289F E A8 1AEFFO19F87560 2A378AC 188631978 License Assistant Limited Mode Figure 4 3 No more licenses available on the server License Server Error Unable to locate a license server A license server could not be located on your network Ifthe problem persists please contact your local license server administrator Configure License Server Figure 4 4 Unable to contact license server 25 Appendix A License download This section explains how to download a license for a license server that is already installed For guidance on installation please see chapter 2 A 1 Downloading license files for Windows The license server will look for licenses
26. se the checkboxes to select the license s that you wish to borrow 3 Select how long time you wish to borrow the license and click Borrow Licenses 4 You can now go offline and work with CLC Workbench 5 When the borrow time period has elapsed you have to connect to the license server again to use CLC Workbench 6 When the borrow time period has elapsed the license server will make the floating license available for other users Note that the time period is not the period of time that you actually use the Workbench Note When your organization s license server is installed license borrowing can be turned off In that case you will not be able to borrow licenses No license available If all the licenses on the server are in use you will see a dialog as shown in figure 4 3 when you start the Workbench In this case please contact your organization s license server administrator To purchase additional licenses contact sales clcbio com You can also click the Limited Mode button see section If your connection to the license server is lost you will see a dialog as shown in figure 4 4 In this case you need to make sure that you have access to the license server and that the server is running The information about how to connect to the license server is stored in a file called license properties in the installation directory of the Workbench under settings e g C Program Files CLC Main Workbench 4 settings license p
27. stall the License Server as a Windows Service right click on the installservice file and choose Run as administrator see figure2 1 This will open a terminal window and guide you through the installation procedure Press a key on the keyboard when asked to do so see figure 2 2 Once successfully installed the services will be visible in the Services control panel in Windows see figure 2 3 The name of the service is LM X License Server CLCBIO From here you can start stop and restart the service if needed Next step is to download a license file see section 2 1 2 2 1 1 Uninstalling the Windows Service To uninstall the service you can use the uninstallservice script Run this in the same way as the install script by right clicking and choosing Run as administrator CHAPTER 2 LICENSE SERVER INSTALLATION m clclicenseserver Edinstallservice licenseserver licenseserver Print g LMX Configur P Run as administrator be 8 Imxendutil Troubleshoot compatibility 2 Edit with Notepad Restore previous versions e Imx serv deb Se Jrestartservia Send to Ei Juninstallservi Cut Copy Create shortcut Delete Rename Properties Figure 2 1 Install the license server as a service EM C Windows system32 cmd exe This will install the CLC License Server as a Windows Service License server installation dir C Program Files clclicsrus Press any key to continue LM X License
28. t The output produced is in the format lt xml version 1 0 encoding UIF 8 gt lt LM X STAT VERSION 2 0 SERVER VERSION 2 0 VENDOR CLCBIO UPTIME 6 hour s 21 min s 22 sec s gt lt FEATURE NAME DNAY VERSION 3 0 END 2008 01 01 USED_LICENSES 1 TOTAL LICENSES oct lt FEATURE gt lt FEATURE NAME COMBINED VERS ION 3 0 END 2008 01 01 USED LICENSES 12 TOTAL LICENSES 25 gt lt FEATURE gt lt LM X gt Depending on how this output is processed you can use this functionality for many different purposes including e Automatic monitoring of license server health and usage e Generating statistics about license usage e Presenting the status of the license server in some other way for example on a web page 3 2 Configuring the license server Changing the configuration of the license server is accomplished by editing the server cfg file and subsequently restarting the license server process By editing this file you can change many different aspects of the license server including paths to various files and access restrictions 3 2 1 General configuration Below are descriptions of the various configuration options which specify the environment of the license server paths to various files and the administration password TCP LISTEN PORT This option defines the TCP portnumber that the license server will use to listen for connections The TCP port is used for data traffic protocol A separate UDP port is
29. t d CHAPTER 2 LICENSE SERVER INSTALLATION 13 2 3 4 Modify the startup script Open the file etc init d clclicsrv with a text editor nano pico emacs vi or similar Edit the configuration variables to suit your installation and environment If you have used the default values found in these instructions you should only have to change the PASSWORD variable to match the REMOTE_ACCESS PASSWORD from your license server configuration file Set the username under which the license server will run it is not recommended to run as root USER clclicsrv Set the license server password which is specified in your lmx serv cfg file as REMOTE _ACCESS _PASSWORD PASSWORD MyPassword123 Set the TCP UDP portnumber the license server will listen on PORT 6200 Set the path to the directory that contains the license server files DIRECTORY usr local clelicens eserver 2 3 5 Start the license server If you are running in a RedHat style Linux distribution use the following command to start the license server as root service ClLeluGsny Start If the service command is not available you can start the server by invoking the script directly CCCfIMLE2d7eCLelLrVcsry start Once the server is started check the log file for status cat usr local clelicsrv licenseserver log lf the server was started correctly you should see output similar to 2010 12 17 14 00 06 2010 12 17 14 00 06 2010 12 17 14 00 06 2010 12 17 14 00 06 2010
30. that all license files Should be located in this folder License files are downloaded using the 1icensedownload script To run the script right click on the file and choose Run as administrator This will present a window as shown in figure A 1 Es C Windows System32 cmd exe TE Pe BEE HH CLO bio license download utilit HH REASON ARARAS OSSOS TEE BERE DE AEDE BEBE BEMA OEBE PEAR DEEE ORAR TERA ARARAS AAA Hostname Host I Des3 Please enter Cor copy paste your license Order ID and press return gt Figure 2 4 Download a license based on the Order ID Paste the Order ID supplied by CLC bio right click to Paste and press Enter Please contact Support clcbio com if you have not received an Order ID Next you need to restart the server by running the restartservice script To do this right click on the file and choose Run as administrator You can also restart the server through the Services control panel shown in figure 2 3 Note that if you are upgrading an existing license file this needs to be deleted from the licenses folder When you run the licensedownload script it will create a new license file Next step is to check that the server is running as expected see section 2 1 3 2 1 3 Checking that the server is ready As a final check to see if the server is running as expected open the log file lLicenseserver log in a text editor e g Wordpad and check the lines at the bottom of the file It should
31. this needs to be deleted from the licenses folder When you run the downloadlicense script it will create a new license file Index Access restrictions 19 Auto discover firewall problems Borrow disable 21 limit number 21 limit time 22 restrictions 20 Borrow floating license 24 Client set up 23 Configuration 18 Firewall settings 7 Floating license use offline 24 Host name restrict access 19 IP addresses restrict access 19 License file path to 18 License server access offline 24 Linux server requirements 6 Log set messages to exclude from 19 Log file path to 19 Log get XML output 18 Mac OS X server requirements 6 Monitor license server 18 Network requirements Off line access to a license 5 Operating system requirements 6 Options 18 Password for remote access 19 Platform requirements 6 Requirements network 7 server 6 Restrictions for access 19 Server requirements 6 Statistics license server usage 18 Status 18 Subnet restrict access for 19 TCP port specify 18 TCP server firewall settings 7 UDP port number 7 Usage view 18 User name restrict access 19 VPN connection 7 Windows server requirements 6 Workbench server connection from 23 Working off line 5 XML output for usage statistics 18 28
32. tical to the rules used to restrict overall access to the license server described in the previous section An overview of the possible rules are presented in the following table CHAPTER 3 MONITORING AND CONFIGURATION OF THE SERVER 21 Option Argument si Description Seon a r BORROW_IPADDR_ALL One or more IP addresses Allow all features to be borrowed for the specified IP addresses ALLOW_BORROW_IPADDR_ lt feature gt One or more IP addresses Allow the specific feature to be borrowed for the specified IP addresses DENY BORROW IPADDR ALL One or more IP addresses Deny all features to be borrowed for the specified IP addresses DENY BORROW IPADDR lt feature gt One or more IP addresses Deny Allow the specific feature to be borrowed for the specified IP addresses ALLOW BORROW HOST ALL One or more host names Allow all features to be borrowed for PEA RO tne sped hostnames o ALLOW BORROW HOST lt feature gt One or more host names Allow the specific feature to be bor E One or more E owed for the spesfic host names DENY BORROW HOST ALL One or more host names Deny all features to be borrowed for oraora ness te Sectted host names o DENY_BORROW_HOST_ lt feature gt One or more host names Deny the specific feature to be bor O MM hosi rames rowed forthe spected host names ALLOW BORROW USER ALL One or more users Allow all features to be borrowed for DS SSS pe specified ses o ALLOW BORROW USER lt featur
Download Pdf Manuals
Related Search