Installation Guide en
Installation Guide en
Installation Guide en
FLUxX 10
Installation guide
Copyright CEDRAT
FLUX Quality Assessment: Application 2D : EDF standards, registered number AQM1L002 Application 3D : EDF standards, registered number AQM1L013
CEDRAT 15 Chemin de Malacher - Inovalle 38246 MEYLAN Cedex France Phone: +33 (0)4.76.90.50.45 Fax: +33 (0)4.56.38.08.30 Email: cedrat@cedrat.com Web: http://www.cedrat.com
FLUX10
TABLE OF CONTENTS
TABLE OF CONTENTS
1. Foreword ................................................................................................................................1 2. Required configuration .........................................................................................................3 2.1. Operating systems..........................................................................................................4 2.2. Required configuration for Flux 2D applications.............................................................5 2.3. Required configuration for Flux 3D applications.............................................................7 2.4. 3GB mode (4GT RAM tuning mode of Windows) with Flux ...........................................9 3. Protection system................................................................................................................11 3.1. Protection system .........................................................................................................12 3.2. Nodelocked license ......................................................................................................12 3.3. Network license ............................................................................................................13 4. Single computer installation...............................................................................................15 4.1. Flux Version 10 installation...........................................................................................16 4.2. Nodelocked license installation ....................................................................................20 4.3. Network license installation ..........................................................................................21 5. Network installation.............................................................................................................23 5.1. Definitions.....................................................................................................................24 5.2. License server installation, configuration and startup on Windows ..............................25 5.3. License server installation, configuration and startup on RedHat Enterprise Linux .............................................................................................................................30
5.3.1. 5.3.2. 5.3.3. 5.3.4. 5.3.5. 5.3.6. Introduction .....................................................................................................................30 USB key driver installation..............................................................................................31 License server installation ..............................................................................................32 License server configuration...........................................................................................34 License file configuration ................................................................................................35 Starting the license server ..............................................................................................36
5.4. Flux installation and configuration ................................................................................37 6. Documentation and examples............................................................................................39 6.1. Installation of the documentation and examples ..........................................................40 6.2. Access to the documentation and examples ................................................................44 7. Download and installation of patch ...................................................................................47 8. Annexes................................................................................................................................49 8.1. Manual configuration of the license server ...................................................................50 8.2. Troubleshooting............................................................................................................54
INSTALLATION GUIDE
PAGE A
TABLE OF CONTENTS
FLUX10
PAGE B
INSTALLATION GUIDE
FLUX10
Foreword
1.
Foreword
Introduction
This foreword describes the CD-ROMs provided with Flux Version 10.
For Flux Version 10, we provide two CD-ROMs: A CD-ROM named Installation allowing installing Flux, as well as the tools to install the license. A CD-ROM named Documentation allowing to access and/or install documentation and the Flux examples.
INSTALLATION GUIDE
PAGE 1
Foreword
FLUX10
PAGE 2
INSTALLATION GUIDE
FLUX10
Required configuration
2.
Required configuration
Introduction
Contents
This chapter covers the following topics: Operating systems Required configuration for Flux 2D applications Required configuration for Flux 3D applications
INSTALLATION GUIDE
PAGE 3
Required configuration
FLUX10
2.1.
Operating systems
Introduction
This section presents the operating systems compatible with Flux V10.
Operating systems
Flux is guaranteed on the following operating systems: Windows 2000 Professional Windows XP Professional (32 or 64 bits) Windows Server 2003 (32 or 64 bits) Windows Vista (32 or 64 bits) Flux is no longer supported on the following operating systems: Windows 95 Windows 98 Windows ME Windows NT Workstation
PAGE 4
INSTALLATION GUIDE
FLUX10
Required configuration
2.2.
Introduction
This section describes minimum and recommended configurations for Flux 2D applications.
To run the Flux 2D applications on a computer, the minimum requirements are: Element Processor Characteristics Intel or AMD 32 or 64 bits mono core or multi core Hard disk RAM 10 Go 1 Go
Memory
Screen 1024 x 768 pixels Graphics card Mouse Microsoft compatible (with a wheel)
2D recommended configuration
To run the Flux 2D applications on a computer, the recommended configuration is: Element Processor Characteristics Intel or AMD 32 or 64 bits mono core or multi core Hard disk 32-bit operating systems 64-bit operating systems 30 Go 2 Go 4 Go
Memory RAM
Screen 1280 x 1024 pixels Graphics card latest, OPENGL V2.0 compatible for the use of new graphics technology (see details on next page) with 512 MB of memory (NVIDIA chipset recommended) Mouse Microsoft compatible (with a wheel)
Continued on next page
INSTALLATION GUIDE
PAGE 5
Required configuration
FLUX10
Graphics card
To improve the display speed, Flux 10 makes use of a new technology for the graphics interface. This new technology allows for an improved display and acceleration of the graphic representation when moving the device in the graphic zone. This technology requires the use of a recent graphics card: graphics card compatible with OPENGL V2.0. A summary of the conditions of use is presented in the table below. Conditions of use Installation of a graphics card compatible with OPENGL V2.0: NVIDIA GeForce 6200 and subsequent ones ATI Radeon X1300 and subsequent ones Installation of the latest version of the card driver Activation of the graphic acceleration: In the Displaying properties box choose the option Parameters and click on the Advance button In the Properties of Graphics Card Name box choose the option Service and in the Hardware acceleration zone move the cursor to the right in the Complete position
Note: INTEL graphics cards do not support OPENGL V2.0
PAGE 6
INSTALLATION GUIDE
FLUX10
Required configuration
2.3.
Introduction
This section describes minimum and recommended configurations for Flux 3D applications. To run the Flux 3D applications on a computer, the minimum requirements are: Element Processor Characteristics Intel or AMD 32 or 64 bits mono core or multi core Application Hard disc RAM General 20 GB 1 GB Transient Magnetic 50 GB 1 GB Steady AC applications 20 GB 2 GB
Memory
Screen 1024 x 768 pixels Graphics card latest, OPENGL V2.0 compatible for the use of new graphics technology (see details on next page) with 256 MB of memory (NVIDIA chipset recommended) Mouse Microsoft compatible (with a wheel)
3D recommended configuration
To run the Flux 3D applications on a computer, the recommended configuration is: Element Processor Characteristics Intel or AMD 32 or 64 bits mono core or multi core Application Hard disc ( 10 000 turns/min) RAM 32-bit operating systems 64-bit operating systems General 50 GB 2 GB 4 GB Transient Magnetic 100 GB 2 GB 4 GB
Memory
Screen 1280 x 1024 pixels Graphics card latest, OPENGL V2.0 compatible for the use of new graphics technology (see details on next page) with 512 MB of memory (NVIDIA chipset recommended) Mouse Microsoft compatible (with a wheel)
Continued on next page
INSTALLATION GUIDE
PAGE 7
Required configuration
FLUX10
Graphics card
To improve the display speed, Flux 10 makes use of a new technology for the graphics interface. This new technology allows for an improved graphics display and acceleration of the graphical representation when moving the device in the graphic zone. This technology requires the use of a recent graphics card: graphics card compatible with OPENGL V2.0. A summary of the conditions of use is presented in the table below. Conditions of use Installation of a graphics card compatible with OPENGL V2.0: NVIDIA GeForce 6200 and subsequent ones ATI Radeon X1300 and subsequent ones Installation of the latest version of the card driver Activation of the graphic acceleration: In the Displaying properties box choose the option Parameters and click on the Advance button In the Properties of Graphics Card Name box choose the option Service and in the Hardware acceleration zone move the cursor to the right in the Complete position
Note: INTEL graphics cards do not support OPENGL V2.0
PAGE 8
INSTALLATION GUIDE
FLUX10
Required configuration
2.4.
This specific mode has been developed by Microsoft for applications that require more memory than the 2GB limit of standard Windows 32-bit operating systems. With this mode, up to 3GB can be allocated to a process.
This mode is not supported by every Windows operating system. The systems supporting this mode are listed below: Windows Server 2003 Family Windows XP Professional Edition Windows 2000 Data Center Server Windows 2000 Advanced Server Windows NT 4.0 Enterprise Edition Windows Vista
In order to activate the 3GB mode of Windows, you have to modify the boot.ini. The boot.ini file is stored directly in the root of the hard disk drive where Windows has been installed.
Example of boot.ini file without modification:
[boot loader] timeout=30 default=multi(0)disk(0)rdisk(0)partition(1)\WINNT [operating systems] multi(0)disk(0)rdisk(0)partition(1)\WINNT="Microsoft Windows XP Pro" /fastdetect
Activation procedure:
Step 1 2 3
4 5
Action Edit the boot.ini file (located the root of the hard disk drive) using the notepad editor. Copy and paste the last line of this file. In the source line: Add the flag /3GB at the end of this line Change the description of the mode the system will be started. For example: Microsoft Windows XP Pro 3GB instead of Microsoft Windows XP Pro Restart the computer Select the 3GB mode when the computer is restarting
Continued on next page
INSTALLATION GUIDE
PAGE 9
Required configuration
FLUX10
Additional comment: You must have administrative privileges on the machine to perform the modification. The boot.ini file is a hidden file. In order to display it, you have to modify the display options of your Windows Explorer. You must un-check the read only box in the properties of the .ini file before editing it and re-check when the edit is complete or you will be unable to edit this file. (right mouse click on file to edit properties) Activate the 3GB mode on Windows Vista
Step 1 2 3 4
Deactivate the 3GB mode on Windows Vista
Action In the menu Start \ Programs \ Accessories: right-click on Command prompt In the contextual menu: click Run as administrator At the Command prompt: enter BCDEDIT/set increaseuserva 3072 Restart the computer
Step 1 2 3 4
Flux memory settings with the 3GB mode
Action In the menu Start \ Programs \ Accessories: right-click on Command prompt In the contextual menu: click Run as administrator At the Command prompt: enter BCDEDIT/deletevalue increaseuserva Restart the computer
Using the 3GB mode you are now able to allocate up to 2 GB of numerical memory for Flux. Table below shows the memory setting we advice to use for 3D application: Numerical memory Character memory 1700 10 GUI memory 400
PAGE 10
INSTALLATION GUIDE
FLUX10
Protection system
3.
Protection system
Introduction
Contents
This chapter covers the following topics: Protection system Nodelocked license Network license
INSTALLATION GUIDE
PAGE 11
Protection system
FLUX10
3.1.
Protection system
Protection system
Flexnet is the protection system of Flux. Flux Version 10 is provided with the protection system Flexnet Version 11.4.
There are two license types for two operation modes: the Nodelocked license for a use of Flux on a single computer the Network license for a use of Flux in a network
3.2.
Nodelocked license
Definition
The Nodelocked license is compatible with the use of Flux on a single computer.
How to install
Flux and the Nodelocked license are installed on the same computer (see chapter 4).
Supplied components
The following components are supplied for a Nodelocked license: two license files: - one license file for the 32-bit operating system The file name comprises the following character string: NODELOCKED32. - one license file for the 64-bit operating system The file name comprises the following character string: NODELOCKED64 and possibly a USB key.
PAGE 12
INSTALLATION GUIDE
FLUX10
Protection system
3.3.
Network license
Definition
How to install
Flux and the Network license are generally installed on two different computers (see chapter 5). Flux and the license can equally be installed on the same computer (see chapter 4).
Remark for the users who already possess a previous Flux version: Given the fact that Flux Version 10 is provided with the protection system Flexnet Version 11.4, an upgrade to the new Flexnet version is compulsory.
Supplied components
The following components are supplied for a Network license: only one license file that is valid on 32-bit and 64-bit systems. The name of this file comprises the following character string: NETWORK. and possibly a USB key.
In case of a Network license, the license server function is generally ensured by one license server. It is possible to use a system with three redundant servers. This allows functioning which is better protected against blackouts.
INSTALLATION GUIDE
PAGE 13
Protection system
FLUX10
PAGE 14
INSTALLATION GUIDE
FLUX10
4.
Introduction
This chapter presents how to install Flux and the license on the same computer.
Contents
This chapter covers the following topics: Flux Version 10 installation Nodelocked license installation Network license installation
Silent installation
The Flux installer was created by the NSIS software: http://nsis.sourceforge.net/Main_Page The users, who want to perform a silent installation via scripts, can use the command: setup.exe /S /D=rep_install example: setup.exe /S /D=c:\cedrat For more information, refer to the NSIS documentation: http://www.todae.fr/nsis/docs/ (French) http://nsis.sourceforge.net/Docs/ (English)
INSTALLATION GUIDE
PAGE 15
FLUX10
4.1.
Introduction
The new edition of Flux is a completely independent version. It is installed by default in its own directory and is able to coexist with the older versions. The software installation runs automatically.
What is installed
An automatic installation includes the installation of the following components: Flux Version 10 A license server Flexnet, Version 11.4 A tool permitting the installation of the license (License Manager) A USB key driver
Installed components
Components are installed: by default, in the directory: C:\Cedrat in any other directory specified by the user during the installation*. Flux V10.x is installed in the sub-directory Flux_10.x (10.x is the version number). The Flexnet V11.4 license server as well as License Manager is installed in the sub-directory FlexNetServer_11.4.
* The full installation directory path must not include any spaces or special characters
Continued on next page
PAGE 16
INSTALLATION GUIDE
FLUX10
Install Flux
The steps to install Flux Version 10.1 are presented in the table below: Step 0 1 2 Action Log in as administrator Close all the applications in use Insert the Flux Installation CD-ROM into the CD-ROM drive If the CD-ROM drive autoplay function is active, go to step 3 If the CD-ROM drive autoplay function is not active, open Windows Explorer, then click on the CD-ROM drive icon and run the executable file CedratSetup.exe In the installation supervisor window, click on Flux 10.1 to install Flux Version 10.1
INSTALLATION GUIDE
PAGE 17
FLUX10
Step 4
Action In the Flux 10.1 Setup window, click on the Next button to continue installing Flux Version 10.1
Choose a folder to install Flux - By default, Flux is installed in the directory C:\Cedrat - If you want to install Flux in another directory, make sure that the full directory path does not include any spaces or special characters, then: click on the Browse button Click on the Install button to start the installation of Flux Version 10.1.
Continued on next page
PAGE 18
INSTALLATION GUIDE
FLUX10
Step 6
To run Flux V10.1, check the box Run Flux 10.1. (If you do not want to run FluxV10.1, leave the box unchecked) Click on the Finish button to complete the installation. In the installation supervisor window, click on Quit to exit the installation.
INSTALLATION GUIDE
PAGE 19
FLUX10
4.2.
The different steps to install the license, i.e. configure Flux, for a Nodelocked license are detailed in the following table: Step 0 1 Action Log in as administrator If you have a USB key for the license, then you must connect it to the USB port If you do not have a USB key for the license, then go to step 2 Copy the license file (.dat) that you have received by email (from the sales team), on hard disk, for example, to the directory: C:\Cedrat\FlexNetServer_11.4 From the Flux Supervisor: either in the menu Tools, choose the menu License Manager or click on the icon In the License Manager window, select NodeLocked In the License file(s) field, click on the button Add license file In the Select one or more files window: Select the license file (.dat) License file containing Systems the character string 32 bits NODELOCKED32 64 bits NODELOCKED64 Click on the button Open Click on the button Apply Click on the button Quit
4 5 6
7 8
PAGE 20
INSTALLATION GUIDE
FLUX10
4.3.
Introduction
The procedure for the installation of the Network license requires two steps: Step 1 2 Action Configure and start the Flexnet license server Configure Flux
First, it is necessary to configure and start the license server. To do so, refer to section 5.2 Step 2.
Second, it is necessary to configure Flux. To do so, refer to section 5.4 Step 2 (Case of one server).
INSTALLATION GUIDE
PAGE 21
FLUX10
PAGE 22
INSTALLATION GUIDE
FLUX10
Network installation
5.
Network installation
Introduction
This chapter presents how to install Flux and the license on two different computers.
Contents
This chapter covers the following topics: Definitions License server installation, configuration and startup on Windows License server installation, configuration and startup on RedHat Enterprise Linux Flux installation and configuration
Silent installation
The Flux installer was created by the NSIS software: http://nsis.sourceforge.net/Main_Page The users, who want to perform a silent installation via scripts, can use the command: setup.exe /S /D=rep_install example: setup.exe /S /D=c:\cedrat For more information, refer to the NSIS documentation: http://www.todae.fr/nsis/docs/ (French) http://nsis.sourceforge.net/Docs/ (English)
INSTALLATION GUIDE
PAGE 23
Network installation
FLUX10
5.1.
Definitions
Introduction
The Flexnet license server can be installed on a Windows PC a Linux server FluxV10 can only be installed on a Windows PC at the present time.
Definitions
The installation can be carried out in: a homogeneous network when the license server and Flux are installed on Windows computers a heterogeneous network when the license server is installed on a Linux server and Flux on Windows computers
With Flux V10, Flexnet V11.4 license servers are provided for following systems: RedHat Enterprise Linux 3 for i386 architecture RedHat Enterprise Linux 4 for i386 architecture and for x86_64 architecture
PAGE 24
INSTALLATION GUIDE
FLUX10
Network installation
5.2.
Introduction
The procedure for the installation, configuration and start of the license server requires two steps: Step 1 2 Action Install the Flexnet Version 11.4 license server Configure and start the Flexnet Version 11.4 license server automatically (see Remark 1 below)
Remark 1: If you prefer to configure and start the license server yourself, you can do this by clicking on the button Manual License Server Configuration (see section 8.1). Remark 2: In the case of three redundant servers, repeat the procedure for each of the three servers.
An automatic installation includes the installation of the following components: A license server, Flexnet Version 11.4 A tool permitting the installation of the license (License Manager) A USB key driver
Components are installed: by default, in the directory: C:\Cedrat or in any other directory specified by the user during the installation. The Flexnet V11.4 license server as well as License Manager is installed in the sub-directory FlexNetServer_11.4.
Continued on next page
INSTALLATION GUIDE
PAGE 25
Network installation
FLUX10
The steps required to install the license server Flexnet Version 11.4 are detailed in the following table: Step 0 1 2 Action Log in as administrator Close all the applications in use Insert the Flux Installation CD-ROM into the CD-ROM drive If the CD-ROM drive autoplay function is active, go to step 3 If the CD-ROM drive autoplay function is not active, open Windows Explorer, then click on the CD-ROM drive icon and run the executable file CedratSetup.exe In the installation supervisor window, click on Flexnet server 11.4 to install the license server Flexnet Version 11.4
PAGE 26
INSTALLATION GUIDE
FLUX10
Network installation
Step 4
Action In the FlexNetServer 11.4 Setup window, click on the Next button to continue installing the license server Flexnet Version 11.4
Choose an installation folder - By default, the installation directory is C:\Cedrat - You can specify another installation directory, for that: click on the Browse button Click on the Install button to start the installation of the license server Flexnet Version 11.4.
Continued on next page
INSTALLATION GUIDE
PAGE 27
Network installation
FLUX10
Step 6
Check the Run the License Manager box to start the tool License Manager. This enables the license installation. Click on the Finish button to complete the installation. In the installation supervisor window, click on Quit to exit the installation.
PAGE 28
INSTALLATION GUIDE
FLUX10
Network installation
The steps required to automatically configure and start the Flexnet license server are detailed in the following table: Step 0 1 Action Log in as administrator If you have a USB key for the license, then you must connect it to the USB port If you do not have any USB key for the license, then go to step 2 Copy the license file (.dat) that you have received by email (from the sales team), on hard disk, for example, to the directory: C:\Cedrat\FlexNetServer_11.4 In the License Manager window, select Automatic License Server Configuration In the License file field, click on the button In the License file window: Select the license file (.dat) comprising the character string NETWORK Click on the button Open Click on the button Apply Click on the button Quit
3 4 5
6 7
INSTALLATION GUIDE
PAGE 29
Network installation
FLUX10
5.3.
5.3.1. Introduction
Description of the supplied kit
Installation files are located on the Installation CD, in the directory Flexnet_11.4.1_RHEL. These files are:
32-bit architecture Archive files Description cedrat_flexnet-1-0.i386.rpm server for RHEL 3 et 4 provided in rpm format cedrat_flexnet-1-0.i386.tar.gz server for RHEL 3 et 4 provided in tar.gz format aksusbd-redhat-1.8.1-3.i386.rpm driver for USB keys (Aladdin supplier) 64-bit architecture Archive files cedrat_flexnet-1-0.x86_64.rpm cedrat_flexnet-1-0.x86_64.tar.gz Description server for RHEL 4 provided in rpm format server for RHEL 4 provided in tar.gz format
Warning: the USB key driver is available for RHEL 32 bits only.
Warnings
If Flux is already installed on your network, before proceeding to the installation, stop all the client software programs of Flux, as well as the license server currently active and possibly the key driver. For Flux V10 the use of the Flexnet Version 11.4.1 license server is compulsory. If you have a previous version of the server, uninstall it manually.
PAGE 30
INSTALLATION GUIDE
FLUX10
Network installation
If your license includes a USB key, you must install the driver for this key. Action Log in as root If Then the driver version 1.8.1 is there is nothing to be done already installed uninstall this driver manually and install the a driver of a version new one by running the command: previous to 1.8.1 was installed with another rpm -Uvh aksusbd-redhat-1.8.1-3.i386.rpm package than the rpm format install the driver by running the command: a driver of a version previous to 1.8.1 was rpm -Uvh aksusbd-redhat-1.8.1-3.i386.rpm installed from a rpm package / no driver was installed The driver is immediately active; it is not necessary to reboot the system.
Step 1 2
INSTALLATION GUIDE
PAGE 31
Network installation
FLUX10
The server is supplied with two archive files to choose from: - one rpm package - one tar.gz archive
rpm package
The rpm (RedHat Package Management) format is the preferred format for the RedHat distribution. We recommend its usage, but this requires working in the root account. If you wish to install the license server from the rpm package, refer to block: License server installation from the rpm package.
tar.gz archive
The tar.gz archive does not use the rpm software management system, but it can be installed without particular privileges. It can be used for example during an evaluation. If you wish to install the license server from the tar.gz archive, refer to block: License server installation from the tar.gz archive.
The contents are the same for the two formats, except that the paths into the tar.gz archive do not compulsorily start at the file system root / Description Server files and utilities Service script Service configuration file Brief Cedrat documentation and official license server documentation Location /opt/Cedrat/Flexnet/bin /etc/rc.d/init.d /etc/opt/Cedrat/Flexnet /opt/Cedrat/Flexnet/share/doc
PAGE 32
INSTALLATION GUIDE
FLUX10
Network installation
In order to install the server from the rpm archive, follow the instructions below:
Step 1 2 3
Action Log in as root If a previous version is already installed: Uninstall that version Execute the command* : For 32 bits: rpm -Uvh cedrat_flexnet-1-0.i386.rpm For 64 bits: rpm -Uvh cedrat_flexnet-1-0.x86_64.rpm
If you prefer to store the binary files (lmgrd, cedratlmd, lmutil ...) in another location, use the rpm command option prefix. Example: rpm prefix /usr/local -Uvh cedrat_flexnet-1-0.i386.rpm
Element Binary files Documentation Service script as well as its configuration file
In order to install the server from the tar.gz archive, follow the instructions below:
Step 1
Action If you are logged in as root Then preferably, go to the filesystem root using the command: cd / go to a directory of your choice
you are logged in as a normal user (without administration rights) extract the files using the command (for example): tar xzvf /mnt/cdrom/Flexnet_11.4.1_RHEL/cedrat_flexnet-10.i386.tar.gz If Then you are logged in as root perform the following commands: and you wish to use the /sbin/chkconfig --add \ system service so that the cedrat_flexnetd server starts at boot /sbin/chkconfig cedrat_flexnetd on
INSTALLATION GUIDE
PAGE 33
Network installation
FLUX10
If you are root and if the server has been installed in a standard location, then you can use it as a system service; refer to block cedrat_flexnetd system service configuration. Otherwise, you have to write your own startup script; refer to paragraph License server minimal configuration.
The configuration is performed by modifying the configuration file: /etc/opt/Cedrat/Flexnet/cedrat_flexnet.conf Comments The default value is: LICENSE_FILE=$FLEXNET_CONF/license.dat This directory is declared in the variable FLEXNET_CONF defined at the beginning of the file. The default value is: LOG_FILE=/var/log/cedrat_lmgrd.log You can keep this default value. If you leave this variable empty, the server log will be redirected to syslog, which may noticeably increase and clutter the system log. The suggested user name is: LMGRD_USER="lmgrd"
Action Set the LICENSE_FILE variable to the full license file name. Store the license file in the same directory as the configuration file: /etc/opt/Cedrat/Flexnet Set the LOG_FILE variable to the server log file name.
Define a user by assigning a username to the variable LMGRD_USER If the user is root (not recommended), assign an empty string to the variable Otherwise, create a normal user (without administration privileges) and assign it to the variable The available options are described in the Flexnet Optional: Several server options may be declared into Licensing End User Guide, in chapter 9 "The License Server Manager". the LMGRD_OPTIONS variable (empty by default)
Continued on next page
PAGE 34
INSTALLATION GUIDE
FLUX10
Network installation
Configuring the server as a service is not possible if the installation could not take place in standard locations. You can then write a very short script in order to run lmgrd. Step 1 Action Write a startup script Here is a very simple example that you have to customize according to your configuration:
Script name: flexnet_startup.sh #!/bin/bash LMGRD_PATH=... LICENSE_PATH=... LOG_PATH=... nohup $LMGRD_PATH/lmgrd -c $LICENSE_PATH/my_license_file.dat \ -l $LOG_PATH/cedrat_lmgrd.log &
Make the script executable with the following command: chmod u+x flexnet_startup.sh
The different steps to configure the license file are listed below: Step 1 2 Action Edit the license file .dat Replace the text my_server in the SERVER line (first line) with your server name (see block How to get the server name). In the case of three redundant servers, you have to process all three SERVER lines.
For example, if your server name is cedratdemo, then the first line in the license file will be as follows: Example with a USB key: SERVER cedratdemo FLEXID=9-44074EB8 Example without a key: SERVER cedratdemo 000ae6bff29a
To get your server name, use one of the following commands: hostname or uname -n.
INSTALLATION GUIDE
PAGE 35
Network installation
FLUX10
To start the license server, follow the instructions below: If you have configured the system service Then the service will start automatically at the next system boot. However, you can start it manually with the following command: service cedrat_flexnetd start and you can stop it with the command: service cedrat_flexnetd stop run the script you have written: it was called in our example flexnet_startup.sh; then execute the command: ./flexnet_startup.sh to stop it, you can use the command : $LMGRD_PATH/lmdown -c \ $LICENSE_PATH/my_license_file.dat
PAGE 36
INSTALLATION GUIDE
FLUX10
Network installation
5.4.
Introduction
Installation and configuration of Flux is a two step procedure on a Windows computer: Step 1 2 Action Install Flux Configure Flux in the case of one server only in the case of three redundant servers
There are different steps to configure Flux, i.e. to designate the license server to Flux in the case when the license server function is ensured by one server:
Step 0 1
Action Log in as administrator Starting from the Flux Supervisor: either in the Tools menu, choose the License Manager menu or click on the icon In the License Manager window, select Network Identifier Use the following syntax: @host host corresponds to the name of the license server computer
2 3
Remark (advanced installation): You can equally use the following syntax: port@host port corresponds to the TCP/IP port number host corresponds to the name of the license server computer By default, no TCP/IP port is specified in the license file (this port number is optional). If you wish to specify a port number, you will have to fill in the first line (SERVER line) of the license file; this will be the fourth parameter of this line. For example, if the license server name is cedratdemo and if you have not specified any port, you will have to enter, in the first line: @cedratdemo
4 5
INSTALLATION GUIDE
PAGE 37
Network installation
FLUX10
There are different steps to configure Flux, i.e. to designate three license servers to Flux in the case when the license server function is ensured by three redundant servers: Step 0 1 Action Log in as administrator Starting from the Flux Supervisor: either in the Tools menu, choose the License Manager menu or click on the icon In the License Manager window, select Network Identifier Use the following syntax: port@host port corresponds to the TCP/IP port number host corresponds to the name of the license server computer By default, the port 27001 is specified in the license file.
Remark (advanced installation): If you wish to specify another number to the port, you will have to modify the fourth parameter in the first line (SERVER line) of the license file. For instance, if the names of the three license servers are cedratdemo1, cedratdemo2 and cedratdemo3 and if you have not modified the port, you will have to enter: in the first line: 27001@cedratdemo1 in the second line: 27001@cedratdemo2 in the third line: 27001@cedratdemo3
2 3
4 5
PAGE 38
INSTALLATION GUIDE
FLUX10
6.
Introduction
All documentation pertaining to the Flux software (users guide, tutorials) is available in the form of PDF files as well as Flux files and/or command files corresponding to the tutorials and technical papers. This chapter presents how to install the Flux documentation and examples and how to access it.
Contents
This chapter covers the following topics: Installation of the documentation and examples Access to the documentation and examples
INSTALLATION GUIDE
PAGE 39
FLUX10
6.1.
Introduction
This section describes how to install and run the Flux documentation and examples. This installation procedure runs automatically.
What is installed
The installation loads the document elements as specified by the user: the documentation (installation guide and users guide) in English and/or the documentation (installation guide and users guide) in French and/or the examples (tutorials and technical papers with the Flux files and/or the corresponding command files).
Installed components
The Flux documentation and/or examples are installed: by default, in the directory: C:\Cedrat in any other directory specified by the user during the installation*. The Flux documentation and/or examples are installed in the sub-directory Flux_10.x_Doc_examples (10.x is the version number).
* The full installation directory path must not include any spaces or special characters
Continued on next page
PAGE 40
INSTALLATION GUIDE
FLUX10
The steps required to install the Flux documentation and examples are detailed in the following table: Step 1 2 3 4 5 6 Action Insert the Documentation CD into the CD-ROM drive Open Windows Explorer Click on the CD-ROM drive icon Navigate to the Install directory Run the executable file setup.exe to install the Flux V10.1 documentation and examples In the Documentation and Examples of Flux 10.1 Setup window, click on the Next button to continue installing the Flux V10.1 documentation and examples.
INSTALLATION GUIDE
PAGE 41
FLUX10
Step 7
Action In the new Documentation and Examples of Flux 10.1 Setup window:
Select Documentation (English) to install the documentation in English (installation guide and users guide) Select Documentation (French) to install the documentation in French (installation guide and users guide) Select Examples to install the examples (tutorials and technical papers with Flux files and/or corresponding command files) Click on the Next button to continue installing the Flux V10.1 documentation and examples
Continued on next page
PAGE 42
INSTALLATION GUIDE
FLUX10
Step 8
Action In the new Documentation and Examples of Flux 10.1 Setup window:
Choose an installation folder - By default, the installation directory is C:\Cedrat - If you want to install Flux in another directory, make sure that the full directory path does not include any spaces or special characters, then: click on the Browse button Click on the Install button to start the installation of the Flux V10.1 documentation and examples. In the last Documentation and Examples of Flux 10.1 Setup window, click on the Finish button to close the installation.
INSTALLATION GUIDE
PAGE 43
FLUX10
6.2.
Introduction
This section describes how to access the Flux documentation and examples.
You can access the Flux documentation and examples: either starting from the Documentation CD-ROM or either on hard disk, in the installation directory of the Flux documentation and examples or starting from the Flux Supervisor; it is available only for PDF files.
You can directly access the Flux documentation and examples starting from the Documentation CD-ROM, in the directory: Flux_10.x_Doc_examples (10.x is the version number).
On hard disc
You can directly access the Flux documentation and examples in its installation directory after you have installed the documentation and examples (see section 6.1): <Doc. install. dir.>\Flux_10.x_Doc_examples
Continued on next page
PAGE 44
INSTALLATION GUIDE
FLUX10
You can only access to PDF files, starting from the Flux Supervisor. The procedure runs in two steps: Step 1 2 Action Specify the access path to the documentation Access to PDF files
The steps required to specify the access path to the documentation are detailed in the following table:
Step 1 2 3
Action Starting from the Flux Supervisor, choose the Tools menu and then Options menu In the Options window, select the General tab In the General tab, in the Other zone, in the Path to the documents field: either select CDROM and insert the Documentation CD-ROM into the CD-ROM drive or select LOCAL in the case, if you have installed the documentation (see section 6.1), and indicate the access path to the installation directory for the documentation: <Doc. install. dir.>\Flux_10.x_Doc_examples
To get access to PDF files, from the Flux Supervisor, choose the Help menu and then Documents menu.
INSTALLATION GUIDE
PAGE 45
FLUX10
PAGE 46
INSTALLATION GUIDE
FLUX10
7.
Introduction
Download a patch
The steps required to download a Flux patch are detailed in the following table: Step 1 2 3 4 5 6 Action Connect to our "Flux Software Updates" WEB site : http://www.cedrat.com/installpatch Enter your login (created during your registration on this site) Enter your password (sent to you by email by the sales team) Click on Flux PC In the window of the selected patch, click on EUROPE-CHINAINDIA and rest of the world Save the executable file .exe on your hard disk, for example in the Flux installation directory (by default C:\Cedrat)
Install a patch
The steps required to install a Flux patch are detailed in the following table: Step 0 1 2 Action Log in as administrator Run the executable file .exe Answer the various questions. The new patch is then automatically installed.
INSTALLATION GUIDE
PAGE 47
FLUX10
PAGE 48
INSTALLATION GUIDE
FLUX10
Annexes
8.
Annexes
Contents
This chapter covers the following topics: Manual configuration of the license server Troubleshooting
INSTALLATION GUIDE
PAGE 49
Annexes
FLUX10
8.1.
Introduction
The procedure for the manual configuration of the license server has four steps: Step 1 2 3 4 Action Copy the license file .dat on hard disk Configure the license file .dat, i.e. insert the name(s) of the license server(s) in the license file. Configure the Flexnet license server. Run the Flexnet license server.
First, it is necessary to copy the license file .dat that you have received by email (from the sales team), on hard disk, for instance in the directory: C:\Cedrat\FlexNetServer_11.4
The different steps to configure the license file .dat are as follows:
Step 1 2
Action Open the license file .dat by a text editor, for example the Notepad Replace the text my_server in the SERVER line by the name of your server (see How to get the server name on next page). In the case of three redundant servers, you have to operate on the three SERVER lines.
For example, if the name of your server is cedratdemo, then the first line of the license file is as follows: Example with a USB key: SERVER cedratdemo FLEXID=9-44074EB8 Example without a USB key: SERVER cedratdemo 004005537d54
Continued on next page
PAGE 50
INSTALLATION GUIDE
FLUX10
Annexes
To get the name of your server, you can use the following method:
Step 1 2 3 4
Action Open one Windows Explorer Click with the mouse right button on Working post Click on the Properties menu On Windows 2000 On Windows XP or on Windows Server 2003 In the System properties In the System properties window click on the window click on the Computer name tab Network identification tab The server name is then displayed in the Complete name of computer field.
Continued on next page
INSTALLATION GUIDE
PAGE 51
Annexes
FLUX10
The steps required to configure the license server Flexnet are as follows:
Step 0 1
3 4
5 6
7 8
Action Log in as administrator If you have a USB key for the license, then it is necessary to connect this key on a USB port If you do not have a USB key for the license, then go to step 2 Start the License Manager: Open Windows Explorer Navigate to the directory: <Rep. Install. Server Flexnet V11.4>\FlexNetServer_11.4 Execute the executable file license_manager.exe In the License Manager window, click on the Manual License Server Configuration button In the LMTOOLS window, in the Service/License File tab, select Configuration using Services, in order to display Config Services tab Select the Config Services tab Define the full name: of the lmgrd program, for example: C:\Cedrat\FlexNetServer_11.4\lmgrd.exe of the license file, for example: C:\Cedrat\FlexNetServer_11.4\licence.dat of the debug file, for example: C:\Cedrat\FlexNetServer_11.4\debug.log During the first installation, this file does not exist; it is necessary to enter its name This file is important for an effective support. Check the Use Services and the Start Server at Power Up case to automatically activate the license server when the server restarting Click on the Save Service button to save the configuration
PAGE 52
INSTALLATION GUIDE
FLUX10
Annexes
There are two steps to run the license server Flexnet: Step 1 2 Action In the LMTOOLS window, select Start/Stop/Reread tab Click on the Start Server button
Remark: You can check if the server has started correctly by selecting line Server Status and by clicking on the Perform Status Enquiry button
To stop the license server, follow the procedure below: Step 1 2 Action In the LMTOOLS window, select the Start/Stop/Reread tab Click on the Stop Server button
INSTALLATION GUIDE
PAGE 53
Annexes
FLUX10
8.2.
Troubleshooting
Introduction
*** Invalid host*** *** The hostid of this system does not match the hostid*** *** specified in the license file*** *** Feature:*** *** Hostid:*** *** License path:*** *** FLEXnet Licensing error: -9,57. System Error: 22 *** *** For further information, refer to the FLEXnet Licensing End User Guide, *** ***available at "www.macrovision.com". *** It can mean: With an USB key: - the USB key is defective, or - the USB key is incorrectly connected on the USB port, or - the USB key number does not match the one set in the license file, or - the USB key driver is incorrectly installed... Without an USB key: - the Ethernet card number does not match the one set in the license file
*** Feature has expired *** *** Feature: *** *** Expire date: *** *** License path: *** *** FLEXnet Licensing error: -10,32 *** *** For further information, refer to the FLEXnet Licensing End User Guide, *** ***available at "www.macrovision.com". *** It means the license file has expired
Continued on next page
PAGE 54
INSTALLATION GUIDE
FLUX10
Annexes
*** No such feature exists *** *** Feature: *** *** License path: *** *** FLEXnet Licensing error: -5,357 *** *** For further information, refer to the FLEXnet Licensing End User Guide, *** *** available at "www.macrovision.com". *** or Type of problem not implemented on your FLUX2D version. It can mean: the Flux version is not the one allowed by the license, for example: using Flux 10 while the version allowed by the license is Flux 9.x, or the application is not licensed The UAC* feature of Windows Vista impacts the proper working of the Flux license manager.
License configuration:
To make the license manager run properly and to be able to configure your license, you must inactivate the User Account Control option of Windows Vista. To turn off UAC: Step 1 2 3 Action Open the Control Panel and click on User Accounts Click on Turn User Account Control On or Off Clear the Use User Account Control (UAC) to help protect your computer and click on OK Restart computer
Continued on next page
INSTALLATION GUIDE
PAGE 55
Annexes
FLUX10
With Norton Internet Security 2005 virus scan, the first start-up of Flux after the computer has been rebooted, may take a long time (up to 5 minutes). All subsequent starts will be normal.
Bypass solution:
Change the virus scan configuration as following: Step 1 2 Action Go in menu: Configure/File System Auto-Protect and select Advanced In the option Auto-Protect will scan files that are: select Modified instead of Accessed or modified.
PAGE 56
INSTALLATION GUIDE