Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  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 <installation_DVD>
                      \CLI\psin_framework_install.bat
                      <full_path_to_XML_parameters_file>
    UNIX  

...

  1.        <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.

...

  1. 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:

    ...

      • <precise_root>/logs/psin_framework_install.out

    ...

      • <precise_root>/logs/infra.CLI.log

    If installation is successful, a message appears "Framework install setup process done".

    Info

    ...

    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 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.

    ...