Download - Installation Guide En
CAD package for electromagnetic
and thermal analysis using finite elements
FLUX® 10
Installation guide
Copyright – May 2008
FLUX software : Copyright CEDRAT/INPG/CNRS/EDF CAOBIBS software : Copyright ECL/CEDRAT/CNRS/INPG ACIS core : Spatial Corp. FLUX documentation : Copyright CEDRAT FLUX Quality Assessment: Application 2D : EDF standards, registered number AQM1L002 Application 3D : EDF standards, registered number AQM1L013
This installation guide was published on 29 May 2008
Ref.: K106-10-EN-05/08
CEDRAT 15 Chemin de Malacher - Inovallée
38246 MEYLAN Cedex France
Phone: +33 (0)4.76.90.50.45 Fax: +33 (0)4.56.38.08.30
Email: [email protected]
Web: http://www.cedrat.com
FLUX®10 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. Introduction .....................................................................................................................30 5.3.2. USB key driver installation..............................................................................................31 5.3.3. License server installation ..............................................................................................32 5.3.4. License server configuration...........................................................................................34 5.3.5. License file configuration ................................................................................................35 5.3.6. 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
FLUX®10 Foreword
1. Foreword
Introduction This foreword describes the CD-ROMs provided with Flux Version 10.
CD-ROMs Flux V10
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
FLUX®10 Required configuration
2. Required configuration
Introduction This chapter presents the required configuration.
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 FLUX®10
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
FLUX®10 Required configuration
2.2. Required configuration for Flux 2D applications
Introduction This section describes minimum and recommended configurations for Flux
2D applications.
2D minimum configuration requirements
To run the Flux 2D applications on a computer, the minimum requirements are:
Element Characteristics
Processor • Intel or AMD • 32 or 64 bits • mono core or multi core
Memory
Hard disk 10 Go RAM 1 Go
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 Characteristics
Processor • Intel or AMD • 32 or 64 bits • mono core or multi core
Memory
Hard disk 30 Go 32-bit operating systems 2 Go RAM 64-bit operating systems 4 Go
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 FLUX®10
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
FLUX®10 Required configuration
2.3. Required configuration for Flux 3D applications
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:
3D minimum configuration equirements r
Element Characteristics Processor • Intel or AMD
• 32 or 64 bits • mono core or multi core
Memory
Application General Transient Magnetic
Steady AC applications
Hard disc 20 GB 50 GB 20 GB
RAM 1 GB 1 GB 2 GB
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 Characteristics Processor • Intel or AMD
• 32 or 64 bits • mono core or multi core
Memory
Application General Transient Magnetic
Hard disc (≥ 10 000 turns/min) 50 GB 100 GB
32-bit operating systems 2 GB 2 GB RAM
64-bit operating systems 4 GB 4 GB
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 FLUX®10
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
FLUX®10 Required configuration
2.4. 3GB mode (4GT RAM tuning mode of Windows) with Flux
4GT RAM tuning mode of Windows
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.
Windows versions supporting the 4GT RAM tuning mode
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
Activate the 3GB mode on Windows XP
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 Action 1 Edit the boot.ini file (located the root of the hard disk drive) using
the notepad editor. 2 Copy and paste the last line of this file. 3 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”
4 Restart the computer 5 Select the 3GB mode when the computer is restarting
Continued on next page
INSTALLATION GUIDE PAGE 9
Required configuration FLUX®10
Example of boot.ini file after 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 3GB" /fastdetect/3GB multi(0)disk(0)rdisk(0)partition(1)\WINNT="Microsoft Windows XP Pro"/fastdetec
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)
To activate the 3GB mode on Windows Vista, follow the instructions: Activate the 3GB mode on
indows Vista W
Step Action 1 In the menu Start \ Programs \ Accessories:
• right-click on Command prompt 2 In the contextual menu:
• click Run as administrator 3 At the Command prompt:
• enter BCDEDIT/set increaseuserva 3072 4 Restart the computer
To deactivate the 3GB mode on Windows Vista, follow the instructions: Deactivate the 3GB mode on
indows Vista W
Step Action 1 In the menu Start \ Programs \ Accessories:
• right-click on Command prompt 2 In the contextual menu:
• click Run as administrator 3 At the Command prompt:
• enter BCDEDIT/deletevalue increaseuserva 4 Restart the computer
Flux memory settings with the 3GB mode
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 GUI memory
1700 10 400
PAGE 10 INSTALLATION GUIDE
FLUX®10 Protection system
3. Protection system
Introduction This chapter presents the protection system of Flux.
Contents This chapter covers the following topics:
• Protection system • Nodelocked license • Network license
INSTALLATION GUIDE PAGE 11
Protection system FLUX®10
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.
Two types of license
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
FLUX®10 Protection system
3.3. Network license
Definition The Network license is compatible with a use of Flux in the network.
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.
License server function
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
FLUX®10 Single computer installation
4. Single computer installation
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
Single computer installation FLUX®10
4.1. Flux Version 10 installation
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
FLUX®10 Single computer installation
Install Flux The steps to install Flux Version 10.1 are presented in the table below:
Step Action 0 Log in as administrator 1 Close all the applications in use 2 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
3 In the installation supervisor window, click on Flux 10.1 to install Flux Version 10.1
Continued on next page
INSTALLATION GUIDE PAGE 17
Single computer installation FLUX®10
Install Flux (continued)
Step Action 4 In the Flux 10.1 Setup window, click on the Next button to
continue installing Flux Version 10.1
5 In the new Flux 10.1 Setup window:
• 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
FLUX®10 Single computer installation
Install Flux (continued)
Step Action 6 In the last Flux 10.1 Setup window:
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.
7 In the installation supervisor window, click on Quit to exit the installation.
INSTALLATION GUIDE PAGE 19
Single computer installation FLUX®10
4.2. Nodelocked license installation
Install the license
The different steps to install the license, i.e. configure Flux, for a Nodelocked license are detailed in the following table:
Step Action
0 Log in as administrator 1 • 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
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
3 From the Flux Supervisor: • either in the menu Tools, choose the menu License Manager
• or click on the icon 4 In the License Manager window, select NodeLocked 5 In the License file(s) field, click on the button Add license file 6 In the Select one or more files window:
• Select the license file (.dat) Systems License file containing
the character string
32 bits NODELOCKED32 64 bits NODELOCKED64
• Click on the button Open 7 Click on the button Apply 8 Click on the button Quit
PAGE 20 INSTALLATION GUIDE
FLUX®10 Single computer installation
4.3. Network license installation
Introduction The procedure for the installation of the Network license requires two steps:
Step Action 1 Configure and start the Flexnet license server 2 Configure Flux
Configure and start the license server (Step 1)
First, it is necessary to configure and start the license server. To do so, refer to section 5.2 – Step 2.
Configure Flux (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
FLUX®10 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 FLUX®10
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
Linux supported systems
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
FLUX®10 Network installation
5.2. License server installation, configuration and startup on Windows
Introduction The procedure for the installation, configuration and start of the license server
requires two steps:
Step Action 1 Install the Flexnet Version 11.4 license server 2 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.
What is installed (Step 1)
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
Installed components (Step 1)
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 FLUX®10
Install the license server (Step 1)
The steps required to install the license server Flexnet Version 11.4 are detailed in the following table:
Step Action
0 Log in as administrator 1 Close all the applications in use 2 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
3 In the installation supervisor window, click on Flexnet server 11.4 to install the license server Flexnet Version 11.4
Continued on next page
PAGE 26 INSTALLATION GUIDE
FLUX®10 Network installation
Install the license server (Step 1) (continued)
Step Action 4 In the FlexNetServer 11.4 Setup window, click on the Next
button to continue installing the license server Flexnet Version 11.4
5 In the new FlexNetServer 11.4 Setup window:
• 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 FLUX®10
Install the license server (Step 1) (continued)
Step Action 6 In the last FlexNetServer 11.4 Setup window:
• 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.
7 In the installation supervisor window, click on Quit to exit the installation.
Continued on next page
PAGE 28 INSTALLATION GUIDE
FLUX®10 Network installation
Configure and start the license server (Step 2)
The steps required to automatically configure and start the Flexnet license server are detailed in the following table:
Step Action
0 Log in as administrator 1 • 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
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
3 In the License Manager window, select Automatic License Server Configuration
4 In the License file field, click on the button … 5 In the License file window:
• Select the license file (.dat) comprising the character string NETWORK
• Click on the button Open 6 Click on the button Apply 7 Click on the button Quit
INSTALLATION GUIDE PAGE 29
Network installation FLUX®10
5.3. License server installation, configuration and startup on RedHat Enterprise Linux
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 Description cedrat_flexnet-1-0.x86_64.rpm server for RHEL 4 provided in rpm format cedrat_flexnet-1-0.x86_64.tar.gz 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
FLUX®10 Network installation
5.3.2. USB key driver installation
USB key driver installation
If your license includes a USB key, you must install the driver for this key.
Step Action
1 Log in as root 2 If … Then …
the driver version 1.8.1 is already installed
there is nothing to be done
a driver of a version previous to 1.8.1 was installed with another package than the rpm format
uninstall this driver manually and install the new one by running the command: rpm -Uvh aksusbd-redhat-1.8.1-3.i386.rpm
a driver of a version previous to 1.8.1 was installed from a rpm package / no driver was installed
install the driver by running the command: rpm -Uvh aksusbd-redhat-1.8.1-3.i386.rpm
The driver is immediately active; it is not necessary to reboot the system.
INSTALLATION GUIDE PAGE 31
Network installation FLUX®10
5.3.3. License server installation
Archive files 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”.
Contents of the 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 /
Object Description Location
lmgrd, cedratlmd, lmutil … Server files and utilities /opt/Cedrat/Flexnet/bin cedrat_flexnetd Service script /etc/rc.d/init.d cedrat_flexnet.conf Service configuration file /etc/opt/Cedrat/Flexnet README, LicensingEndUserGuide.pdf
Brief Cedrat documentation and official license server documentation
/opt/Cedrat/Flexnet/share/doc
Note: the directory structure complies with the LSB specification.
Continued on next page
PAGE 32 INSTALLATION GUIDE
FLUX®10 Network installation
License server installation from the rpm package
In order to install the server from the rpm archive, follow the instructions below:
Step Action
1 Log in as root 2 If a previous version is already installed:
• Uninstall that version 3 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 Standard location Alternative location Binary files /opt/Cedrat/Flexnet/bin /usr/local/Cedrat/Flexnet/bin Documentation /opt/Cedrat/Flexnet/share/doc /usr/local/Cedrat/Flexnet/share/doc Service script as well as its configuration file
No change
License server installation from the tar.gz archive
In order to install the server from the tar.gz archive, follow the instructions below:
Step Action
1 If … Then … you are logged in as root preferably, go to the filesystem root
using the command: cd / you are logged in as a normal user (without administration rights)
go to a directory of your choice
2 extract the files using the command (for example):
tar xzvf /mnt/cdrom/Flexnet_11.4.1_RHEL/cedrat_flexnet-1-0.i386.tar.gz
3 If … Then … you are logged in as root and you wish to use the system service so that the server starts at boot
perform the following commands: /sbin/chkconfig --add \ cedrat_flexnetd /sbin/chkconfig cedrat_flexnetd on
INSTALLATION GUIDE PAGE 33
Network installation FLUX®10
5.3.4. License server configuration
License server configuration
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”.
cedrat_flexnetd system service configuration
The configuration is performed by modifying the configuration file: /etc/opt/Cedrat/Flexnet/cedrat_flexnet.conf
Action Comments
Set the LICENSE_FILE variable to the full license file name.
The default value is: LICENSE_FILE=$FLEXNET_CONF/license.dat
Store the license file in the same directory as the configuration file: /etc/opt/Cedrat/Flexnet
This directory is declared in the variable FLEXNET_CONF defined at the beginning of the file.
Set the LOG_FILE variable to the server log file name.
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.
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 suggested user name is: LMGRD_USER="lmgrd"
Optional: Several server options may be declared into the LMGRD_OPTIONS variable (empty by default)
The available options are described in the Flexnet Licensing End User Guide, in chapter 9 "The License Server Manager".
Continued on next page
PAGE 34 INSTALLATION GUIDE
FLUX®10 Network installation
License server minimal configuration
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 Action
1 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 &
2 Make the script executable with the following command: chmod u+x flexnet_startup.sh
5.3.5. License file configuration
License file configuration
The different steps to configure the license file are listed below:
Step Action
1 Edit the license file .dat 2 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
How to get the server name
To get your server name, use one of the following commands: hostname or uname -n.
INSTALLATION GUIDE PAGE 35
Network installation FLUX®10
5.3.6. Starting the license server
Starting the license server
To start the license server, follow the instructions below:
If … Then …
you have configured the system service
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
you have created a startup script
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
FLUX®10 Network installation
5.4. Flux installation and configuration
Introduction Installation and configuration of Flux is a two step procedure on a Windows
computer:
Step Action 1 Install Flux 2 Configure Flux
• in the case of one server only • in the case of three redundant servers
Install Flux (Step 1)
First, it is necessary to install Flux; for this, refer to section 4.1.
Configure Flux in the case of one server (Step 2)
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 Action 0 Log in as administrator 1 Starting from the Flux Supervisor:
• either in the Tools menu, choose the License Manager menu
• or click on the icon 2 In the License Manager window, select Network Identifier 3 Use the following syntax:
@host host corresponds to the name of the license server computer
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 Click on the Apply button 5 Click on the Quit button
Continued on next page
INSTALLATION GUIDE PAGE 37
Network installation FLUX®10
Configure Flux in the case of three servers (Step 2)
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 Action
0 Log in as administrator 1 Starting from the Flux Supervisor:
• either in the Tools menu, choose the License Manager menu
• or click on the icon 2 In the License Manager window, select Network Identifier 3 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
4 Click on the Apply button 5 Click on the Quit button
PAGE 38 INSTALLATION GUIDE
FLUX®10 Documentation and examples
6. Documentation and examples
Introduction All documentation pertaining to the Flux software (user’s 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
Documentation and examples FLUX®10
6.1. Installation of the documentation and examples
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 user’s guide) in English and/or • the documentation (installation guide and user’s 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
FLUX®10 Documentation and examples
Install the Flux documentation and examples
The steps required to install the Flux documentation and examples are detailed in the following table:
Step Action
1 Insert the Documentation CD into the CD-ROM drive 2 Open Windows Explorer 3 Click on the CD-ROM drive icon 4 Navigate to the Install directory 5 Run the executable file setup.exe to install the Flux V10.1
documentation and examples 6 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.
Continued on next page
INSTALLATION GUIDE PAGE 41
Documentation and examples FLUX®10
Install the Flux documentation and examples (continued)
Step Action 7 In the new Documentation and Examples of Flux 10.1 Setup
window:
• Select Documentation (English) to install the documentation in
English (installation guide and user’s guide) • Select Documentation (French) to install the documentation in
French (installation guide and user’s 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
FLUX®10 Documentation and examples
Install the Flux documentation and examples (continued)
Step Action 8 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.
9 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
Documentation and examples FLUX®10
6.2. Access to the documentation and examples
Introduction This section describes how to access the Flux documentation and examples.
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.
From the Documentation CD-ROM
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
FLUX®10 Documentation and examples
From the Flux Supervisor
You can only access to PDF files, starting from the Flux Supervisor.
The procedure runs in two steps:
Step Action 1 Specify the access path to the documentation 2 Access to PDF files
Specify the access path to the documentation (Step 1)
The steps required to specify the access path to the documentation are detailed in the following table:
Step Action
1 Starting from the Flux Supervisor, choose the Tools menu and then Options menu
2 In the Options window, select the General tab 3 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
Access to PDF files (Step 2)
To get access to PDF files, from the Flux Supervisor, choose the Help menu and then Documents menu.
INSTALLATION GUIDE PAGE 45
FLUX®10 Download and installation of patch
7. Download and installation of patch
Introduction This chapter presents how to download and install a Flux patch.
Download a patch
The steps required to download a Flux patch are detailed in the following table:
Step Action
1 Connect to our "Flux Software Updates" WEB site : http://www.cedrat.com/installpatch
2 Enter your login (created during your registration on this site) 3 Enter your password (sent to you by email by the sales team) 4 Click on Flux PC 5 In the window of the selected patch, click on EUROPE-CHINA-
INDIA and rest of the world 6 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 Action 0 Log in as administrator 1 Run the executable file .exe 2 Answer the various questions.
The new patch is then automatically installed.
INSTALLATION GUIDE PAGE 47
FLUX®10 Annexes
8. Annexes
Contents This chapter covers the following topics:
• Manual configuration of the license server • Troubleshooting
INSTALLATION GUIDE PAGE 49
Annexes FLUX®10
8.1. Manual configuration of the license server
Introduction The procedure for the manual configuration of the license server has four
steps:
Step Action 1 Copy the license file .dat on hard disk 2 Configure the license file .dat, i.e. insert the name(s) of the license
server(s) in the license file. 3 Configure the Flexnet license server. 4 Run the Flexnet license server.
Copy the license file (Step 1)
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
Configure the license file (Step 2)
The different steps to configure the license file .dat are as follows:
Step Action
1 Open the license file .dat by a text editor, for example the Notepad2 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
FLUX®10 Annexes
How to get the server name (Step 2)
To get the name of your server, you can use the following method:
Step Action
1 Open one Windows Explorer 2 Click with the mouse right button on Working post 3 Click on the Properties menu 4 On Windows 2000 On Windows XP or
on Windows Server 2003
In the System properties window click on the Network identification tab
In the System properties window click on the Computer name tab
The server name is then displayed in the Complete name of computer field.
Continued on next page
INSTALLATION GUIDE PAGE 51
Annexes FLUX®10
Configure the license server (Step 3)
The steps required to configure the license server Flexnet are as follows:
Step Action
0 Log in as administrator 1 • 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
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
3 In the License Manager window, click on the Manual License Server Configuration button
4 In the LMTOOLS window, in the Service/License File tab, select Configuration using Services, in order to display Config Services tab
5 Select the Config Services tab 6 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.
7 Check the Use Services and the Start Server at Power Up case to automatically activate the license server when the server restarting
8 Click on the Save Service button to save the configuration
Continued on next page
PAGE 52 INSTALLATION GUIDE
FLUX®10 Annexes
Run the license server (Step 4)
There are two steps to run the license server Flexnet:
Step Action
1 In the LMTOOLS window, select Start/Stop/Reread tab 2 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
How to stop the license server
To stop the license server, follow the procedure below:
Step Action
1 In the LMTOOLS window, select the Start/Stop/Reread tab 2 Click on the Stop Server button
INSTALLATION GUIDE PAGE 53
Annexes FLUX®10
8.2. Troubleshooting
Introduction This section presents error messages and their explanations.
Error messages due to the installation
*** 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
Error messages due to the license deadline
*** 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
FLUX®10 Annexes
Error messages due to the software version or to the allowed applications
*** 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
Problem description on Windows Vista
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 Action 1 Open the Control Panel
and click on User Accounts 2 Click on Turn User Account Control On or Off 3 Clear the Use User Account Control (UAC) to help protect
your computer and click on OK
4 Restart computer
Continued on next page
INSTALLATION GUIDE PAGE 55
Annexes FLUX®10
Problem description with Norton
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 Action
1 Go in menu: Configure/File System Auto-Protect and select Advanced
2 In the option Auto-Protect will scan files that are: select Modified instead of Accessed or modified.
PAGE 56 INSTALLATION GUIDE