Visual-Environment 9.

0
Visual-Assembly (Beta)

Visual-Mesh (Cast)

Visual-Cast

Visual-NVH & Interior Acoustics

Visual-CEM

Visual-OPT (Beta)

Visual-CFD

Visual-Process Executive

Visual-Crash DYNA

Visual-Safe

Visual-Crash PAM

Visual-Safe MAD

Visual-Crash RAD

Visual-SDK

Visual-DIEMAKER

Visual-Seal

Visual-Distortion

Visual-Shock

VisualDSS

Visual-SYSTUS

Visual-FORM

Visual-Viewer

Visual-Heat Treatment

Visual-Viewer (Cast)

Visual-Life NASTRAN

Visual-Viewer (Composites)

Visual-Local Model Advisor

Visual-Viewer (Seal)

Visual-Materials (Composites)

Visual-Viewer (Weld)

Visual-MEDYSA

Visual-VTM

Visual-Mesh

Visual-Weld

INSTALLATION GUIDE

The documents and related know-how herein provided by ESI Group subject to
contractual conditions are to remain confidential. The CLIENT shall not disclose
the documentation and/or related know-how in whole or in part to any third party
without the prior written permission of ESI Group.

ESI Group, 2013. All rights reserved.

August 2013

VISUAL-ENVIRONMENT
2013 ESI Group

INSTALLATION GUIDE
(released: Aug-13)

CONTENTS
Introduction

Media Contents

Installation on UNIX/Linux

Overview ------------------------------------------------------------------------------------- 2
Minimum Requirements ------------------------------------------------------------------ 3
Hardware ------------------------------------------------------------------------------------3
Software -------------------------------------------------------------------------------------4
Shell Compliance --------------------------------------------------------------------------4

Installation of the Software -------------------------------------------------------------- 5

DVD-R Instructions -----------------------------------------------------------------------5
Graphical Installation ---------------------------------------------------------------------5

Installation of the License ------------------------------------------------------------- 13

Graphical Installation ------------------------------------------------------------------- 14
Customization ---------------------------------------------------------------------------- 21

X Server Settings

23

For UNIX ----------------------------------------------------------------------------------- 23

Installation on Windows

24

Minimum Requirements ---------------------------------------------------------------- 24

Installation of Software ----------------------------------------------------------------- 25
DVD Instructions------------------------------------------------------------------------- 25

Installation for Visual-Local Model Advisor (VLMA)

27

Sysweld Resource File Updation ---------------------------------------------------- 27

Installation of the License

29

How To Get Your FLEXnet License File? -------------------------------------- 29

Starting the FLEXnet License Server -------------------------------------------- 31

Invoking the Application

33

Windows ----------------------------------------------------------------------------------- 33
UNIX / Linux ------------------------------------------------------------------------------- 33

Troubleshooting

34

Contents

INSTALLATION GUIDE
(released: Aug-13)

Contents

ii

VISUAL-ENVIRONMENT
2013 ESI Group

Software Authorization

38

License Request

39

VISUAL-ENVIRONMENT
2013 ESI Group

INSTALLATION GUIDE
(released: Aug-13)

INTRODUCTION
This Installation Guide, provided by ESI Group, describes the installation procedure for
all ESI Group products package on supported Windows and UNIX/Linux platforms.
You should not attempt to install ESI Group products until you have become familiar
with this installation guide.
The Installation on Unix/Linux chapter discusses the overview, system requirements,
installation, uninstallation, and troubleshooting on a Unix/Linux-based platform.

MEDIA CONTENTS
The ESI Group software packages for Windows and Unix-based workstations shipped
by ESI Group contain the following items:

Introduction

DVD-R containing the Visual-Environment software.

Visual-Environment Installation Guide (this manual in .pdf)

Visual-Environment Release Notes (.pdf)

INSTALLATION GUIDE
(released: Aug-13)

VISUAL-ENVIRONMENT
2013 ESI Group

INSTALLATION ON UNIX/LINUX
OVERVIEW
To install the ESI Group products on UNIX & Linux platform, two installation
procedures are available:

paminst-gui.sh

It is a Graphical User Interface script.

paminst.sh

It is an old-fashioned line-oriented line script.

Both procedures perform the following tasks:

Install the software (described in Installation of Software chapter).

Copy from the DVD-R all the files of software to the location chosen by the
user.

License management (described in Installation of License chapter).

Install the license file.

Start the license daemons lmgrd and pam_lmd if needed.

Install the license daemon startup scripts 1

Customization (described in Customization of Software Environment chapter).

Set up the ESI Group software environment for each current user.

Tasks 2 and 3 can be performed later if the user does not want to do them immediately.
After the installation, files installed on the hard disk are organized in a directory tree as
indicated below:
Head Directory
this is referenced as PAMHOME
Installation Scripts...

Version1_COMMON
Ressource files

MODULE 1

MODULE 2

Examples

LICENSES

DOC

Executables, other files...

Executables, other files...

Examples files, test cases...

License file

Electronic documentation

Version1_platformOS1 Version1_platformOS2 Version2_platformOS1

Executables

Executables

Executables

platformOS1

platformOS2

Daemon and tool files

Daemon and tool files

Sufficient privileges may be required by the system during the installation of ESI Group products.
Although no system library is updated in the process, the sufficient privileges will be needed to mount the
DVD-R and to install the boot files to start the license server.

Installation on UNIX/Linux

VISUAL-ENVIRONMENT
2013 ESI Group

INSTALLATION GUIDE
(released: Aug-13)

MINIMUM REQUIREMENTS
Hardware

1 gigabyte of RAM recommended.

2 GB main memory and fastest CPU is recommended for large CAD/FE model
operations.

OpenGL hardware graphic accelerator (highly recommended). Systems without

an OpenGL graphic board will perform significantly slower.

4.2 GB disk (free) space for complete installation or 2.5 GB by platform.

Super VGA monitor with the following settings:

o Screen resolution set to at least 1280 x 1024.
o Small fonts selected.

3 button mouse (middle button required for dynamic rotations in graphic

window).

Linux:

Visual 32-Bit version: GlibC 2.5 (RedHat EL 5/6, SUSE 10/11).

Visual 64-Bit version: GlibC 2.5 (RedHat EL 5/6, SUSE 10/11).

Installation on UNIX/Linux

INSTALLATION GUIDE
(released: Aug-13)

VISUAL-ENVIRONMENT
2013 ESI Group

Software

Unix/Linux OS (Refer to the file README_Visual-Environment_9.0 under

info directory for system requirement details).

You need to have any product able to display pdf files (like Adobe Reader see
www.adobe.com).

You need to have any product able to display Html files (like Netscape see
www.netscape.com).

Shell Compliance

csh and its variant tcsh are supported on all systems provided on the DVD.

ksh is supported on all systems provided on the DVD.

bash is supported on all systems provided on the DVD.

sh is supported in the following cases:

o HP HP-UX: /usr/bin/sh (Posix compliant).
o SUN SOLARIS: /usr/xpg4/bin/sh (Xpg4 compliant).
Old sh implementations are not supported. Future Posix sh implementations will
be supported.

Installation on UNIX/Linux

VISUAL-ENVIRONMENT
2013 ESI Group

INSTALLATION GUIDE
(released: Aug-13)

INSTALLATION OF THE SOFTWARE

DVD-R Instructions
Insert the DVD into the drive.
Follow the DVD mount and dismount instructions in the table below.
PLATFORM MOUNTING
IBM AIX

Under ROOT

SPECIFIC INSTRUCTIONS

DISMOUNTING
umount /cdrom

mount /usr/cdrom/sws
or mount v cdrfs r /dev/cd0
/cdrom

HP HP-UX

Under ROOT

mount
r
F
/dev/dsk/c1t#d0 /cdrom

Oracle SOLARIS

Automatic

PC Windows

Automatic

PC Linux

Automatic

Requires mount option exec

cdfs umount /cdrom

eject
eject

# symbol is the SCSI Id number of the DVD-R drive

Device names in italics are site dependent

Graphical Installation
System Requirements:
The installation through graphical user interface is available on the following systems:

HP HP-UX PA-Risc 11.11 and above;

HP HP-UX Itanium2 11.23 and above;

IBM AIX 5.1 and above;

SGI IRIX 6.5 and above;

Oracle Solaris SPARC 5.8 and above;

Oracle Solaris x64 5.10 and above

PC Linux i686 distributions with GlibC 2.3 and above;

PC Linux x86_64 distributions with GlibC 2.3 and above;

PC Linux ia64 (Itanium2) distributions with GlibC 2.3 and above.

In order to use the graphical installation, you need:

Installation on UNIX/Linux

INSTALLATION GUIDE
(released: Aug-13)

VISUAL-ENVIRONMENT
2013 ESI Group

An X-compliant window system available on your display.

o Position the DISPLAY environment variable for display on the current
screen and, if necessary, allow this display using an appropriate xhost
command on the display host.

About 15 Mb of free space in the /tmp directory to store graphical tools

temporarily.

Launching Installation:
To start the graphical software installation script, type the following command:
./INSTALL.SH or /<cdrom_moint_point>/INSTALL.SH

If this error message is obtained:

INSTALL.SH: /bin/sh: bad interpreter: Permission denied

See section How to override CD drive protection

Follow the instructions displayed in blue color in the dialog boxes presented by the
installation tool.

Installation on UNIX/Linux

VISUAL-ENVIRONMENT
2013 ESI Group

INSTALLATION GUIDE
(released: Aug-13)

After the graphical tools are loaded in /tmp, the main dialog box window appears:

Fig 1: Main dialog box window

Click on Install software button. It will highlight the Next button to continue.
Click the Next button to continue the software installation.
Click on Cancel button to abort/exit the software installation.
Prerequisites of Visual-Environment 9.0 can be obtained in info directory present on
the DVD media or in $PAMHOME/info after installation.

Installation on UNIX/Linux

INSTALLATION GUIDE
(released: Aug-13)

VISUAL-ENVIRONMENT
2013 ESI Group

Fig 2: Installation directory dialog box window

This dialog box is used to specify the installation directory.

By default, the text field of the installation directory is filled with the previous
pathname of ESI Group software installation directory $PAMHOME.
Two ways to select a new software installation location on the system:

Click on and fill the text field with a valid pathname directory (read, write,
execute permissions are required)

Click on Browse button to select another software installation location (see

Directory selector dialog box for using it).

or

Click on Next button when you are satisfied with the software installation directory
selected. Go to the Package selector dialog box section to see details.
Click on Cancel button to quit the software installation.
Click on Previous button to go back to the main dialog box of the software installation.

Installation on UNIX/Linux

VISUAL-ENVIRONMENT
2013 ESI Group

INSTALLATION GUIDE
(released: Aug-13)

Package Selection:

Fig 3: Package selection window

This dialog box is used to select all the software package(s).

Select all the platform package(s) you wish to install by clicking on the toggle(s):

Flexnet_v11.11.1.tar.bz2 package contains the FLEXnet Utilities

(lmgrd/lmutil) and ESI Group vendor daemon (pam_lmd) binaries version
11.11.1 for all UNIX or Linux platforms.

Linux-64Bit.tar.bz2 contains the 64-bit binaries for Linux x86_64 distributions.

Linux-32Bit.tar.bz2 contains the 32-bit binaries for Linux i686 distributions.

Installation on UNIX/Linux

INSTALLATION GUIDE
(released: Aug-13)

10

VISUAL-ENVIRONMENT
2013 ESI Group

Fig 4: Downloading log window

A scrolled window is displayed showing the downloading of files.

When downloading is finished, the previously grayed Close button will be highlighted.
Click on it to continue.

Installation on UNIX/Linux

VISUAL-ENVIRONMENT
2013 ESI Group

11

INSTALLATION GUIDE
(released: Aug-13)

The main dialog box window appears again to perform the next steps, the license
installation and/or customization of software environment.
Click on Exit button if you wish to perform the License installation and software
customization later.
Click on License management button and see the Installation of the License chapter for
details. A license file is needed to perform this task.
Click on Define environment button and see the Customization chapter for details.

Installation on UNIX/Linux

INSTALLATION GUIDE
(released: Aug-13)

12

VISUAL-ENVIRONMENT
2013 ESI Group

Directory Selector:

To navigate in the directory selector:

Click on this button when you want the current selection.
Click on this button to create a new directory in the current selection.
It will open this small window. Fill the text field with the new directory name to create
in the current selection.

Click on this button to go up of the current selection.

Click twice on the icon to go down in the selected directory.
Click on OK button to find the new license file on the local disk.

Installation on UNIX/Linux

VISUAL-ENVIRONMENT
2013 ESI Group

13

INSTALLATION GUIDE
(released: Aug-13)

INSTALLATION OF THE LICENSE

You must have a valid license file asked and received from your ESI Group
representative.
Before to start the license installation you should put the new or updated license file
provided by ESI Group representative to the following directory PAMHOME/licenses
with the filename pam_lmd.temp
This task should be done on the system where the license server will run.
It will install any valid license file.
It will install and run the license server(s) for floating license.

Installation on UNIX/Linux

INSTALLATION GUIDE
(released: Aug-13)

14

VISUAL-ENVIRONMENT
2013 ESI Group

Graphical Installation
To find the graphical license installation script, go to the software installation directory
and start it by typing the following command:
./paminst-gui.sh

lic

or

./paminst-gui.sh

install_lic

After the graphical tools are loaded in /tmp, the following assistant window appears:

Follow the instructions displayed in blue color.

Installation on UNIX/Linux

VISUAL-ENVIRONMENT
2013 ESI Group

15

INSTALLATION GUIDE
(released: Aug-13)

Get Host Id. Button

Click on Get host id. button to get the information (description, hostname, hostid) of the
system needed for license server installation (floating license) or standalone computer
(node-locked license). It will display the following window:

Installation on UNIX/Linux

INSTALLATION GUIDE
(released: Aug-13)

16

VISUAL-ENVIRONMENT
2013 ESI Group

Important remark on Linux i686 or x86_64 based distributions:

The FLEXnet Toolkit can only run on LSB3 (Linux Standard BaseTM) compliant Linux
distributions.
The LSB3 OS Compliant detail must display Yes otherwise your Linux distribution
cannot run a license server with this latest version of the FLEXnet Toolkit.
Check that the following package is installed on the station:

RedHat Based Operating Systems:

For RedHat, CentOS, Oracle Enterprise Server, Fedora : package redhat-lsb
How to check installation: rpm -q redhat-lsb
How to install it (as root or with sudo): yum install redhat-lsb

SUSE Based Operating Systems:

For SUSE Enterprise, openSUSE : package lsb
How to check installation: rpm -q lsb
How to install it (as root or with sudo): yast2 -i lsb

Debian Based Operating Systems:

For Debian, Ubuntu : package lsb
How to check installation: dpkg-query -l lsb
How to install it (as root or with sudo): apt-get install lsb

Installation on UNIX/Linux

VISUAL-ENVIRONMENT
2013 ESI Group

17

INSTALLATION GUIDE
(released: Aug-13)

License Directory Selection

By default, the text field is filled with the pathname of previous software installation
directory.
Click on and fill the text field with the pathname of the software installation directory or
click on Browse button to find it on the system.
Caution:

The specified directory in the text field should contain a licenses subdirectory
with write permission to highlight the Next button, else you cannot continue the
license installation at this step.

Click on Next button when the installation directory pathname is selected.

This dialog box selects and installs the license file in the right location.

Installation on UNIX/Linux

INSTALLATION GUIDE
(released: Aug-13)

18

VISUAL-ENVIRONMENT
2013 ESI Group

Click on Get another license file button to select a new license file.

Click on OK button to find the new license file on the local disk. A new file browser
window appears.

By default, the file filter is set for find PAM license file. Select the new license file then
click Open button to valid the selection. A small window displays the checking of the
license file selected with the host id of the host.

Installation on UNIX/Linux

VISUAL-ENVIRONMENT
2013 ESI Group

19

INSTALLATION GUIDE
(released: Aug-13)

The dialog box of license file selection will be displayed again and filled with the lines
of selected license file.

Once the file is selected the previously grayed Apply changes to new files button is
highlighted.
Click then on Save new file as current button. The new license file is installed and the
previously grayed Next button is highlighted to continue.
Click Next button to perform the starting of the license daemons. This will post another
dialog to start daemon now as current user.

Installation on UNIX/Linux

INSTALLATION GUIDE
(released: Aug-13)

20

VISUAL-ENVIRONMENT
2013 ESI Group

Click on Start daemon now as current user to start the daemon.

Installation on UNIX/Linux

VISUAL-ENVIRONMENT
2013 ESI Group

21

INSTALLATION GUIDE
(released: Aug-13)

Customization
Customization Tasks
The ESI Group software installation script, paminst.sh asks for customization.

This customization is done by pamcust.sh which can also be used separately. To

perform the customization separately, do the following:

Log in on the machine on which you want to perform customization.

Go to directory where the installation has been done.

Type ./pamcust.sh and follow the instructions.

The customization script creates definitions to allow access to the ESI Group
executables and configuration files for all users or for selected users, depending on the
method chosen by the installer. Most definitions are contained in a file provided by ESI
Software. These files are:

psi.Cenv for csh/tcsh user environment.

psi.Kenv for ksh (AT&T ksh or Public Domain ksh) user environment.

psi.Baenv for bash user environment.

sh is not supported due to its lack of functionalities required by ESI Group products.
We recommend sh users to migrate to ksh, which preserves sh syntax and habits. There
are mainly instructions added to system or site-specific files:

Installation on UNIX/Linux

INSTALLATION GUIDE
(released: Aug-13)

C Shell - .cshrc file

Korn Shell - .profile

Bourne Again Shell .bash_profile

22

VISUAL-ENVIRONMENT
2013 ESI Group

### ESI Group begin ###

#
#
ESI Group Software environment
#
setenv PAMHOME /home/ppg/ESIGroup
setenv PAMENV $PAMHOME/env-`uname`
if ( -r $PAMENV/psi.Cenv ) then
source $PAMENV/psi.Cenv
endif
### ESI Group end ###
### ESI Group begin ###
#
#
ESI Group Software environment
#
PAMHOME=/home/ppg/ESIGroup; export PAMHOME
PAMENV=$PAMHOME/env-`uname`; export PAMENV
if [ -r $PAMENV/psi.Kenv ]; then
. $PAMENV/psi.Kenv
fi
ENV=${ENV:}
If [ -z $ENV ]; then
ENV=$HOME/.kshrc; export ENV
fi
### ESI Group end ###
### ESI Group begin ###
#
#
ESI Group Software environment
#
PAMHOME=/home/ppg/ESIGroup; export PAMHOME
PAMENV=$PAMHOME/env-`uname`; export PAMENV
if [ -r $PAMENV/psi.Baenv ]; then
. $PAMENV/psi.Baenv
fi
BASH_ENV=${BASH_ENV:-}
If [ -z $BASH_ENV ]; then
ENV=$HOME/.bashrc; export BASH_ENV
fi
### ESI Group end ###

When the installer chooses to customize the process for selected users (using for
example .cshrc), he must repeat the customization process for each user repeatedly.

Installation on UNIX/Linux

VISUAL-ENVIRONMENT
2013 ESI Group

23

INSTALLATION GUIDE
(released: Aug-13)

X SERVER SETTINGS
FOR UNIX
Configure the X server to the following settings: True Color and 24-bit plane default
visual.

X Server Settings

INSTALLATION GUIDE
(released: Aug-13)

24

VISUAL-ENVIRONMENT
2013 ESI Group

INSTALLATION ON WINDOWS
MINIMUM REQUIREMENTS

Visual 32-Bit version:

o Windows XP Professional Service Pack 2
o Windows 2003
o Windows Vista
o Windows 2008
o Windows 7

Visual 64-Bit version:

o Windows XP x64 Edition
o Windows 2003 x64 Edition
o Windows Vista
o Windows 2008
o Windows 7
Note: On Windows Vista, it is recommended to work with Classic theme.

Administrative privileges recommended during installation.

x86 or x64 compatible processors (Intel, AMD ).

2 gigabytes of RAM recommended.

Super VGA monitor with the following settings:

o Screen resolution set to at least 1280 x 1024.
o Small fonts selected.

OpenGL hardware graphic accelerator (highly recommended). Systems without

an OpenGL graphic board will perform significantly slower.

2.5 GB disk (free) space required in the Program Files folder for each
version (3.8 GB for complete installation).

3 button mouse (middle button required for dynamic rotations in graphic

window).

Installation on Windows

VISUAL-ENVIRONMENT
2013 ESI Group

25

INSTALLATION GUIDE
(released: Aug-13)

INSTALLATION OF SOFTWARE
DVD Instructions
Insert the DVD into the disc drive.
Autorun is enabled on your computer.

The ESI Group software installation should start automatically.

When the InstallShield Wizard dialog box is displayed, follow the instructions.
Autorun is disabled on your computer.

Open a Windows Explorer window, click on your DVD drive icon.

You should find directory named VisualEnv90_Windows, which contains both 32Bit and 64-Bit versions of Visual-Environment 9.0
Double click on Setup.exe file found to start the software installation.
When the InstallShield Wizard dialog box is displayed, follow the instructions.
When the software installation is completed, the ESI group applications will be
available in the Start/Programs/ESI Group menu or in the ESI Group folder icon on
desktop.
Installing Visual-Environment 9.0 on command line

Visual-Environment 9.0 installation is powered by Microsoft Windows Installer. This

means that installation can be done graphically or silently using command line.
Open a command prompt (cmd.exe or command.com).
Syntax is:
msiexec /<parameters> "<Path to MSI setup file>" <PROPERTY>=<VALUE>

Installation on Windows

INSTALLATION GUIDE
(released: Aug-13)

26

VISUAL-ENVIRONMENT
2013 ESI Group

The parameters options available with Visual-Environment 9.0 are:

/I

Installs or configures a product.

/q[n|b|r|f]

Sets user interface level:

/q , /qn : No UI
/qb : Basic UI. Use "qb!" to hide the Cancel button.
/qr : Reduced UI with no modal dialog box displayed at the end of the installation.
/qf : Full UI and any authored FatalError, UserExit, or Exit modal dialog boxes at the
end.
/qn+ : No UI except for a modal dialog box displayed at the end.
/qb+ : Basic UI with a modal dialog box displayed at the end. The modal box is not
displayed if the user cancels the installation. Use "/qb+!" or "/qb!+" to hide the Cancel
button.
/qb- : Basic UI with no modal dialog boxes. Please note that "/qb+-" is not a supported
UI level. Use "/qb-!" or "/qb!-" to hide the Cancel button.
Note that the "!" option is available with Windows Installer 2.0 and works only with
basic UI. It is not valid with full UI.
The available PROPERTY options with Visual-Environment 9.0 are (case sensitive):

INSTALLDIR="<Path>"

Specify an installation directory, otherwise default

"%ProgramFiles%\ESI Group\Visual-Environment\9.0"

value

FLEX=FALSE

If you do not want to install the FLEXnet licensing toolkit. Default value
is TRUE in MSI table.

VE=32

Force installation of Visual-Environment 32-bit only, 64-bit version will

not be installed. Default is TRUE in MSI table (32b+64b versions)

VE=64

Force installation of Visual-Environment 64-bit only, 32-bit version will

not be installed. Default is TRUE in MSI table (32b+64b versions)
Example:
msiexec /i "<DriveLetter>:\VisualEnv90_Windows\ESI Group Visual-Environment 9.0.msi"
msiexec /i "<DriveLetter>:\VisualEnv90_Windows\ESI Group Visual-Environment 9.0.msi " /qbINSTALLDIR="D:\Program Files\ESI Group\Visual-Environment\9.0" VE=64
where <DriveLetter> corresponds to your CD/DVD drive.

When the software installation is completed, the product will be available in the
Start/Programs/ESI Group menu or in the ESI Group icon folder on the
desktop.

Installation on Windows

is

VISUAL-ENVIRONMENT
2013 ESI Group

27

INSTALLATION GUIDE
(released: Aug-13)

INSTALLATION
FOR
VISUALLOCAL MODEL ADVISOR (VLMA)
SYSWELD RESOURCE FILE UPDATION

VLMA 9.0 requires SYSWELD 2011.0 solver (preferably installed on the same
Windows system) with additional license key (welding) and some specific
resource directories for execution.

After Visual-Environment installation, please execute as administrator a script

for VLMA 9.0 resource installation. This script file (install_vlma.bat) is
available under VE Installation Directory/Windows-x86/Tools/VLMA path
for Windows x86 32-bit platform or VE Installation Directory/Windowsx64/Tools/VLMA path for Windows x86 64-bit platform.

Installation for Visual-Local Model Advisor (VLMA)

INSTALLATION GUIDE
(released: Aug-13)

28

VISUAL-ENVIRONMENT
2013 ESI Group

The install_vlma.bat script will prompt for the SYSWELD 2011.0 solver
installation path and accordingly create the resources required for VLMA 9.0.

This completes the installation for VLMA 9.0.

Installation for Visual-Local Model Advisor (VLMA)

VISUAL-ENVIRONMENT
2013 ESI Group

29

INSTALLATION GUIDE
(released: Aug-13)

INSTALLATION OF THE LICENSE

Before all, you must have a valid license file.
The license file is sent separately from the software installation.
See below How to get your FLEXnet License File.

HOW TO GET YOUR FLEXNET LICENSE FILE?

System information must be retrieved before you can request your FLEXnet license
files.

If

If request is a floating license file running on Windows, execute

c:\flexlm\lmtools.exe on the station that will be the license server.

Select System Settings.

Send all the information in the left part (Hostid Settings) to your local ESI
support representative. They will send the license file to you.

request

is

node-locked
based
license
file,
execute
c:\flexlm\lmtools.exe on each PC that will be running ESI Group
software.

Once you have received your license file(s), it/they must be moved to the appropriate
directory c:\flexlm on each machine with the file name pam_lmd.lic

Installation of the License

INSTALLATION GUIDE
(released: Aug-13)

30

VISUAL-ENVIRONMENT
2013 ESI Group

What to do if MAC address is "FFFFFFFF"?

The licensing tools see my hostid as "FFFFFFFF" when using a Virtual NIC even
though the ipconfig command will show a different hostid for the Virtual NIC.
Virtual NICs are no longer supported in FLEXnet 11.6 and newer versions of the
FLEXnet licensing software.
This is not a bug, but a deliberate change in FLEXnet software behaviour.
Workaround is to un-team these Ethernet adapters or enable a disabled adapter or install
a new Ethernet adapter.
If really not possible, "Disk Volume Serial Number" can eventually be used as server
hostid.

Installation of the License

VISUAL-ENVIRONMENT
2013 ESI Group

31

INSTALLATION GUIDE
(released: Aug-13)

STARTING THE FLEXNET LICENSE SERVER

Preliminary remark:

The FLEXnet license server installation must be done with administrator rights.

This section describes the initialization of a license server based on floating

license files. Node-locked license files do not require to start a server.

After ESI Group software has been installed, your pam_lmd.lic file must be moved
to the appropriate directory, updated and the FLEXnet license server started.
To move and update the license file:

Move your license file to the directory c:\flexlm and name it pam_lmd.lic

Using any usual text editor edit pam_lmd.lic and change $PAMHOME to
c:\flexlm\pam_lmd.exe on the line beginning with the DAEMON or
VENDOR keyword.

To start the license server:

Execute c:\flexlm\lmtools.exe

Select Service/License file and select Configuration using Services option (see
figure below).

Installation of the License

INSTALLATION GUIDE
(released: Aug-13)

32

VISUAL-ENVIRONMENT
2013 ESI Group

Select Configure Services, adjust parameters as below and click on Save Service.

Select Start/Stop/Reread and click on Start Server (see below).

After completing these installation steps, you may run the ESI Group software.

Installation of the License

VISUAL-ENVIRONMENT
2013 ESI Group

33

INSTALLATION GUIDE
(released: Aug-13)

INVOKING THE APPLICATION

WINDOWS
On installation of Visual-Environment, appropriate shortcuts are created on the desktop
under the folder ESI Group, as well as in the Startup menu. Execution of the required
shortcuts will invoke the appropriate application.

UNIX / LINUX
On installation, following alias shortcuts will be created in the user account.

visualenv Visual-Environment

vcast Visual-Cast

vcem Visual-CEM

vcd Visual-Crash DYNA

vcfd Visual-CFD

vcp Visual-Crash PAM

vcr Visual-Crash RAD

vform Visual-FORM

viewer Visual-Viewer

vlnas Visual-Life NASTRAN

vmedysa Visual-MEDYSA

vnvhia Visual-NVH & Interior Acoustics

vps Visual-VPS

vsafe Visual-Safe

vseal Visual-Seal

vshock Visual-Shock

vsm Visual-Safe MAD

vsystus Visual-SYSTUS

vvtm Visual-VTM

vweld Visual-Weld

vdbtools VDBTools for PAM

Execution of required alias shortcuts will invoke appropriate application.

Invoking the Application

INSTALLATION GUIDE
(released: Aug-13)

34

VISUAL-ENVIRONMENT
2013 ESI Group

TROUBLESHOOTING
The Windows Installation does not start automatically.

Check with regedit tool the registry key HKLM\SYSTEM\CurrentControlSet

\Services\Cdrom is set to 1 (i.e. autorun enabled))
How to override CD drive protection on Linux:

In newer Linux distributions, DVD/CD-ROM drives may be protected to not run

malicious code. This means that users do not have the right to execute scripts directly
from the drive.
The script INSTALL.SH can override this protection.
The following error message may appear:

/media/VisualEnv90/INSTALL.SH:
/bin/sh: bad interpreter: Permission denied

It means the drive is protected and has the noexec mount option.
You can follow these instructions to get around:

Copy INSTALL.SH script in a temporary directory.

Execute it by giving the drive mount point as argument.

Troubleshooting

VISUAL-ENVIRONMENT
2013 ESI Group

35

INSTALLATION GUIDE
(released: Aug-13)

Example:

If /media/VisualEnv90 is the drive mount point:

mkdir install_temp
cd install_temp
cp /media/VisualEnv90/INSTALL.SH .
./INSTALL.SH /media/VisualEnv90
#################################################################
ESI Group Softwares GUI Installation Manager Script Launcher
Copyright 1998 ~ 2013
ESI GROUP
#################################################################
Creating temporary installer directory... done.
-------------------------------------------------------------------Invoking installation of Visual-Environment 9.0
-------------------------------------------------------------------ESI Group GUI INSTALLATION MANAGER SCRIPT
Copyright 1998~2013,
ESI GROUP
This script manages the gui scripts.
To start the ESI Group software installation (from the CD only)
Type
'./Paminst-gui.sh'
or
'./Paminst-gui.sh paminst'
To start the license management (from the target directory only)
Type
'./Paminst-gui.sh lic'
or
'./Paminst-gui.sh install_lic' still accepted for
compatibility.
-------------------------------------------------------------------Unloading installation tools, 15 Mb are necessary in /tmp, please
wait...
Tools ready.

Only scripts files are copied in this temporary installer directory, archives containing
the files to install are on the media.

Troubleshooting

INSTALLATION GUIDE
(released: Aug-13)

36

VISUAL-ENVIRONMENT
2013 ESI Group

The ESI Group Software will not run.

If you cannot run ESI Group software because of the error

"Cannot connect to license server ... WinSock error code"

or
"Warning -15 = Cannot connect to license server..."

The FLEXnet License Server is not installed or is not running.

In the Control Panel, under Services check if the FLEXnet License Server is
listed as a service. It should be listed as:
FLEXnet License Server

Started

Automatic

If the FLEXnet License Server is not listed:

Open a command window.

cd c:\flexlm

install c:\flexlm\lmgrd.exe

Check the Services list again.

Select the FLEXnet License Server.

Click the Start button.

The license server should start and the listing be updated.

If listed, but the status field is blank:

Select the FLEXnet License Server.

Click the Start button.

Troubleshooting

VISUAL-ENVIRONMENT
2013 ESI Group

37

INSTALLATION GUIDE
(released: Aug-13)

After launch, Visual-Environment behaves erratically:

It is possible that some data stored in Application Data Folder(*) is corrupted.

Rename this folder, re-launch Visual-Environment and continue working.
Send the contents of the renamed folder to your local support teams for problem
identification.
Remark: This method may lose some personal customization of the environment.
(*) Application Data Folder refers to:

Linux : directory $HOME/.mwesi/9_0

Windows: directory %APPDATA%\ESI\9_0

The license server should start and the listing must be updated:

Troubleshooting

If Visual-Environment crashes on Linux workstations, use the command

productname -cleanup for cleanup.

While invoking the product on Linux, if you encounter an error which says
.Menu Not found, try productname newreg.

On Linux, if the product aborts which invoking, clean up the /tmp directory.

Linux focus policy' should be 'click to focus'; if it is set to focus under mouse
the application may not work.

INSTALLATION GUIDE
(released: Aug-13)

38

VISUAL-ENVIRONMENT
2013 ESI Group

SOFTWARE AUTHORIZATION
The software is licensed by FLEXnet version 11.11.1
Floating license server must be upgraded with the latest delivered version of the
toolkit, version 11.11.1
The license search order is done as follows:
1. PAM_LMD_LICENSE_FILE environment variable.
2. Linux: file $HOME/.flexlmrc
Windows: registry key PAM_LMD_LICENSE_FILE in
HKLM \ Software \ FLEXlm License Manager \.
3. LM_LICENSE_FILE environment variable.
4. Default license file location:
Linux: $PAMHOME/licenses/pam_lmd.lic
Windows: C:\flexlm\pam_lmd.lic
You should be an authorized user to execute Visual-Environment on your system.
Please check with your System Administrator to get the system information details.
You must get a license from ESI to execute Visual-Environment. You need to provide
the following information to obtain a license:

Type of License (trial/demo/formal) - required

Machine ID - required

IP address of the machine.

Platform or machine type such as SGI, HP, SUN or NT - required

Port ID to be used for license access.

To obtain the machine ID, execute the following command in your system:

HP: uname -i

IBM: uname -m

SUN: hostid

Linux: /sbin/ifconfig -a or /sbin/ip addr

Windows: ipconfig /all and provide ESI with the physical address from the list.

All platforms: lmhostid (tool provided in FLEXnet binaries).

Software Authorization

VISUAL-ENVIRONMENT
2013 ESI Group

39

LICENSE REQUEST
For license request, please contact the following address:
ESI Group
Parc dAffaires Silic
99, rue des Solets - BP 80112
94513 Rungis Cedex - France
Phone: +33 (0)1 49 78 28 00
Fax:

+33 (0)1 46 87 72 02

Email: distrib.license@esi-group.com
http://www.esi-group.com

License Request

INSTALLATION GUIDE
(released: Aug-13)