Agile Product Lifecycle Management Agile Configuration Propagation Guide Release 9.3.3 E39285-02 |
|
![]() Previous |
![]() Next |
This chapter describes details regarding how to install ACP.
To install ACP, you will need to know what operating system, application server, and version of Agile PLM are being used.
This is the operating system of the machine on which you intend to install ACP. The following operating systems work with ACP:
Windows family
UNIX family (for example: Solaris, Linux)
The versions of ACP and Agile PLM that will work together must be the same release. For instance, ACP933 works with Agile PLM 9.3.3, but it does not work with, for example, Agile PLM 9.3.0.2.
The ACP Installer installs a specific set of files depending on the application server with which you connect to PLM. For ACP to communicate with Agile PLM, ACP and Agile PLM must be running the same application server. ACP works with the following application servers:
Oracle Application Server (OAS)
WebLogic Application Server (WLS)
The installation directory is the directory (or folder) in which you want to install ACP. There are no restrictions to where you may install ACP; however, the installation directory you choose should not pre-exist. If it does exist, you will be cautioned and asked if you want to proceed. If you do proceed, the existing directory will be purged.
The ACP Installer offers a default directory to install to, but you should be clear before installing exactly what directory is in line with your site installation policy.
Downloading Java Runtime Environment and the ACP Installer are prerequisites for installing ACP.
To install ACP on a Windows-based system, follow the steps below.
The ACP Installer is contained in a standard ZIP file. You can unzip the files to a directory of your choice.
It takes two minutes or less to set up and install ACP.
The ACP Installer is an (Apache) Ant-based installer. It must be run from a command window.
Change the directory to the directory in which you unzipped the ACP Installer.
Use the following steps to run the installer script.
Set JAVA_HOME
In order to run the ACP Installer, the environment variable JAVA_HOME must be set; it should be set to where you installed Java JRE 1.6.
SET JAVA_HOME=<Java JRE 1.6 Directory>
Run Installation Script
Run the specific installation script to install ACP on Windows systems:
install_win
When the script starts, the Oracle/Agile splash screen is presented, which indicates progress of the installer as it is working.
Answer Prompts
The installer prompts you for required information. The prompts have default responses indicated by brackets ([]). Press the Enter key to accept the default response.
a. Are you sure you want to install this version of ACP? ([y], n)
Just above this prompt, the ACP Installer displays the version of ACP that will be installed. Please verify that this is the version you intended to install. If it is not, you must respond "n" to this prompt.
b. Select App Server Platform to use? ([oas], wlsThe application server platform is based on the application server used by the Agile PLM instance to which ACP will connect. You can enter only an abbreviation to designate the application server:
Oracle App Server: oas
WebLogic App Server: wls
c. Enter directory to install ACP?[C:\Agile\ACP<####>]
This is the directory to which the ACP binaries and other files will be installed. The ACP Installer tries to provide a reasonable default location for you to install ACP, but you can use another location. "<####>" represents the version of Agile PLM with which this version of ACP works.
d. Enter the work directory to use with ACP?[C:\Agile\ACPWork<####>]
This is the directory where you will create ACP project directories; ACP is run from a project directory. This directory can be relative to the installation directory you entered, or it can be a completely separate directory tree. "<####>" represents the version of Agile PLM with which this version of ACP works.
e. The chosen ACP install directory already exists. Do you want to continue? (y, [n])
This prompt appears only when the install directory you specify already exists. This prompt cautions you about potentially installing over another application or overwriting an inappropriate directory. If you wish to continue, you must enter "y" as a response.
To install ACP on a UNIX- or Linux-based system, follow the steps below.
The ACP Installer is contained in a standard ZIP file. You can unzip the files to a directory of your choice. When unzipping the ZIP file, use the -a option to make sure text files are extracted properly.
unzip -a acp_install.zip
For UNIX and Linux users, the ACP Installer must be prepared for execution. This is simply a matter of making the appropriate install script executable. The script exists in the directory to which you extracted the ACP Installer ZIP file.
chmod u+x install_unix
It takes two minutes or less to set up and install ACP.
The ACP Installer is an (Apache) Ant-based installer. It must be run from a terminal window.
Change the directory to the directory in which you unzipped the ACP Installer.
Set JAVA_HOME
In order to run the ACP Installer, the environment variable JAVA_HOME must be set; it should be set to where you installed Java JRE 1.6.
JAVA_HOME=<Java JRE 1.6 Directory>
Run Installation Script
Run the specific installation script to install ACP on UNIX/Linux systems:
install_unix
When the script starts, the Oracle/Agile splash screen is presented if X11 is running on your system. This indicates progress of the installer as it is working.
Answer Prompts
The installer will prompt you for the required information. The prompts have default responses indicated by brackets ([]). Press the Enter key to accept the default response.
a. Are you sure you want to install this version of ACP? ([y], n)
Just above this prompt, the ACP Installer displays the version of ACP that will be installed. Please verify that this is the version you intended to install. If it is not, you must respond "n" to this prompt.
b. Select App Server Platform to use? ([oas], wls)
The application server platform is based on the application server used by the Agile PLM instance to which ACP will connect. You can enter only an abbreviation to designate the application server:
Oracle App Server: oas
WebLogic App Server: wls
c. Enter directory to install ACP?[/opt/Agile/ACP<####>]
This is the directory to which the ACP binaries and other files will be installed. The ACP Installer tries to provide a reasonable default location for you to install ACP, but you can use another location. "<####>" represents the version of Agile PLM with which this version of ACP works.
d. Enter the work directory to use with ACP?[/<Home>/<user>/ACPWork<####>]
This is the directory where you will create ACP project directories; ACP is run from a project directory. This directory can be relative to the installation directory you entered, or it can be a completely separate directory tree. "<####>" represents the version of Agile PLM with which this version of ACP works.
e. The chosen ACP install directory already exists. Do you want to continue? (y, [n])
This prompt appears only when the install directory you specify already exists. This prompt cautions you about potentially installing over another application or overwriting an inappropriate directory. If you wish to continue, you must enter "y" as a response.
The following sections describe post-installation tasks.
You might require multiple instances of ACP to work with multiple versions of Agile PLM, for example, if you are beginning the Upgrade process to a new PLM release but must maintain updates in the earlier, live version of PLM.
Folder | Description |
---|---|
\Agile PLM | where Agile PLM is installed |
\ACP | where ACP client is installed |
ACP\ < version > | level for multiple instances of ACP |
ACP\< version >\bin
ACP\< version >\classes ACP\< version >\lib etc. |
standard installed directories |
The following directories are owned by the installation. Do not modify the files in these directories, as they are subject to change without notice.
ant - contains a subset of the Ant utility. ACP uses Apache Ant for project management.
bin - contains scripts to run the ACP utility programs
classes - contains text resources that may be localized (that is, translated) or customized
lib - contains the set of libraries that are required for the ACP utility.
schema - contains the schema file for the ACP Control File
schema / docs - contains the online documentation for the ACP Control File, acp_control_file.html
templates - contain template project files and property files
It is a best practice that you organize your configuration needs into "projects". Each project is maintained in a separate project folders. Project folders are contained in the work directory specified when ACP is installed.
This topic is the starting point for the next chapter, "Running ACP".