Installing SPEED 2012 (7.

02 Release)
These instructions describe how to install SPEED on Windows: Downloading from the User Services site Installing, running and uninstalling Setting up licensing Getting support

Downloading From User Services

SPEED can be downloaded from the CD-adapco User Services site, at https://support.cd-adapco.com/. The steps for doing this are as follows: 1. Create a directory to hold the downloaded files, for example, c:\downloads on Windows 2. Use your web browser to navigate to the CD-adapco download site and log in as normal. Contact your sales representative if you do not have a login. 3. Click the Download option on the left side of the main User Services home page. This will present a tabbed window containing all products available for download. Expand the SPEED item and choose the appropriate version (7.02 is the current version). Click the Download button for the operating system and CPU that you are interested in and choose Save from the dialog that follows. Save the file to the directory that was created in Step 1. 4. Navigate to the download directory created in Step 1. 5. Follow the instructions for Windows below

Installing, Running and Uninstalling

This section contains instructions for installing, running and uninstalling on: Windows 7/Vista/XP

Windows 7/Vista/XP
Administrator privileges are required for the standard installation of SPEED on Windows. This section covers: Obtaining a license key Installing from the User Services site Using the interactive installer Finding the log files Uninstalling from Windows

Obtaining A License Key SPEED is a licensed product--you will not be able to run the software until the licensing is correctly configured. The licensing operates through a license server, which is a separate process that runs continuously on a machine you choose. In general, only one machine on your network will be required to act as a license server, although you can set up multiple machines to provide redundancy in case of machine failure. You will need to obtain a license file from your CD-adapco representative before the license server can be correctly configured. He or she will ask you for a hostid identifier, which you get by running a utility program that comes from the Flexera download site. See section, Getting the Server Host IDs. If you have the license file available before attempting to install SPEED, the installation process should automatically configure and run the license server for you. If you need to configure the license server after your initial installation, you should read the section on Setting up a single server floating license. Other instructions are provided for alternative configurations.

Installing From the User Services Site For installation from the User Services site, follow the general instructions for downloading files then: 1. Double-click on SPEED120420.exe to download the contents of the zip file to the download folder. 2. Navigate to the download folder and double-click on SPEED120420.exe. This will launch the Windows installer. A step-by-step guide to the installer is given below.

Using the Windows Installer Interactively When the installer has launched correctly, you will be presented with a series of screens to guide you through the process. These steps are itemized below, with further explanation where necessary.

Installing on a Network With an Existing SPEED License Server For users installing SPEED on a network where an existing license server is available, choose the Custom Install option, and then tick the FlexNet License Manager option on the page, Choose Install Type. This will give you the opportunity to enter the location of the network license server on a subsequent step. There are two install methods that can be used to install SPEED:

Express Install (requires a license file) 1. License Notice: read the agreement and choose to accept. Click Next to continue. 2. Choose Installation Method: select the Express (Recommended) option. This will install all SPEED features and related components. It will also install the license manager using default settings. This is the recommended option for most users. Click Next to continue. 3. Setup Licensing: this will appear if no existing licensing information is found on the target machine. If you require a license file, you should obtain this from CD-adapco after obtaining the necessary host id. The host id must be supplied to CD-adapco in order to generate the license file. Browse to the license file and when complete click Next. 4. Pre-Installation Summary: this screen will show a summary of what will be installed on your machine. Click Next to proceed with the installation. 5. Installing: this screen will show the current progress of the installation process. 6. Install Complete: a final screen will be presented to indicate the completion of the SPEED installation process. If any errors where encountered during installation a message will appear here prompting to check the installation log file.

Custom Install 1. License Agreement: read the agreement and choose to accept. Click Next to continue. 2. Choose Installation Method: select the Custom (Advanced) option. This will allow users to select which SPEED features and related components will be installed. This option will also allow the user to configure and start the license manager. This is the recommended option for advanced users. 3. Choose Install Type: this screen presents the components available for installation on your system. Once the desired components have been selected click Next The options available are listed below: a. SPEED and related components: i. Install SPEED on this machine or a network location: this will install SPEED on the current machine or on a location of your choice. b. FlexNet License Manager: choosing this option will provide two further options in a subsequent step where you can choose to either use an existing license server on the network, or to install and configure a FlexNet license server on the host machine. Please note that if this setting is not selected then the license server will have to be setup manually. See the licensing guide below. 4. Choose License Type: select the method that you would like to use and click Next. a. Network: this will configure the machine to access a network license server. If you choose this option please follow the first step below.

i. FlexNet Client Configuration: enter the hostname and port number of your organization's license server using the format: port@host. Additional redundant servers can be added if your network has been set to support this. Click Next to continue. b. Local: this will install and configure FLEXNet publisher on this machine. If you choose this option please follow the relevant steps below. i. FlexNet License Server Configuration: here you can change the Web Port Number and License Port Number if necessary. Otherwise you can keep the default values and click Next. ii. Select license file: browse to the license file which you should have previously received from CD-adapco via e-mail and downloaded onto your computer. When complete click Next. iii. Service Configuration: this will configure the License Manager service. A default name is already provided. If this service already exists please modify the name. If Start license server now is selected the license server will automatically be started. Click Next to continue. 5. Select Install Location: click Next to accept the default location for the SPEED installation, otherwise enter a custom directory location. 6. Select Additional Tasks: tick the boxes next to the additional tasks you wish the installer to perform: a. Update Windows firewall to allow SPEED to run: the Windows firewall may attempt to block communication between the client and server of SPEED. If this option is selected the installer will add a rule to permit the communication. b. Create a desktop icon. c. Create shortcuts for current user only. This will only create shortcuts to CD-adapco products for the current user. 7. Pre-Installation Summary: this screen will show a summary of what will be installed on your machine. Click Next to proceed with the installation. 8. Installing: this screen will show the current progress of the installation process. Note that you will see additional windows appearing during the installation process, depending on the selections that have been made. In particular, if you have chosen to install the bundled Java JDK, you will be presented with windows from the Java Installer. You should respond to the prompts as appropriate. 9. Start a browser: this page will appear if you selected the Local license option in the Choose License Type step. If Start browser now is selected a web browser will launch and display the license details in LMAdmin. If this is not required then click Next without changing anything. 10. Install Complete: a final screen will be presented to indicate the completion of the SPEED installation process. If any errors where encountered during installation a message will appear here prompting to check the installation log file.

11. You may need to restart your system, click Done when ready.

Finding the Log Files The package installer will create a log file (SPEED_2012_InstallLog_xxx.log) in your SPEED installation directory. The information contained in the log file is technical in nature, but may be of use when contacting CD-adapco support about installation problems. Note that the log file is only visible after you have clicked the Finish button and the installer has closed down.

Running
This section provides information on running SPEED.

Starting SPEED After installation a CD-adapco folder will have been added to the All Programs list in the Start menu. This will contain a folder called SPEED 2012 which will contain icons to launch SPEED. A SPUD 2012 icon may also appear on the desktop.

Uninstalling
The SPEED package can be uninstalled using the Add/Remove Programs panel, which is accessed by selecting Control Panel > Add/Remove Programs from the Start menu. (In Windows 7, type Add or Remove Programs in the Start menus search field and press <Enter>). In the dialog that appears, scroll down to the CD-adapco SPEED 2012 entry and click the Change/Remove button (for Windows 7 this will be called Uninstall). Do not uninstall the individual components from this panel as that could confuse the package uninstaller. The uninstaller will automatically detect what was installed and begin with a wizard page showing you what has been found. If you encounter an out of memory error whilst uninstalling, visit the Increasing the Java Heap Size section for information on how to resolve this.

Increasing the Java Heap Size

You may receive an out of memory error when uninstalling SPEED. An example error message is shown below: Invocation of this Java Application has caused an InvocationTargetException. This application will now exit. (LAX) Stack Trace:java.lang.OutOfMemoryError: Java heap space To fix this: Navigate to the uninstallation directory of SPEED: [DIR]/2012/Uninstall_SPEED 2012 where [DIR] is the installation directory you used during installation. Locate and open the Uninstall SPEED 2012.lax file with a text editor of your choice Locate the following line in the .lax file: lax.nl.java.option.java.heap.size.max=250331648 (the value in your file may be different) Increase the value Save the changes you made Retry the uninstallation

Setting Up Licensing
CD-adapco products use the FLEXnet Publisher Licensing Toolkit 11.9 from Flexera Software to manage end-user licensing. The basic setup for a floating license configuration with a single license server is covered initially. This includes: Getting the server host ids Launching the license server Importing a new license file Checking the status of a license file Upgrading to a new version of FLEXnet Setting up Client Machines

Further sections are also provided. The CD-adapco specifics section gives additional information on: Which licenses are checked out by the various CD-adapco products The vendor daemon name What CD-adapco specific environment variables are available

Understanding the basics of licensing at the end of this section provides a more technical overview of FLEXnet licensing system: The components that make up the licensing system How the request process works Setting up redundant server systems Format of the license file Specifying the license file location

Latest versions of the daemon and utility programs and end user manual can be found on the Flexera website.

Setting up a Single Server Floating License

This section describes the steps necessary to set up a basic floating license configuration using a single server. 1. Stop the existing license server if it is running. 2. Select the machine on which the license server is to run. This will be referred to as the license server host. Guidance on how to choose an appropriate machine can be found in the License Administration Guide (FLEXlm_enduser_11_9.pdf copied to the FLEXnet utilities directory during installation 3. If this machine is not the one used during the previous installation steps, or if the FLEXlm 11.9 Utilities were not selected during installation, it will be necessary to re-run the SPEED installer on this machine and choose to install the FLEXlm 11.9 Utilities. On Windows, these utilities will typically be installed in C:\Program Files\CD-adapco\FLEXlm\11.9. 4. Get the host id of the license server host. This is a unique identifier that the CD-adapco licensing department will use to generate the license file for the license server. The section, Getting the Server Host IDs below provides details on how to do this. When you have the necessary information, email it to your CD-adapco sales representative and wait for the license file to be returned.

5. When received, copy the license file to your system, typically into the same directory where you installed the FLEXlm 11.9 Utilities (see Step 3). 6. The license server can now be configured and launched. Follow the instructions in the section, Launching the License Server. 7. With the license server running, it will now be possible to set up each client machine to point to the license server and so begin using your CD-adapco products. Follow the instructions in the section, Setting up Client Machines. For more complex licensing arrangements, such as managing license files from multiple vendors, refer to the Flexera License Administration Guide.

Getting the Server Host IDs

The FLEXlm 11.9 Utilities include a software tool that will find the host id of the license server host. If you need to find the host id before installing the CD-adapco products, download the lmutil utility from the Flexera download site and run it from the command line using the lmhostid command. For Windows, enter the following in the command line: [PATH]\lmutil.exe lmhostid The output will display a message similar as shown below: The FLEXNet host ID of this machine is 00221916xa5a Send this information along with the host name of the machine to your sales representative who will arrange for a custom license file to be sent to you. If you require an alternative to lmhostid, use the appropriate command as described in Chapter 6 of the Flexera License Administration Guide.

Obtaining the Host ID Using lmadmin If you have installed the lmadmin administration utility on the machine that will be acting as a server, you can determine the host ID by following the steps outlined below: 1. Launch a web browser and enter http://localhost:8080/ in the address bar. 2. Click on the Administration tab located at the top right of the panel, as shown below.

The Sign In dialog appears. If this does not appear, ensure that your pop-up blocker is not blocking this page. 3. Enter admin as both the User Name and Password.

4. Click Submit to continue. 5. The System Information tab appears by default. All the required information is displayed on this page and can be saved in a html file or copied and pasted into a text file.

6. E-mail or fax this information to your sales representative, who will arrange for a custom license file to be sent to you. 7. When you receive the license file, copy it to the directory where the FLEXnet utilities are stored. On windows, this will typically be C:\Program Files\CD-adapco\FLEXlm\11.9.

Launching the License Server

Typically you want the license server to start every time the license server host machine is restarted.

Starting the License Server on Windows 1. In a typical case, the license server will be set as a service in the Windows Services control panel during the installation process. The service name is CD-adapco License server, (unless a custom name was chosen during installation), and is automatically started when the machine is turned on. 2. To manually start or stop the server in Windows XP, click on Start and select Run. In the Run window, type services.msc and press <Enter>. For Windows Vista and Windows 7, enter services.msc in the search field located in the Start menu, and press <Enter>. 3. In the Services window, locate the service: CD-adapco_License_server 4. Right-click on the service and select Start.

Stopping the License Server

The license server will require stopping if you are upgrading it or if you want to remove it. Stopping the License Server on Windows The default service name for the CD-adapco license server is CD-adapco_License_server. If you used a different name when installing SPEED, locate and stop that service. 1. For Windows XP, click on Start and select Run. In the Run window, type services.msc and press <Enter>. For Windows Vista and Windows 7, enter services.msc in the search field located in the Start menu, and press <Enter>.Run services.msc as described in the previous section. 2. In the Services window, locate the service: CD-adapco_License_server 3. Right-click on service and select Stop. Alternatively, you can stop the server using lmadmin and your web browser.

Stopping the License Server Using lmadmin and Your Web Browser 1. Launch a web browser and enter http://localhost:8080/ in the address bar. 2. Click on the Administration tab located at the top right of the panel, as shown below.

The Sign In dialog appears. If this does not appear, ensure that your pop-up blocker is not blocking this page.

3. Enter admin as both the User Name and Password.

4. Click Submit to continue. 5. The System Information tab appears by default. Click on the Server Configuration tab on the left-hand side of the page. The Server Configuration page appears.

6. Click on the Stop Server button. A dialog appears warning you that the license server will be stopped and will not be able to be started from the web browser.

7. Click OK to stop the server.

Importing a New License File

To import a new license file (or to overwrite a license file that has expired) using lmadmin, follow the steps outlined below: 1. Launch a web browser and enter http://localhost:8080/ in the address bar. 2. Click on the Administration tab located at the top right of the panel, as shown below.

The Sign In dialog appears. If this does not appear, ensure that your pop-up blocker is not blocking this page. 3. Enter admin as both the User Name and Password.

4. Click Submit to continue. The System Information tab appears by default. 5. Click on the Vendor Daemon Configuration tab on the bottom left of the page. The Vendor Daemons page appears. The daemons running on this license server are listed here. The daemon for CD-adapco products is cdlmd.

6. Click on the Import License button to import a new license file. The Import License File page appears.

7. Click on Browse... and select the license file you want to add to this server. If you would like to overwrite the existing license file, tick the Overwrite License File on License Server checkbox. 8. Click on Import License to complete this operation. A summary page appears informing you of the changes, as shown below.

The license file will be copied to the FLEXlm folder of the SPEED installation directory: [INSTALLATION PATH]\CD-adapco\FLEXlm\11_9_1_0\bin \licenses\cdlmd Note that if you used the license file during the installation process, then this will be copied to the default FLEXlm directory.

Checking Vendor Daemon Information To check the information on the CD-adapco vendor daemon, cdlmd, follow the steps outlined below. 1. Navigate to the Vendor Daemons page by clicking on the Vendor Daemon Configuration tab. 2. Click on the cdlmd daemon. The vendor daemon information page appears, as shown below.

Here, you can see which license files (and their location) are used by the daemon. You can also start and stop the vendor daemon, as well as reread the license files. Remember to click on Save if you have made any changes that you would like to keep.

Setting up Client Machines

Each client that needs to access the license server needs to know the hostname and port number of the license server. There are a number of ways to provide this information on each client, but the simplest are as follows: For Windows, create an environment variable called CDLMD_LICENSE_FILE and set its value to the port@server for the license server. This can be achieved on Windows XP and Windows Vista as follows: o Windows XP: open the Control Panel, double-click the System icon, select the Advanced tab and click the Environment Variables button. The Environment Variables dialog will appear. In the System Variables section of the dialog, click New and enter the variable properties. The Variable name should be set to CDLMD_LICENSE_FILE and the Variable value should be given in the form port@server. Click OK on the New System Variable dialog to save the variable. Click OK on the Environment Variables dialog to close it.

Windows Vista: open the Control Panel, double-click the System icon (assuming Classic View is chosen) and choose Advanced System Settings from the Tasks lists on the left side. In the System Properties dialog that appears, click the Environment Variables... button. The Environment Variables dialog will appear. In the System Variables section of the dialog, click New... and enter the variable properties. The Variable name should be set to CDLMD_LICENSE_FILE and the Variable value should be given in the form port@server. Click OK on the New System Variable dialog to save the variable. Click OK on the Environment Variables dialog to close it.

Checking the Status of Licenses

To check the status of the licenses using lmadmin, follow the steps outlined below: 1. Launch a web browser and enter http://localhost:8080/ in the address bar. The lmadmin utility appears. The Dashboard tab is displayed by default. 2. Click on the Concurrent button to display all the registered licenses, as shown below.

A table containing information on each license feature is displayed. A description of each column is given below: Feature - displays which features the license contains. Version - displays the version of the license feature. In Use (Available) - displays the number of licenses that are currently in use (out of the total available). Expiration - displays the date when the license will expire.

Notifications about the licenses will appear on the left side of the web page. Critical issues can be seen by clicking on the red hexagon; important issues can be seen by clicking on the yellow triangle.

Upgrading the FLEXlm License Server

The best approach to upgrading a FLEXlm license server is to prepare a script that will perform the necessary actions, and to run this script immediately after killing the license server processes. Any clients running with checked out licenses should not be adversely affected if the changeover is done in a sufficiently short space of time (that is, less than two or three minutes). The steps to perform in Linux are as follows: Identify the license server processes (using ps -ef on Linux, and the Task Manager on Windows). On Linux this is identified as lmadmin, and on Windows it is identified as lmadmin.exe Kill the processes (using kill -9 on Linux, and by right-clicking each process and choosing End Process Tree in the Task Manager on Windows). Run a script that will: o Rename the existing components (lmadmin, cdlmd and lmutil) to something different for safe-keeping. o Copy the new components into the same location as the previous components. o Restart the license server.

An example series of commands on Linux would be: Finding and killing the running license server process:

ps -ef | grep lmadmin kill -9 <insert PIDs from previous command> Contents of script to perform remaining actions: mv lmadmin lmadmin.old mv cdlmd cdlmd.old mv lmutil lmutil.old cp <source path>/lmadmin ./lmadmin cp <source path>/cdlmd ./cdlmd cp <source path>/lmutil ./lmutil ./lmadmin +l logfile.txt -c license.dat A similar series of DOS commands could be created on Windows. For more information refer to Chapter 9 of the Flexera License Administration Guide

Alternatively on Windows you can do the following: For Windows XP, click on Start and select Run. In the Run window, type cmd and press <Enter>. For Windows Vista and Windows 7, enter cmd in the search field located in the Start menu, and press <Enter>. Enter the following to stop the CD-adapco_License_server service (if you gave the service a different name you should use that one instead):

sc stop CD-adapco_License_server

Delete the stopped service by entering the following: sc delete CD-adapco_License_server

Install the new version of FLEXlm license server using the provided installation package.

CD-adapco Specifics
This section will help you understand more about the FLEXnet licensing system as used by SPEED and the CAD Clients: Understanding what license features are required for various products. The daemon name that is used in CD-adapco products The environment variables that are available

What Licenses Are Checked Out? The names of the features that are checked out by SPEED are detailed below.

What License Features Are Used by SPEED? Licenses are checked out by SPEED as follows: Each machine design module requires a speedsuite license. PC-FEA requires a pcfea license.

What is the Vendor Daemon Name? The FLEXnet documentation refers to the vendor daemon name. For CD-adapco this is cdlmd. This name is used in the license file and the environment variable CDLMD_LICENSE_FILE is used to locate the license file if set.

What Environment Variables Can I Use? The following variables can be set to adjust the behaviour of the license manager. Unless otherwise stated, setting the variable to 1 will turn the behaviour on, setting it to 0 or not setting it at all will turn it off. STARLICENSELOG When the license routines run, they will write to the file that this is pointing to as well as to standard out. This can be useful if license messages do not appear. This has to be set to the file, for example: c:\>set STARLICENSELOG=c:\log.txt % setenv STARLICENSELOG /tmp/log.txt STARLICENSEVERBOSE Causes more verbose messages to be displayed to both the screen and log file. STARNOFLEXLMRC FLEXnet will not write to HKEY_LOCAL_MACHINE\SOFTWARE\FLEXlm License Manager registry key. STARNOTIMEOUT

FLEXnet normally times out after two hours of inactivity. This means that if a machine crashes with a license checked out, the license will return to the server after this time. In cases where no activity for two hours is normal (a queuing system that suspends a job during the day) then this will release the license and the job may fail to get the license when it progresses (another user may have the license). If this variable is set, FLEXnet will never time-out and so will avoid this. However, you need to be aware that this may cause licenses, which would otherwise be returned, to remain out and so lmremove may need to be used. STARWAIT Normally, FLEXnet will return if a license is unavailable and the code will exit. If STARWAIT is set, then FLEXnet will wait until a license becomes available. This may be of use in queue or batch systems.

Understanding the Licensing System

This section will help you understand more about the FLEXnet system as used by SPEED and the CAD Clients: FLEXnet licensing components The license request process Using server redundancy Understanding the file format Alternative ways to specify license file location

This information is largely a simplified version of parts of the Flexera License Administration Guide.

FLEXnet Components For served licenses, there are four required FLEXnet components: The CD-adapco application, with the FLEXnet static client library linked into it The License File (license.dat) The License Server Manager (lmadmin) The CD-adapco daemon (cdlmd)

The last two components comprise the license server system. In addition to these four FLEXnet components, there are three optional components that you can configure: Debug Log File, created and written by lmadmin Report Log File, created and written by cdlmd for use by FLEXnet Manager End-User Administration Options File, created and maintained by you

The diagram below shows the relationship between these components, which are expanded upon in the Component Overview.

Typically, the license server system components (lmadmin and cdlmd) reside on a machine in the network but can optionally reside on the same machine as the CD-adapco applications.

Component Overview The License Server Manager (lmadmin) The license server manager (lmadmin) handles the initial contact with the CD-adapco applications, passing the connection on to cdlmd. It also starts and restarts cdlmd. To configure lmadmin, use a web browser of your choice.

The CD-adapco Daemon (cdlmd) Counted (floating) licenses are granted by cdlmd, which keeps track of how many licenses are checked out, and who has them. CD-adapco applications communicate with cdlmd, through TCP/IP network communications. The application and the daemon processes (lmadmin and cdlmd) can run on separate machines on your network, across any size heterogeneous wide-area network. This means the license server system and the computer running an application can be different hardware platforms or even different operating systems (Windows and Linux, for example). If cdlmd terminates for any reason, all users lose their licenses, though this does not mean the applications suddenly stop running. Users normally regain their license automatically when lmadmin restarts cdlmd, though they may exit if cdlmd remains unavailable.

The License File Licensing data is stored in a text file (license.dat) called the license file, which is created by CD-adapco, and edited and installed by your license administrator. It contains information about the server machines and CDadapco daemons, and a line of data for each CD-adapco feature. One product may have multiple features to access different aspects of the application, or a product may look for one of several features before starting Typical content of a license file is covered in the format overview, and there are multiple ways of specifying the location of the license file.

The FLEXenabled CD-adapco Product SPEED and the CAD Clients are linked with the FLEXnet Licensing client library that provides the communication with the license server system (lmadmin and cdlmd). During execution, the application communicates with cdlmd to request a license.

FLEXnet Licensing Components Shipped by CD-adapco The following table provides a list of the essential components we supply:

Component Windows Linux lmadmin lmadmin.exe cdlmd.exe cdlmd lmutil.exe lmutil

Description Required for served license models-- the license server manager and vendor daemons. Optional component. FLEXnet Licensing utilities program. Used for license server system management and administration. Also available from http://www.flexera.com/.

How Does The License Request Process Work? When you run a counted (floating) CD-adapco product, the following occurs: 1. The license module in the CD-adapco application finds the license file, which includes the host name of the license server machine and TCP/IP port number of the license server manager, lmadmin. 2. The application establishes a connection with the license server manager (lmadmin) and tells it that it needs to talk to cdlmd. 3. lmadmin determines which machine and TCP/IP port correspond to cdlmd and sends that information back to the FLEX enabled application. 4. The CD-adapco application establishes a connection with cdlmd and sends its request for a license. 5. cdlmd checks in its memory to see if any licenses are available and sends a grant or denial back to the application. 6. The license module in the application grants or denies use of the feature or entire application, as appropriate. After successfully checking out a license, SPEED spawns a threaded heart beat which is essentially a tiny process that fires a signal to the license server every 2 minutes to say that SPEED is alive. If the license server doesnt hear from SPEED in 5 minutes then the license server assumes that SPEED is dead and retracts the license. Conversely, if there is no acknowledgement from the license server (as would happen if the server failed or was stopped), the SPEED client will note the time and keep trying for 1 hour. SPEED will stop iterating if no response is received by then. When this happens the user will still be able to save results and exit, but he or she will not be able to start iterating again until a license is found.

Using Redundant License Servers As with all computer systems, it is impossible to ensure that any specific computer is available all the time, and this may result in license denial if the license relies on a single computer. To address this issue, CD-adapco supports redundant license servers which means that a number of computers are involved in the license server process and the process is tolerant to some of the servers being down.

Using the Three-Server Redundancy Approach With three-server redundancy, the server is in fact three machines. As long as any two of the three servers are up, they have a quorum and can issue licenses. This is a good system for a single site and has the advantage that even if one of the triad is down, the full number of licenses are still available. This has been supported since the first release of SPEED with FLEXnet and is a standard FLEXnet option.

Using a Simple License File List With a simple license file list, there is a list of servers, so maybe one in London, one in Detroit and one in Tokyo. When the license is checked out, each server is tried in turn on the list. Typically users in London will check out from the London server but if the London server is down, they can check out from another server on the list. This is a good system for multiple sites but has two disadvantages: 1. When one machine is down, the pool of licenses is reduced. So if each machine has 10 copies of SPEED, when London is down, there are only 20 copies of SPEED to share between three sites instead of 30. 2. If a dead machine has a unique feature, applications will not be able to run. 3. By default, once a job has successfully checked out a license from one server, all subsequent checkouts must be satisfied from the same server. If the application requires more than one license, this could result in a license denial when the license is available on another server. This also means that even with 30 copies of SPEED, the largest single job can only use a maximum of 10. This has been supported since the first release of SPEED with FLEXlm and is a standard FLEXnet option.

Using an Enhanced License File List To address point 3 of the simple license file list, the license routines have been recoded so that each license request is fullfilled by one or more FLEXnet jobs. The advantage of this is that each FLEXnet job can be from a different server, so an application can mix and match license requests across the whole license file list. This is a CD-adapco specific development and is supported by license codes dated 09-Oct-2004 or later.

Setting up a Two Server Fail Over Mechanism Using an example of two license servers (this example uses Star-CCM+ instead of SPEED): 1999@offal with 2 hpcdomains 1999@heraclitus with 1 ccmpsuite and 1 hpcdomain

and starting a simulation using -np 4: Starting local server: /users/install2/starccmplus/SPEED2.10.013/star/bin/starccm+ -env gnu4.2 -server -np 4 /offal2/philip/polymanifold/polymanifold.sim Starting Star-CCM+ parallel server Master Node[0]@offal.cd.co.uk process 19267 (MPICH-1.2.5:TCP/IP) Star-CCM+ Version 2.10.013 (linux-x86_64-2.2.5/gnu4.2) License version 13-sep-2006 ... Checking license file: 1999@offal Checking license file: 1999@heraclitus 1 copies of ccmpsuite checked out from 1999@heraclitus Feature ccmpsuite expires in 45 days Server::start offal.cd.co.uk:41999 Loading simulation database: /offal2/philip/polymanifold/polymanifold.sim

Loading module: KeTurbModel ... 2 copies of hpcdomains checked out from 1999@offal Feature hpcdomains expires in 258 days 1 copies of hpcdomains checked out from 1999@heraclitus Feature hpcdomains expires in 45 days Partitioning from Serial into 4 partitions... Star-CCM+ succeeded because of the fail over mechanism which allows it to build up its total request over a number of servers.

Understanding the Floating License File Format This section provides details of the most common options in a typical license file provided by CD-adapco. The full reference can be found in Chapter 8 of the Flexera License Administration Guide. License files usually begin with a SERVER line followed by one or more VENDOR lines, followed by one or more FEATURE lines. An example of a license file that provides floating licenses is: SERVER lulu 17007ea8 1999 # If the following is uncommented, none of the following lines will be processed # USE_SERVER # you may need to append the full path to cdlmd if it is not on you path # e.g. VENDOR cdlmd /usr/star/version/license/cdlmd VENDOR cdlmd FEATURE speedsuite cdlmd 1.0 15-jan-2005 20 24D76447DB45 \ vendor_info=3722006928dd6ae3e1d6501005a96cd75fe0f1c50c8340ba31237cd6579dc1 6989fda96607caef3f5f8d3d352c831afa9a54ac80d89d91cc4744a6d808857a68313b3c55 bbad5f72b629a42d941a3f12a0289a This license file specifies that: 20 licenses for speedsuite are available anywhere on the network that can access the license server machine lulu. lmadmin uses the TCP/IP port 1999. You can modify the following elements in the license file: Host names on the SERVER line(s) TCP/IP port numbers on the SERVER line(s) Paths on the VENDOR line(s) Options file paths on the VENDOR line(s) Optional TCP/IP port numbers on the VENDOR line(s) for firewall support only USE_SERVER line

Values in keyword=value pairs on FEATURE lines, if keyword is specified in lowercase, except vendor_info.

SERVER Lines The SERVER line specifies the host name and host id of the license server system and the TCP/IP port number of the license server manager (lmadmin). Normally a license file has one SERVER line. The absence of a SERVER line means that every FEATURE line in the license file is uncounted. The host ids from the SERVER lines are computed into the license key or signature on every FEATURE line. For this reason, make sure you keep SERVER lines together with any FEATURE lines as they were sent from the vendor. The format of the SERVER line is: SERVER host hostid [port] [PRIMARY_IS_MASTER] [SERVER_TIMEOUT=seconds] where: host is the system host name or IP address. A string returned by the Linux hostname or uname -n command. On NT/2000/XP, ipconfig /all; on Windows 95/98/ME, winipcfg /all return the host name. hostid is usually the string returned by the lmhostid command. This is set by CD-adapco. port is the TCP/IP port number to use. A valid number is any unused port number between 0 and 64000. On Linux, choose a port >1024, since those less than 1024 are privileged port numbers. If no TCP/IP port number is specified, one of the default ports in the range of 27000 and 27009 is used. Flexera recommends using port numbers outside the range of 27000 through 27009.

VENDOR Lines The VENDOR line specifies the daemon name and path. lmadmin uses this line to start the vendor daemon, and the vendor daemon reads it to find its options file. The format of the VENDOR line is shown below. VENDOR vendor [vendor_daemon_path][[OPTIONS=]options_file_path] [[PORT=]port] where: vendor Name of the vendor daemon used to serve some feature(s) in the file. This name cannot be changed by the administrator. vendor_daemon_path is an optional path to the executable for this daemon. Generally the license administrator is free to install the daemon in any directory. (It is recommended, however, that it be installed in a local directory on the license server machine.) If omitted, lmadmin looks for the vendor daemon binary in: o The current directory o The path specified in lmadmins $PATH environment variable o in the directory where lmadmin is located

If vendor_daemon_path is blank, then any options or TCP/IP port number specifications require the OPTIONS= and PORT= strings. options_file_path is the full path to the end-user options file for this daemon. FLEXnet does not require an options file. If omitted, the CD-adapco daemon looks for a file called cdlmd.opt located in the same directory as the license file. port is the vendor daemon TCP/IP port number. The default, if port is not specified, is chosen by the operating system at run-time. Sites with Internet firewalls need to specify the TCP/IP port number the daemon uses. If a TCP/IP port number is specified on the VENDOR line, there may be a delay restarting the vendor daemon.

USE_SERVER Line USE_SERVER takes no arguments and has no impact on the server. When the application sees USE_SERVER, it ignores everything in the license file except preceding SERVER lines and transfers checkout validation to the vendor daemon. USE_SERVER is recommended since it improves performance when a license server system is used.

FEATURE Lines A FEATURE line describes the license required to use a product. Only the first FEATURE line for a given feature is processed by the cdlmd. The basic FEATURE line format is: {FEATURE} feature vendor feat_version exp_date num_lic [optional_attributes] The six fields after the FEATURE line keyword are required and have a fixed order: feature Name given to the feature by the vendor. vendor Name of the vendor daemon; also found in the VENDOR line. The specified daemon serves this feature. feat_version Version of this feature that is supported by this license. exp_date Expiration date of license in the format dd-mmm-yyyy, e.g., 07-may-2005. If exp_date is the string permanent or the year is 0 (or 00, 000, 0000) then the license never expires. num_lic is the number of concurrent licenses for this feature. vendor_info= is additional information provided by CD-adapco. vendor_info=...

Specifying the License File Location

The license server needs to know where the license file is located and it will look in a number of places. The FLEXenabled CD-adapco software will also look in these locations to find the path to the license server (or to use the license file directly in the case of node-locked licenses). A default location for a file in one of 2 formats o Full license file

o use_server format The value of an environment variable (LM_LICENSE_FILE or CDLMD_LICENSE_FILE) that can be specified in two ways: o A regular environment variable o The content of a file (Linux) or registry key (Windows) in the VARIABLE=value format

Using the Default Location On Windows the default location for the license file is: C:\Program Files\FLEXnet Publisher License Server Manager\licenses\cdlmd\license.dat The license.dat file can be in one of two formats: The full license file as received from CD-adapco A pointer to a license file on the license server using the format: SERVER server hostid port USE_SERVER where hostid is the same as the hostid in the original license file

Using Environment Variables The environment variable can be defined in a number of ways: On Windows Using the set command at the command line Setting a variable using Start > Settings > Control Panel > System > Advanced > Environment Variables dialog Defining a key in the HKEY_LOCAL_MACHINE\SOFTWARE\FLEXlm License Manager registry branch, where the variable will be the name of the key and the value will be stored in the value of the key

In addition to the multiple ways of setting up the environment variable, there are two variables that can be used to hold a value pointing to the license file: LM_LICENSE_FILE CDLMD_LICENSE_FILE All these environment variables will take the form: VARIABLE=value where VARIABLE is one of the two options above and value can be the pointer to the license file in one of three formats: A directory containing one or more license files with a.lic extension

The full path to the license file A port@host setting, where port and host are the TCP/IP port number and host name from the SERVER line in the license file

For backward compatibility, CD-adapco products also recognize the STAR_DIR environment variable expecting to find a license file at: $STAR_DIR/license/license.dat See Managing Multiple License Files for more information about LM_LICENSE_FILE and Appendix D, FLEXnet Licensing Environment Variables in the FLEXnet End User Guide for more information.

What if More Than One Method is Used? If you use more than one of the methods mentioned in the previous two sections to point to a license file, then all of the files will be scanned, and the CD-adapco product will scan all the options in the following sequence and check out the first valid license: The CDLMD_LICENSE_FILE environment variable The CDLMD_LICENSE_FILE registry entry The LM_LICENSE_FILE environment variable The LM_LICENSE_FILE registry entry The STAR_DIR environment variable The default directory location

Getting Support
When you need additional help with using SPEED, you can first check the Knowledge Base category on the User Services site for any articles relating to your problem. The Knowledge Base contains a search function for searching through articles, along with a wide range of SPEED Support Videos. Knowledge Base articles and videos cover a wide range of topics, and you may find that your question has already been answered. The User Services site can be found at:https://support.cd-adapco.com/ The screenshot below shows the Home page of the User Services site. Use the categories on the left-hand side to switch between different areas of the site.

If the Knowledge Base does not provide the help you need, please contact your local CD-adapco support office. Contact information can be found at http://www.cd-adapco.com/about/locations.html. It will help your CD-adapco representative if you have prepared appropriately for reporting the issue. Further sections to help you do this are: Gathering information on the issue Preparing an e-mail message for support

Gathering Information on the Issue Accurate information is vital for dealing with your issue effectively. Your affected simulation file, if you can provide it, would be a key source of this information. However, due to the large size of the file, the best way to send it is via FTP (file transfer protocol). Discuss the details of this file transfer with your local CD-adapco support contact.

Preparing an E-Mail Message for Support This section describes a recommended format for your e-mail message to CD-adapco support. Please include as much of the requested information as possible.

To: [your local CD-adapco support office] Subject: [Type of issue, for example Failure to converge] To whom it may concern: I have observed a functionality issue in SPEED's [add the SPEED design module PC-BDC, PC-IMD etc.] Version X.XX.XXX [add the full version number, which is available from the Help > About menu item]. [If you have a separate file generated, attach it and state:] Attached please find the file [filename].log. [Or, paste any clipboard text after this introduction:] The error message I received was as follows: ... This error message appeared after the following steps: [Describe in detail the steps you took before the error message appeared. To ensure accuracy, try repeating the steps after you finish listing them.] * Step 1 [For example, loaded the example file] * Step 2 [For example, changed Rad3 to 95] * Step 3 [For example, ran a dynamic design] * ... If you need any additional information, please let me know.

Sincerely,

CD-adapco 2012