Installation with Precise CLI
This section includes the following topics:
• Installing the Precise Framework
• Installing Precise FocalPoints
• Installing Servers
• Installing secured servers with the Precise CLI utility
• Updating services Authentication using the Precise CLI Utility
• Installing a Tier with the Precise CLI utility
• Extricate command
• Edit & uninstall
• Installing a new instance while keeping historical data from an old instance
Installing the Precise Framework
The Precise Framework can be installed directly from the Precise v9.6 download onto the Precise FocalPoint server. You can use the Precise CLI utility to install the following Framework components:
• Precise FocalPoint
• PMDB FocalPoint
• Alerts FocalPoint
• Report Manager FocalPoint
• Insight FocalPoint
• TPM FocalPoint
For information on manually installing the PMDB schemas, see the Precise Installation Guide.
How to install the Precise Framework
Install the Precise Framework by performing the following steps:
1. Prepare XML parameters file to specify the Framework installation parameters and log in to the server on which you have planned to install the Precise FocalPoint.
2. On this server, run the following command from the <precise_root> folder to install the CLI utility installation script:
Windows <installation_DVD>
\CLI\psin_framework_install.bat
<full_path_to_XML_parameters_file>
UNIX <installation_DVD>
/CLI/psin_framework_install.sh
<full_path_to_XML_parameters_file>
After running the script, you may be required to perform manual post-installation tasks to complete the installation.
3. If an error occurs, fix the problem and rerun the installation scripts. (In the case of an error, there is no need to delete the installation files.) If a critical error occurs before the Precise FocalPoint is installed, an error message is displayed. At the end of CLI utility installation, a message appears "Installation complete - check logs for details". The relevant logs for installation are as follows:
o <precise_root>/logs/psin_framework_install.out
o <precise_root>/logs/infra.CLI.log
If installation is successful, a message appears "Framework install setup process done".
NOTE For Windows Server which has the User Account Control enabled, you must run this command using Administrator permissions: Click Start Menu, right-click Command Prompt, click "Run as administrator", click Continue button, to approve the operation. Run the command specified above.
About the Precise Framework parameter file
You need to prepare the Framework parameter file by creating an XML file with tags that represent the installation parameters and inserting the appropriate values.
The following is an example of a server parameters file:
<parameters>
<parameter name="setup-process" value="framework"/>
<parameter name="setup-mode" value="install"/>
<parameter name="installation-cd-path" value="d:\"/>
<parameter name="i3fp-server-machine-name" value="server1"/>
<parameter name="dbms-type" value="mssql"/>
<parameter name="dbms-instance" value="DATABASE1"/>
<parameter name="dbms-database" value="PWV8"/>
<parameter name="dbms-dba-user" value="pwv8"/>
<parameter name="dbms-dba-clear-password" value="mypass"/>
<parameter name="gui-port" value="20820"/>
<parameter name="gui-shutdown-port" value="20821"/>
<parameter name="server-machine-installation-folder-server1" value="d:\precise"/>
<parameter name="server-machine-port-server1" value="20802"/>
</parameters>
The parameters file is an XML file containing a list of parameters for a Precise framework installation.
Table 2-1 Elements of the Precise framework parameter file
Element Description
server-machine-installation-folder-server-name Indicates the folder in which Precise installation files are stored.
Values: String
Mandatory for Precise FocalPoint Server: Yes
Mandatory for other servers: Yes, unless you prefer to perform a manual installation.
server-machine-port-server-name Port of the Precise Listener on the local server.
Values: Numeric 1025–65535
Mandatory: Yes
setup-process Marked always as framework.
Mandatory: Yes
setup-mode Must be in one of the following modes:
■ install (used to install Precise Framework)
■ edit (used to update Precise Framework)
■ uninstall (used to uninstall Precise Framework)
Mandatory: Yes
installation-cd-path Indicates the absolute path to the folder where the Precise v9.6 download was downloaded to.
Values: String
Mandatory: Yes
i3fp-server-machine-name Name of the Precise FocalPoint server. The name must be written in lowercase letters only. Can be a fully qualified name or IP address.
Values: String
Mandatory: Yes
gui-port Port of the Graphics User Interface (GUI) server.
Values: Numeric 1025–65535 (must not be identical to other ports specified)
Mandatory: Yes
gui-shutdown-port Local port for controlling the GUI.
Values: Numeric 1025 -65535 (must not be identical to other ports specified)
Mandatory: Yes
server-machine-service-unique-id-server-name A unique name used in the installation of all Precise agents. This is used if you want to support more than one Precise installation system on the server (for example, in cluster applications).
Relevant only for Windows servers.
Values: Alphanumeric
Mandatory: No
pw-server-machine-name Name of the PMDB FocalPoint server. The name must be written in lowercase letters only.
Values: String
Mandatory: No, defaults to the Precise FocalPoint.
alerts-server-machine-name Name of the Alerts FocalPoint server. The name must be written in lowercase letters only.
Values: String
Mandatory: No, defaults to the Precise PMDB FocalPoint.
foresight-server-machine-name Name of the Report Manager FocalPoint server. The name must be written in lowercase letters only.