Page History
...
-parametersfile <precise_for_oracle_installation_parameters_file_name>
UNIX ./infra/bin/psin_cli.sh
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action setup
-parametersfile <precise_for_oracle_installation_parameters_file_name>
About the Precise for Oracle parameter file
You need to prepare the Precise for Oracle parameter file by creating an XML file with elements that represent the installation parameters and inserting the appropriate values.
The following is an example of a Precise for Oracle parameters file:
<parameters>
<parameter name="setup-process" value="apptier-OR"/>
<parameter name="setup-mode" value="install"/>
<parameter name="collector-server-machine-name" value="server5"/>
<parameter name="instance-name" value="ORCL"/>
<parameter name="oracle-home" value="C:\oracle\product\10.1.0\Db_1"/>
<parameter name="oracle-version" value="100"/>
<parameter name="oracle-port" value="1521"/>
<parameter name="oracle-dba-user" value="system"/>
<parameter name="oracle-dba-clear-password" value="dba"/>
<parameter name="oracle-connect-as" value="SYSDBA"/>
<parameter name="oracle-create-new-user" value="true"/>
<parameter name="oracle-i3-user" value="I3_OR_1234"/>
<parameter name="oracle-i3-clear-password" value="mypassword"/>
<parameter name="installation-cd-path" value="d:\"/>
</parameters>
The following table describes the updated elements of the parameter file. Element names marked with an asterisk (*) can be updated after installation.
Table 2-10 Elements of the Precise for Oracle parameter file
Element Description
installation-cd-path Indicates the absolute path to the folder where the Precise v9.6 download was downloaded to.
Values: String
Mandatory: Yes
setup-process Setup process. always apptier-OR Mandatory: Yes
setup-mode* Setup mode.
Values: install, edit, uninstall
Mandatory: Yes
collector-server-machine-name Name of the server on which the Precise for Oracle Collector will be installed.
Values: String
Mandatory: Yes
environment-name Name of the application.
Values: String
Mandatory: Yes, for a federation installation
instance-name Oracle instance name (SID).
Values: String
Mandatory: Yes
oracle-home* Full path of Oracle home.
Values: String
Mandatory: Yes
oracle-version Oracle instance version
Values: 81, 90, 100, 110
The values represent the following versions:
81 = Version 8.1
90 = Version 9.0
100 = Version 10
110 = Version 11
Mandatory: Yes
oracle-port* Oracle instance Listener port.
Values: Numeric
Mandatory: Yes
oracle-dba-user User name for Oracle user with DBA privileges. Will only be used during installation.
Values: String
Mandatory: Yes
oracle-dba-encrypted-password Password for Oracle user with DBA privileges. Will only be used during installation.
Values: Encrypted String
Mandatory: Yes
Alternatively the oracle-dba-clear-password can be used, allowing you to specify a clear password instead of an encrypted string.
See Encrypt command on page 148.
oracle-connect-as Connection option for Oracle user with DBA privileges.
When using a manual schema (see the "How to manually install Precise for Oracle database schemas" section in the Precise Installation Guide), this must be specified as Normal.
Values: SYSDBA, Normal
Mandatory: Yes
network-ports Oracle listener ports.
Specify all the ports you want the Insight Savvy for Network to sample. At least one port must be specified.
Values: port=x||port=y (for example: port=1111||port=2222)
Mandatory: Yes if Install-network is ‘true’.
oracle-create-new-user Indicates whether the oracle-i3-user is an existing user or the installation should create a new user.
Values: (true/false)
Mandatory: Yes
NOTE: If an Oracle DB schema has been installed manually before the current collector installation, then this parameter should appear explicitly in the parameters file and its value must be "false".
oracle-i3-user User name of the Oracle user who owns the Precise for Oracle schema.
Values: String
Mandatory: Yes
oracle-i3-encrypted-password Password of the Oracle user who owns the Precise for Oracle schema.
Values: Encrypted String
See Encrypt command on page 148.
Mandatory: Yes
Alternatively the oracle-i3-clear-password can be used, allowing you to specify a clear password instead of an encrypted string.
oracle-sap-system-name The SAP system name.
Values: String
Mandatory: Yes, if install-sap-inter-point is true.
oracle-sap-default-application-server The Application server name used to create the first connection with the SAP system.
Values: String
Mandatory: Yes, if install-sap-inter-point is true.
oracle-sap-system-number The SAP system number.
Values: String
Mandatory: Yes, if install-sap-inter-point is true.
oracle-sap-user The SAP system user name.
Values: String
Mandatory: Yes, if install-sap-inter-point is true.
oracle-sap-encrypted-password The SAP system encrypted password.
Values: Encrypted String
Mandatory: Yes, if install-sap-inter-point is true.
See Encrypt command on page 148.
Alternatively the sap-clear-password can be used, allowing you to specify a clear password instead of an encrypted string.
oracle-sap-client-id The client ID used to create the first connection with the SAP system.
Values: String
Mandatory: Yes, if install-sap-inter-point is true.
apptier-name Name of the Tier.
Values: String
Mandatory: No
install-alert-customized Value: (true/false)
Mandatory: No
Set to true to in case you want to have customized alerts metrics for this instance.
oracle-tablespace-name Storage parameter for the Precise for Oracle schema. Indicates Tablespace name.
Values: String
Mandatory: No
oracle-tablespace-file Storage parameter for the Precise for Oracle schema. Indicates Tablespace datafile.
Values: String
Mandatory: No
oracle-tablespace-temp-name Storage parameter for the Precise for Oracle schema. Indicates Temporary tablespace name.
Values: String
Mandatory: No
oracle-tablespace-temp-file Storage parameter for the Precise for Oracle schema. Indicates Temporary tablespace file.
Values: String
Mandatory: No
install-psoft-extension* Installs the PeopleSoft extension
Values: true, false
Mandatory: No
install-sap-inter-point Indicates whether you want to install a SAP Interpoint.
Values: true, false
Mandatory: No
oracle-history-size* Oracle session information period (in hours).
Values: 1, 2, 4, 8, 12, 24, 28
Mandatory: No
oracle-collapse-statements* Collapses statements with different constants in their text into single statements with bind variables.
Values: true, false
Mandatory: No
install-storage-type* Install Precise for Storage.
Values: empty - for no Precise for Storage ORXP - for HP crosspoint storage
Mandatory: No
oracle-tablespaces-folder Storage parameter for the Precise for Oracle schema. Indicates the folder in which datafiles are stored.
Values: String
Mandatory: No
install-network* Associates Oracle activity with network statistics.
Values: true, false
Mandatory: No
oracle-cluster-name Oracle instance cluster name
Values: string
Mandatory: No
oracle-connection-pool-server Server name used in the connection pool for the Oracle instance. In case this parameter is not supplied, the collector-server-machine-name is used.
The Precise Oracle FocalPoint creates JDBC connections to the Oracle instance. Use this parameter in case you want the Oracle FocalPoint to connect to the instance using a server name different than the server name specified in collector-server-machine-name parameter.
Value: String
Mandatory: No
Installing Precise for Storage with the Precise CLI utility
Installing Storage Tier Collectors on a server enables you to sample Storage instances on the server. Before installing Storage Tier Collector with the CLI utility, verify the following
• The Precise for Oracle FocalPoint or Precise for SQL Server FocalPoint is installed.
• The Precise Listener has been installed on the server where Precise for Storage agent is to be installed.
To install Precise for Storage with the Precise CLI utility
1. Create the Precise for Storage parameter file and save it to the <precise_root> folder on the main Precise FocalPoint. You can also set up this file in advance. For more information, see About the Precise for Storage parameter file on page 32.
2. Run the following command from the <precise_root> folder on the main Precise FocalPoint to execute the Precise CLI utility installation script.
Windows infra\bin\psin_cli.bat
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action setup
-parametersfile <precise_for_storage_installation_parameters_file_name>
UNIX ./infra/bin/psin_cli.sh
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action setup
-parametersfile <precise_for_storage_installation_parameters_file_name>
About the Precise for Storage parameter file
You need to prepare the Precise for Storage parameter file by creating an XML file with elements that represent the installation parameters and inserting the appropriate values.
The following is an example of a Precise for Storage parameters file:
<parameters>
<parameter name="setup-process" value="apptier-SM"/>
<parameter name="setup-mode" value="install"/>
<parameter name="collector-server-machine-name" value="sun3"/>
<parameter name="storage-type" value="EMC"/>
<parameter name="installation-cd-path" value="d:\"/>
</parameters>
The following table describes the updated elements of the parameter file.
Table 2-11 Elements of the Precise for Storage parameter file
Element Description
installation-cd-path Indicates the absolute path to the folder where the Precise v9.6 download was downloaded to.
Values: String
Mandatory: Yes
setup-process Setup process. always apptier-SM Mandatory: Yes
setup-mode Setup mode
Values: install, edit, uninstall
Mandatory: Yes
collector-server-machine-name Name of the server on which the Precise for Storage Collector will be installed.
Values: String
Mandatory: Yes
environment-name Name of the application.
Values: String
Mandatory: Yes, for a federation installation
apptier-name Name of the Tier.
Values: String
Mandatory: No
emc-database-file EMC Solution Enabler Database file location.
Values: String
Mandatory: No
emc-gatekeeper-enabled Enable remote gatekeeper.
Values: true or false
Mandatory: No
emc-gatekeeper-ip Remote gatekeeper server IP.
Values: String
Mandatory: Yes, if emc-gatekeeper-enabled is true.
emc-gatekeeper-port Remote gatekeeper server port.
Values: Numeric
Mandatory: Yes, if emc-gatekeeper-enabled is true.
emc-asm-enabled Enable Oracle ASM support for the EMC Storage agent.
Values: true or false
Mandatory: No
emc-asm-instance ASM instance name.
Values: String
Mandatory: Yes, if emc-asm-enabled is true.
emc-asm-port ASM instance port.
Values: String
Mandatory: Yes, if emc-asm-enabled is true.
emc-asm-home ASM instance home.
Values: String
Mandatory: No
emc-asm-user User name of an Oracle ASM user with DBA privileges.
Values: String
Precise. Performance intelligence from click to storage. Learn more > >
...