Geneious Floating License Manager Version 2.0.5 Biomatters Ltd April 9, 2013 2 Introduction A Geneious Floating License is provided by a server to clients that can request a license over a network. The Geneious Floating License Manager provides command line tools for administrating Geneious Floating Licenses. This manual will guide you through installing and using the Geneious Floating License Manager. Prerequisites Before proceeding with the installation you should note the following: • Don’t attempt this installation if you don’t have full administrator rights for the machine in question, and if you don’t know how to configure network services and firewalls. • You must make sure that your machine’s hostname and IP address agree because the license manager will use this. If they don’t agree (i.e. looking up the hostname returns a different IP address to the one your machine is actually using), you will get an error which includes the phrases ‘Vendor daemon can’t talk to lmgrd’ and ‘EXITING DUE TO SIGNAL 37’. • If you have previously installed the Geneious Floating License Manager on the host machine, make sure you uninstall that version before installing this new version. You should find the uninstaller in the previous install directory (uninstall on Linux, uninstall.exe on Windows and Geneious License Server Uninstaller.app on Mac OS X). The uninstaller may take a few seconds to launch so be patient. • The license manager can coexist with other FLEXnet license manager installations on the same operating system but if you don’t want to use our standard scripts, stop the install once you reach the step where the installer asks to configure the ports and move to the section about setting up the manager with your own FLEXnet installation at the end of this manual. • You cannot host multiple Geneious licenses on the same license manager. To serve a Geneious Floating License, you must have a machine that has a fixed IP address and registered hostname that resolves to that IP address, and is always turned on so disable sleep or power saving features. You also need to ensure that you have full rights to open the necessary ports - it isn’t uncommon for some environments to have policies in place that prevent administrators on machines from making services available on the required ports so make sure you have permission to install this service. If you have complicated licensing requirements such as needing to have multiple groups using different licenses that may be subscriptions or perpetual licenses, and you want to centralize 3 the servers on one physical machine, the only way to do this is to virtualize the servers. We suggest installing VMware or similar and creating a new host for each group’s license server. A lightweight Linux installation would be a good solution. Each machine should have a unique fixed IP address. Regardless of whether it is a virtual machine, or a physical host, you will need to ensure that both the license server and vendor daemon ports are open to the client machines and also give your users the IP address/hostname of the license manager. They will then enter the hostname and license server port into the appropriate boxes in Geneious which will then request a license from the server. If you have issues with clients not being able to get licenses, the most common cause is that the two ports required are not open on your firewall (27001 and 49630 by default but you can change these during installation), or the user is putting the wrong hostname and port details into the dialog (27001 by default, not the 49630 although that does need to be accessible from the client too.) Clients can connect to the server via a VPN, but if the VPN connection is severed, they will lose the license within five minutes. The license server will recover the license fifteen minutes after the connection was lost. For this reason, users on a VPN must make sure they stay connected until they close Geneious if they want to continue using the floating license. System Requirements • Windows XP or later on Intel (Windows 2000 and Itanium are not supported) • Most Linux distributions on Intel based on RedHat, Debian or SuSE with Linux Standard Base 3.0 support • Mac OS X Leopard or later on PPC or Intel Installing the Geneious Floating License Manager Download the appropriate Geneious Floating License Manager software for your chosen computer. Versions for Windows, Linux and Mac are available. Windows and Linux versions are available in 32 and 64 bit versions, while the Mac version is a universal binary for Intel and PPC Macs. Windows and Linux versions are also available with or without a bundled Java Runtime Environment. The Mac OS X version will use the one provided with the operating system. If you have a previous installation of Geneious Floating License Manager, either on a different machine or if you are intending to relocate the installation to a different directory, go into the current Geneious Floating License Manager installation directory and run the uninstall 4 program which will remove the current service and associated files along with releasing the license from that machine. Doing so will avoid issues when you rerun the installer. Before installing on Linux, make sure you have the Linux Standard Base installed. On Debian based systems such as Ubuntu, you can install it using: sudo apt-get install lsb If you have a minimal Linux install, you may also lack the sysvutils which the installation requires since they provide the service command. Instructions for acquiring these will depend on your distribution and a Google search should help. You will need to take the following steps as administrator or root and have internet access (direct or via a proxy). Run the Geneious Floating License Manager installer package. This will launch a graphical installer for the Geneious Licensing Utility and tools and then prompt for the two ports the server will run on, your activation ID and proxy settings for internet access if necessary. This installer will create a service called geneiouslm which runs lmgrd (License Manager Daemon). If you would like to add the license to an already configured FLEXnet licensing system, you should not continue with the installation after the point at which it asks to set the ports for the service. Hit Cancel and the software will be installed but it won’t have activated the license or configured the service. See the section on setting up the license with your own FLEXnet server at the end of this manual. Be sure to open the specified ports on your firewall (27001 and 49630 by default but you may have chosen different values) so that Geneious Pro clients can then access it. If you don’t open these ports on your firewall, clients will report that they cannot connect to the server so if you are seeing this issue, that is very likely to be the cause and you should add both port exceptions in the firewall settings of the operating system the Geneious Floating License Manager software is installed on. You may also need to add Geneious to the allowed applications that can access the internet on the client machines but you would need to do that so that Geneious can download data from NCBI anyway. If you want to change the ports the server runs on later, you can just reinstall the server and change your port selections. Do not change the installation directory without uninstalling the previous installation first. Connecting to the license server from Geneious To connect to license server from Geneious: 1. Start up Geneious 5 2. Select Activate Geneious Pro from the Pro menu 3. Check the “Use license server” button 4. Enter the hostname/IP address of the server and license server port (default is 27001). 5. Click OK to start using the license Once you have set up Geneious to use the floating license, it will automatically check it out whenever Geneious starts up and check it in when Geneious shuts down. If there are no seats available, this copy of Geneious will be placed in a queue until one comes available. Monitoring and controlling your server Windows From the command prompt, you can run the following commands to control the license manager daemon: • Start geneiouslm service – sc start geneiouslm • Stop geneiouslm service – sc stop geneiouslm • Check geneiouslm is running – sc query geneiouslm In the installation directory, there is also a file called geneiouslm.log which you can look at and it will let you know if the server started, what ports it is on and you’ll also see a record of the licenses coming and going. Linux From a terminal, you can run the following commands as root or using ‘sudo’ to control the license manager daemon: • Start geneiouslm service – service geneiouslm start • Stop geneiouslm service – service geneiouslm stop • Check geneiouslm is running – service geneiouslm status • Restart geneiouslm service – service geneiouslm restart 6 In the installation directory, there is a vendor directory which contains the geneiouslm.log file. This has a record of your server’s activities. Note, you should wait at least 60 seconds before starting the daemon again after stopping it otherwise the operating system won’t have cleared the port. Restarting includes this wait. By default, the daemon may not automatically start on a reboot. For example, with RedHat based systems you should run the following to make it start each time the system restarts: chkconfig geneiouslm on Note that the actual binary that serves the licenses is called lmgrd. Mac OS X From Terminal.app, you can run the following commands using ‘sudo’ to control the license manager daemon: • Start geneiouslm service – SystemStarter start geneiouslm • Stop geneiouslm service – SystemStarter stop geneiouslm • Restart geneiouslm service – SystemStarter restart geneiouslm In the installation directory, there is a vendor directory which contains the geneiouslm.log file. This has a record of your server’s activities. Note, you should wait at least 60 seconds before starting the daemon again after stopping it otherwise the operating system won’t have cleared the port. Restarting includes this wait. You can check the status of the license server with the following command which should be run from inside the vendor directory: ./lmstat -c geneious.lic The daemon should automatically start when your system is rebooted. Note that if you’re running the Mac OS X firewall you may be asked if you want to allow the application lmgrd to accept incoming connections. This is the actual binary that serves the licenses so you should allow it access. 7 floatingLicenseManager floatingLicenseManager is a command-line utility which provides you with ways of manipulating your floating license that are not convenient or available through the installer, specifically: • Checking that a floating license has been activated • Activating a floating license • Returning an activated license so it can be activated on a new server • Creating a ”borrow file” to allow users to detach a license from the license server and use it offsite floatingLicenseManager must be run as administrator/root and unless it is in your path, you should precede it with ./ on Linux or Mac OS X so that the shell knows to run the command from the current directory assuming you’re already in the directory that contains the utility. Checking your license has been activated To check what floating license if any is activated, use the following command: floatingLicenseManager -check Activating your license Licenses must be activated against the Geneious operations server before they can be used. You will need an internet connection to do this. To activate the floating license, use the following command: floatingLicenseManager -activate -activationID <activation ID> [-proxyHost <proxy host> -proxyPort <proxy port> [-proxyUserid <proxy userid> -proxyHost <proxy userid>]] Where: • hactivationIDi is the activation ID sent to you by Biomatters on the purchase of your license. 8 • The other arguments specify the settings needed to use the proxy in your organisation. Please note that if you are using a proxy on Windows the proxy settings will be determined using WinInet and should not be specified here. For example: floatingLicenseManager -activate -activationID 1ACC-6AF5-489B-3B2B-A9B1 Or: floatingLicenseManager -activate -activationID 1ACC-6AF5-489B-3B2B-A9B1 -proxyHost myProxy -proxyPort 8080 -proxyUserid "Joe Bloggs" -proxyPassword myPassword Your license can only be activated on one computer at once. If you want to move your license server to a new computer, you will need to release the license, as explained in the next section. Releasing your license If you want to move your license to a new server, you will need to release your license back to the Geneious operations server so that it is available to be activated elsewhere. You will need an internet connection to do this. To release the floating license, use the following command on the machine the license is currently installed on: floatingLicenseManager -release [-proxyHost <proxy host> -proxyPort <proxy port> [-proxyUserid <proxy userid> -proxyHost <proxy userid>]] Note that this command will not release a license that is activated on another machine, it must be executed on the same machine the license was activated on. Uninstalling the license manager daemon If you want to remove the daemon and release the license in a single step at the command line, use the following command: floatingLicenseManager -uninstall You should then delete the installation directory to remove the program entirely. 9 Creating a ”borrow file” Floating licenses can be borrowed, ie their seats temporarily detached from the server and associated with a particular computer so that the license can be used when a connection to the license server is not available. If you do not want to provide this ability, you can ignore this section. Borrowing should be used with care, because seats which have been borrowed are not available to other users until they are returned and they can only be returned when the borrower is back on the same network as the license server. Users can borrow a license through Geneious only if they have been given a ”borrow file” (borrow.txt) which gives them permission to do so. floatingLicenseManager can create this borrow file. To create a borrow file to give to a user who wants to borrow a license, use the following command: floatingLicenseManager -allowBorrow [-user <username>] [-expiry <dd-MMM-yyyy>] [-outpath <path to borrow file>]" Where: • huseri is the username of the user who is allowed to borrow. This must match the name of the user account on the computer where the license is borrowed. If this parameter is omitted any user can use the borrow file. • hdd-MMM-yyyyi is the expiry date, ie the date (midnight at the start of that day) when the license will automatically be returned to the server. If this parameter is omitted, the expiry date will be the following day. • hpath to borrow filei is the directory borrow.txt will be written to. If omitted the current directory will be used. Once a borrow file has been created, the user should start Geneious to receive a license from the server (they may have to wait until one is available) and they can then go into the Pro menu and choose borrow. Geneious will ask for the borrow file which they should browse to and select, and this will then complete the process disconnecting the license seat from the server allowing the user to take it away. They can return the license at any time as long as they are on the same network as the server but they should not try to return the license when they are off the network as it will fail. Once the borrow period expires, they will lose Pro capabilities, and the license server will return to the original seat count. 10 Setting up the Geneious Floating license with your own FLEXnet server If you haven’t used the provided daemon because you already have experience with FLEXnet and have your own server installation, you can still install our license on your server. Assuming you have cancelled the installer at the correct point (just where it asks to set the ports) you should have the floatingLicenseManager installed in the directory you specified. You can use lmgrd/lmutil version 11.3+ to administer licenses. Version 10 or older is not supported because it doesn’t support Trusted Storage which is required for Geneious floating licenses. If your server meets these requirements you can continue. If not, you’ll either need to upgrade, or install the default Geneious Floating License Manager daemon on a different machine (or Virtual Machine) so it won’t clash with your present FLEXnet server installation. Manually activate the license using the floatingLicenseManager as shown in the “Activating your license” section. Because Geneious licenses are stored in Trusted Storage, your license file (geneious.lic) does not contain any features. Its presence just informs your license server to look in Trusted Storage for any licenses from the Geneious vendor. This sort of license file is called a “bootstrap” license file. Create a geneious.lic file that looks like this: SERVER this_host ANY 27001 VENDOR geneious options=geneious.opt PORT=49630 You can change the port values, but leave everything else as it is here. Create a geneious.opt file that looks like this to ensure that the license is made available again 15 minutes after contact is lost with a client: TIMEOUTALL 900 Don’t set the value of TIMEOUTALL lower than 900. The Geneious vendor daemon (geneious or geneious.exe), bootstrap license (geneious.lic), options file (geneious.opt) and shared library (geneious libFNP.so, geneious libFNP.dylib or geneious libFNP.dll) will be in the same directory as the floatingLicenseManager. To use these with your own copy of lmgrd consult the FLEXnet License Administration Guide. You will need all three files in the same directory and you may need to specify the library path as being where the three files have been put. You may also want to consult the startup script that should also be in the floatingLicenseManager directory if you’re on Linux or MacOS to see how they work or use them as templates to run the daemon.
* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project