2 Installing Agile PLM

2.1 Copying the Agile PLM Files

Before installing Agile PLM, the contents of the media packs should be copied to a local directory with the same file structure used by the Installer. The Platforms directory must be copied into the same directory as the setup file.

Note: Be sure to check the size of the media packs after copying the files to verify that all files have been copied.

2.2 Starting the Agile PLM Installer

Important: Install and test this release on a designated test server before installing it on your production environment. Your test environment should mirror your production environment as closely as possible to provide accurate testing results. It is important to validate the installation of this release and confirm your integrations are working correctly as part of your minimum due diligence. Any problems or questions noted during your system testing should be resolved before installing this release on your production environment.

The Agile PLM installer is a Java program. The installation of all components follows the same initial process up through the panel where you select the components to install.

The Agile PLM installer displays in English only, even on non-English operating systems.

Before running the installer, make sure

• On UNIX: You are not logged in as the root user. You should be logged in as the same user used to install the application server software.

• You have enough available disk space. Refer to the Agile PLM Capacity Planning Guide for specific values.

Windows: at least 1.1GB of available disk space

UNIX: at least 1.2GB of available disk space on the drive where your default Temp directory is located.

• You have disabled virus protection.

If virus protection is enabled, components used in the installer can be falsely identified as being infected and lock up the installation. You can enable virus protection after the installation is complete.

• On Linux, the installer requires some 32-bit shared libraries that may not be installed on your system.

  1. Install the 32-bit packages that provide the following shared libraries, if they are not present:

     /usr/lib/libXtst.so - this library is typically found in package libxtst-devel

     /usr/lib/libXrender.so - this library is typically found in package libXrender-devel

     
     

     Note: 32-bit packages for Linux often end in or include one of the following strings: i686, i586, i386.

     
     

  2. Run the Agile PLM application installer. The GUI should display.

     If the GUI does not display, run in debug mode and upload the install log file for analysis. If you run export LAX_DEBUG=true in the shell, and then start the installer from that shell, you may receive specific information about the missing library that is causing the runtime link error.

To start the Agile PLM installer on Windows:

1. Log in to the computer using a login with local Administrator permissions.

2. 
   

   Note: If there is insufficient Temp disk space available to complete the installation, you will be prompted for another location. Click Choose, select another drive, click OK, and the installer will start.

   
   

   In the Disk1_Windows directory, double-click the setup_win.exe file.

   After a few moments, the Welcome screen appears.

3. For information about any screen in the installer, click Help.

To start the Agile PLM installer on UNIX:

1. Log into the system.

2. Open a terminal window and set the DISPLAY environment variable to your X Windows server.

   
   

   Note: The Agile PLM Installer is a graphical application and requires an X server to perform the installation.

   
   

3. Go to the directory where you copied the Agile PLM files. Locate the setup_<OS>.bin file, and run the program by typing the following:

   • AIX: ./setup_aix.bin

   • Linux: ./setup_lin.bin

   • Solaris (SPARC): ./setup_sol.bin

   • Solaris (X86): ./setup_solx86.bin

   • HP-UX: ./setup_hpux_bin

   
   

   Note: Agile PLM for HP-UX is certified on a different WebLogic Server version than the other operating systems and a manual workaround is required before installing the application server component. See "Installing Agile PLM on HP-UX with WebLogic Server 12.1.2".

   
   

   After a few moments, the Welcome screen appears.

   For information about any screen in the installer, click Help.

2.3 Installer Online Help

Each installation panel has online help. At any time during installation, you can click Help for more information about the panel's options.

Note: If you leave the online help window open, it will be updated when you proceed through the installer panels. Otherwise, click Close at the bottom of the help window.

2.4 Installer Buttons

Agile PLM installation panels have the following buttons:

• Cancel -- Exits from the installation program.

• Help -- Displays online help.

• Previous -- Returns to the previous step.

• Next -- Proceeds to the next step.

• Install -- Starts installing. The Install button appears only on the Pre-Installation Summary panel, after you have specified installation options.

• Done -- Exits from the installation program. On Windows, after installing certain components you can choose whether to restart the computer when you click Done. The Done button appears only on the Install Complete panel, after you have finished installing.

2.5 Agile PLM Installation Modes

When installing Agile PLM, you can install in Basic or Advanced mode. Basic mode can be selected if you are installing a standalone system and choose to accept the default settings for virtual paths and authentication accounts. Advanced mode allows you to install a clustered system and change or accept the following system defaults on a standalone system:

• Agile Application Server Virtual Path (default: Agile)

• File Manager User Authentication (default:ifsuser)

• File Manager Virtual Path (default: Filemgr)

• Update the application URLs (Web Server, Java Client, File Manager) in the database (default:yes)

2.6 Agile PLM Installation Folders

After you install Agile PLM, the following folders appears in the AGILE_HOME directory.

This list includes the folders for all Agile PLM components, although it is not necessary that you install them all on one computer.

Folder	Description
agileDomain	Agile Application Server
FileManager	Agile File Manager
Install	Installation and configuration scripts
integration	Agile Integration Framework (AIF) products, such as Agile Integration Services (AIS) and Agile SDK
jdk	Java Development Kit 1.7.0_11
Uninstaller	Agile PLM Uninstaller