Page History
...
Info |
---|
To promote efficiency, servers can also be installed automatically. For more information, see Auto Deploymentdeployment. |
Before installing a server using the CLI utility, verify the following issues:
...
Element | Description | ||
---|---|---|---|
setup-mode | Setup mode that is used. Values: install, edit, uninstall Mandatory: Yes | ||
setup-process | Setup process. Value: always server. Mandatory: Yes | ||
handle-server-machine-name | Name of the local server. Can be a fully qualified name or IP address. The server name must be recognized by the Precise FocalPoint server, for example, it should be registered in DNS. Values: String Mandatory: Yes | ||
server-machine-port-server-name | Port of the Precise Listener on the local server. Values: Numeric 1025–65535 Mandatory: Yes | ||
i3fp-server-machine-name | Name of the Precise FocalPoint server. Can be fully qualified name or IP address. The Precise FocalPoint server name must be recognized by the newly added server, for example, it should be registered in DNS. Values: String Mandatory: Yes | ||
server-machine-port-i3fp-server-name | Port of the Precise FocalPoint Listener. Replace i3fp-server-name with the name of Precise FocalPoint as shown in Precise GUI. Values: Numeric 1025–65535 Mandatory: Yes | ||
server-machine-use-communication-relay -server-name | The Communication Relay provides a solution to a firewall restrictions problem. For more details see the Precise Installation Guide. Value: (true/false) Mandatory: No. | ||
environment-name | Related application name. Values: String Mandatory: Yes, in case of federation installation. | ||
server-machine-service-authentication-user-server-name | User account name for Precise services on the server. Values: String Mandatory: Only if server-machine-service-authentication-mode-server-name is set to "user". | ||
server-machine-service-authentication-encrypted-password-server-name | Password for the user specified in server-machine-service-authentication-user-server-name. Values: Encrypted String Mandatory: Only if server-machine-service-authentication-mode-server-name is set to "user". Alternatively the server-machine-service-authentication-clear-password-server-name can be used, allowing you to specify a clear password instead of an encrypted string. For more information, see Encrypt command. | ||
server-machine-service-authentication-domain-server-name | Domain of user specified in server-machine-service-authentication-user-server-name. Values: String Mandatory: Only if server-machine-service-authentication-mode-server-name is set to "user". | ||
server-machine-service-unique-id-server-name | A unique services suffix used in the installation of all Precise agents allows installation of several Precise installations folders on the same server. Relevant only for Windows servers. Values: String Mandatory: No | ||
server-machine-service-authentication-mode-server-name | Server authentication mode. Precise services are using LocalSystem account. to specify other user account specify "user", and use: server-machine-service-authentication-user-server-name to specify the authentication details: Values: user or localsystem Mandatory: No | ||
server-machine-secured-protocol-server-name | The secured installation is using an existing security protocols and methods such as blowfish and SSH to ensure that the communication encryption keys are safely copied to the target server. Value: true, false Mandatory: No | ||
server-machine-security-clear-password-server-name | Security password. Value: String Mandatory: Only on secured remote Manual installation. | ||
server-machine-install-user-server-name | User name required to install the Precise Listener on the server. Will only be used during installation. Value: String Mandatory: Only on secured remote automatic installation. | ||
server-machine-install-encrypted-password-server-name | Password for the user, required for using Precise Listener services on the server. Values: Encrypted String Mandatory: Yes, unless you prefer to perform a manual server installation. Alternatively the server-machine-install-clear-password-server-name can be used, allowing you to specify a clear password instead of an encrypted string. For more information, see Encrypt command. | ||
server-machine-installation-folder-server-name | Indicates the folder in which Precise installation files are stored. Values: String Mandatory: Yes, unless you prefer to perform a manual server installation. | ||
server-machine-flavor-server-name | Type of server. Must be in one of the following servers: Windows, UNIX Values: String Mandatory: Yes | ||
server-machine-use-jre-server-name | Indicates whether a Java-based Listener will be installed on the server or not.
Values: true, false. Default: true for servers whose OS supports JRE 1.6. You should use false if the server’s OS does not support JRE 1.6 or to reduce the memory footprint of the Precise Listener. Mandatory: No | ||
server-machine-bind-listener-address-server-name | Indicates whether the Precise Listener on this server should bind the specific server name or bind all the addresses on the given port. Values: true, false Mandatory: No | ||
server-machine-ssl-server-name | Indicates whether this Listener will function as an SSL Listener.
Values: true, false Default: false Mandatory: No For more information, see J2EE Remote Instance Monitoringremote instance monitoring. | ||
server-machine-ssl-port-server-name | Indicates the SSL port this Listener will listen too. Values: Integer Default: 443 Mandatory: No For more information, see J2EE Remote Instance Monitoringremote instance monitoring. | ||
server-machine-consumer-server-name | Indicates whether this Listener will function as a consumer that will pull data from SSL Listeners. Values: true, false Default: false Mandatory: No For more information, see J2EE Remote Instance Monitoringremote instance monitoring. | ||
server-machine-consume-target-server-name | Indicates a target server that contains an SSL Listener. By setting this parameter, the installed server will consume remote data only from the specified target server. If this parameter is not specified and the server-machine-consumer-server-name is set to true, the installed server will consume data from all servers that contain SSL Listeners. This parameter should only be set if the server-machine-consumer-server-name is set to true and you want to pull data from a specific SSL Listener.
Mandatory: No For more information, see J2EE Remote Instance Monitoringremote instance monitoring. |
Anchor | ||||
---|---|---|---|---|
|
...
- Installing Precise for Oracle with the Precise CLI utility
- Installing Precise for Storage with the Precise CLI utility
- Installing Precise for J2EE with the Precise CLI utility
- Installing Precise for Web with the Precise CLI utility
- Installing Precise for Microsoft .NET with the Precise CLI utility
- Installing Precise for SQL Server with the Precise CLI utility
- Installing Precise for SAP with the Precise CLI utility
- Installing Precise for Sybase with the Precise CLI utility
- Installing Precise for Sybase Replication Server with the Precise CLI utility
- Installing Precise for DB2 with the Precise CLI utility
- Installing a Tuxedo instance with the Precise CLI utility
- Installing a WebSphere MQ instance with the Precise CLI utilityInstalling an Oracle Applications instance with the Precise CLI utility
- Installing Other Tier Collectors with the Precise CLI utility
- Installing an OS instance with the Precise CLI utility
- Installing an extension for Siebel with the Precise CLI utilityInstalling Precise for vCenter Server with the Precise CLI utility
...
Element | Description | ||
---|---|---|---|
installation-cd-path | Indicates the absolute path to the folder where the Precise 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: 81100, 90110, 100120, 110180 The values represent the following versions: 81 100 = Version 8.110 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. | ||
oracle-connect-as | Connection option for Oracle user with DBA privileges. When using a manual schema, 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
| ||
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. 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 |
...
Element | Description | ||
---|---|---|---|
installation-cd-path | Indicates the absolute path to the folder where the Precise download was downloaded to. Values: String Mandatory: Yes | ||
setup-process | Setup process. always apptier-WW Mandatory: Yes | ||
setup-mode | Setup Mode Values: install, edit, uninstall Mandatory: Yes | ||
collector-server-machine-name | Name of the server of the Collector. Values: String Mandatory: Yes | ||
instance-name | The unique name of the Web server instance as identified on the Web server. This unique name helps to distinguish between several instances. Values: String Mandatory: No. This parameter is only relevant when the setup-mode is uninstall. | ||
instance-identifier | Used to create the instance name. Values: String Mandatory: Yes | ||
is-cluster | Indicates that this instance is part of a cluster. Values: (true/false). Can only be set to true for WebLogic and WebSphere. Mandatory: Yes | ||
show-historical-data | Indicates if historical data from the deleted instance is shown (true) or deleted (false) Values: true/false Mandatory: No. This parameter is only relevant when the setup-mode is uninstall. | ||
web-type | Indicates type of server where the Web server instance is running. Values: IIS, Apache, iPlanet, WebLogic, WebSphere, Tomcat, Sun ONE, SAP WAS J2EE, Oracle AS, Other J2EE, Other. Mandatory: Yes | ||
web-configuration-file | The full path for a Web server configuration file. Values: String Mandatory: Yes for Web Servers - Apache, iPlanet, WebLogic, Sun ONE, WebSphere, Tomcat, Oracle AS. Mandatory: Web Servers - IIS, Other, Other J2EE, SAP WAS J2EE should all be specified as empty parameter. | ||
web-apache-configuration-file | The full path for an Apache HTTP Web server configuration file. Values: String Mandatory: Yes, only for Oracle AS servers. | ||
web-server-version | The Web server version. Values: String For IIS: Mandatory: Yes Versions: 5.x, 6.x For Other, Other J2EE, SAP WAS J2EE. Mandatory: No For Apache: Mandatory: Yes. Versions: 1.3.x, 2.0.x, 2.2.x For WebLogic: Mandatory: Yes. Versions: 8.x, 9.x, 10.x For WebSphere: Mandatory: Yes. Versions: 6.0, 6.1-6.x, 7.x For Tomcat: Mandatory: Yes. Versions: 5.x, 6.x For iPlanet: Mandatory: Yes Version: 6.x For Sun ONE: Mandatory: Yes Version: 6.1 For Oracle AS: Mandatory: Yes. Version: "9.0.4.0.1 - 10.1.3" (Notice the additional spaces) | ||
web-real-name | The IIS Web site name. Values: String Mandatory: Yes, only for IIS servers. | ||
web-iis-instance-number | The IIS Web site number. Values: String Mandatory: Yes, only for IIS servers. | ||
web-application-used | The application served by this Web server site. Values: Web Siebel PeopleSoft Mandatory: Yes | ||
web-application-used-version | The application version served by this Web server site. Values: String For PeopleSoft: Mandatory: Yes Values:
Values: Do not enter a value. For Siebel: Mandatory: Yes Values: "7.5 - 7.7" | ||
install-filters* | Indicates whether to install a filter on the Web server to collect server-side performance information. Values: true, false Mandatory: Yes
| ||
install-dynamic-instrumentation* | Indicates whether to perform dynamic instrumentation. Values: true, false Mandatory: Yes, only if "install-instrumentation" is true.
| ||
web-ports* | The ports to be used by the Web Tier Collectors. Use two pipelines "||" as a separator between the ports. Specify at least one port. Values: port=port number;ip=[ip value|ALL];host-header=host headers;ssl=[true|false] (for example: port=3333;ip=ALL;host-header=srv2;ssl=true||port=4444;ip=ALL;host-header=srv1;ssl=true). Mandatory: Yes, if install-network is true and is-cluster is false. | ||
web-server-bits | Web server bits. Values: 32, 64 Mandatory: Yes for Web Servers - Apache, iPlanet. | ||
web-server-root | The root of the Web site root. Mandatory: Yes, only for an Other Web server type. | ||
web-ssl-client-certification-path | Full path to the client certificate file. Values: String Mandatory: Yes if "web-ssl-use-client-certification" is true. | ||
web-server-i3-user-name | Web sever client name. Values: String Mandatory: Yes if "web-server-uses-authentication" is true. | ||
web-server-i3-password(encrypted) | Web server encrypted password. Values: String Mandatory: Yes if "web-server-uses-authentication" is true Alternatively the web-server-i3-clear-password can be used, allowing you to specify a clear password instead of an encrypted string. For more information, see Encrypt command. | ||
web-server-domain | Web server domain. Values: String Mandatory: Yes if "web-server-uses-authentication" is true. | ||
web-server-method | Web server method. Values: Basic, Digest, NTLM Mandatory: Yes if "web-server-uses-authentication" is true. | ||
web-ssl-client-certification-password (encrypted) | Encrypted password for the client certificate. Values: String Mandatory: No Alternatively the web-ssl-client-certification-clear-password can be used, allowing you to specify a clear password instead of an encrypted string. For more information, see Encrypt command. | ||
web-ssl-client-certification-key-path | Full path to the client certificate private key file Values: String Mandatory: No | ||
web-server-uses-authentication | Is the web server requires client authentication to establish a connection. Values: true\false Mandatory: No | ||
apptier-name | Name of the Tier for the added instance. Values: String Mandatory: No | ||
environment-name | Name of the application for the added instance. Values: String Mandatory: Yes, for a federation installation | ||
install-alert-customized | Value: true/false Mandatory: No Set to true to in case you want to have customized alerts metrics for this instance. | ||
web-site-name | Site name, sometimes called context root. Values: String Mandatory: No | ||
web-use-special-ssl-configuration | The only way to connect to the web server is using a secured connection (SSL). Values: true\false Mandatory: No | ||
web-special-ssl-ciphers | Cipher list. Values: Specify the ciphers to be used Comma separated. Mandatory: No | ||
web-ssl-use-client-certification | Specifies whether the web server requires the client certificate to have a certificate to establish a connection. Values: true\false Mandatory: No | ||
install-network | Indicates whether to correlate the data collected by the Web server filter with the data collected by the Insight Savvy for Network. Values: true, false Mandatory: No |
...
Element | Description |
---|---|
installation-cd-path | Indicates the absolute path to the folder where the Precise download was downloaded to. Values: String Mandatory: Yes |
setup-process | Setup process. always apptier-DN. 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 Microsoft .NET Collector will be installed. Values: String Mandatory: Yes |
instance-name | The unique alphanumeric string used by Precise for Microsoft .NET and Insight to identify the monitored application instance. Values: String using English characters. Mandatory: Yes |
type | Indicates the type of the Microsoft .NET instance. Available types are as follows:
Mandatory: Yes |
application-name | If this instance is an ASP Microsoft .NET instance, the value for this field depends on the Internet Information Server (IIS) type: IIS5, IIS6 or IIS6IIS7. For a regular Microsoft .NET instance the field should be left empty. Values: IIS5IIS6, IIS6IIS7, or empty Mandatory: Yes, for ASP Microsoft .NET instances. For all other instances, this must remain empty. |
process-name* | Indicates the name of the .NET process executable file. For a regular Microsoft .NET instance, the field should include the path and name of the Microsoft .NET executable file. For an ASP Microsoft .NET instance, the value for this field depends on the type of Internet Information Server (IIS) as follows:
process-name can only be updated after installation if the instance type is general. Values: String Mandatory: Yes |
apptier-name | Name of the Tier. Values: String Mandatory: No |
environment-name | Name of the application. Values: String Mandatory: Yes, for a federation installation. |
install-alert-customized | Values: true/false Mandatory: No Set to true to in case you want to have customized alerts metrics for this instance. |
application-pool | Specifies the application pool(s) to be monitored by this instance. Use "*" to specify multiple application pools for monitoring. Values: String Mandatory: No |
...
Element | Description |
---|---|
installation-cd-path | Indicates the absolute path to the folder where the Precise download was downloaded to. Values: String Mandatory: Yes |
setup-process | Setup process. Always apptier-TU Mandatory: Yes |
setup-mode | Setup mode. Values: install, edit, uninstall Mandatory: Yes |
collector-server-machine-name | Name of the server on which the Tuxedo Collector will be installed. Values: String Mandatory: Yes |
instance-name (component identifier field) | Name of the Tuxedo instance that will be installed. Values: String Mandatory: Yes |
show-historical-data | Indicates if historical data from the deleted instance is shown (true) or deleted (false) Values: true/false Mandatory: No. This parameter is only relevant when the setup-mode is uninstall. |
tuxedo-domain | Name of the Tuxedo domain where the Tuxedo Tier will be installed. Values: String Mandatory: Yes |
tuxedo-directory* | The installation home folder for the Tuxedo information system. Values: String Mandatory: Yes |
tuxedo-config-file* | The full binary path of the configuration file for the Tuxedo information system that is planned to be monitored. Values: String Mandatory: Yes |
tuxedo-version* | The BEA Tuxedo version. Precise supports BEA Tuxedo 6.4 to 9.0. Values: String (XY[_64]). XY are the two digits for the version number. Add "_64" for 64-bits domains. For example: for BEA Tuxedo version 7.1 32-bits use "71"; for 9.0 64-bits use "90_64" Mandatory: Yes |
install-network* | Associates a Tuxedo activity with network statistics. Values: true, false Mandatory: No |
apptier-name | Name of the Tier. Values: String Mandatory: No |
environment-name | Name of the application. Values: String Mandatory: Yes, for a federation installation |
install-alert-customized | Values: true/false Mandatory: No Set to true to in case you want to have customized alerts metrics for this instance. |
...
Element | Description |
---|---|
installation-cd-path | Indicates the absolute path to the folder where the Precise download was downloaded to. Values: String Mandatory: Yes |
setup-process | Setup process. Always apptier-OT Mandatory: Yes |
setup-mode | Setup mode. Values: install, edit, uninstall Mandatory: Yes |
instance-name (component identifier field) | The unique name of the Tier that the Insight Savvy for Other Tier will monitor (for example, Citrix_Production, ex. AS400_DB). Values: String Mandatory: Yes |
other-apptier-type* | Indicates the position and role of the Tier in your application. The options are as follows:
Values: String Mandatory: Yes |
other-protocol-type* | The network protocol for the monitored application. Two protocol types are supported:
Values: String Mandatory: Yes |
other-monitor-method | The location from where the server is monitored. Two location types are available:
Values: local, remote Mandatory: Yes |
other-monitor-ports* | Other monitor ports. Values: static (if monitoring fixed ports), dynamic (if monitoring dynamic ports) Mandatory: Yes |
instance-server-machine-name | The name of the server where you will install the Other Tier. The server name or IP address will be valid if you previously defined this server as a Precise server. Values: String. Mandatory: Yes |
other-remote-servers* | The names of the servers where you want to monitor the remote Tier. These are names whose ports will be monitored separated by two pipelines "||". Format: remote-server=server-name||remote-server=server-name Values: String. Mandatory: Yes, only if |
other-static-ports* | The TCP/IP fixed port or ports listened to by the monitored application. Use two pipelines "||" as a separator between the port ranges as follows: from=80;to=90||from=100;to=120. Do not define if the dynamic Values: String Mandatory: No. |
other-dynamic-ports-include-programs* | The dynamic ports to be monitored; they are listened to by the monitored application. These are names of programs whose ports will be monitored. The program name will be matched against the first 9 characters of the names in the list separated by two pipelines "||". Format: program=program-name||program=program-name. Do not define if the Values: String. Mandatory: No. Up to three values can be defined. |
other-dynamic-ports-exclude-programs* | The dynamic ports, listened to by the monitored application, that should NOT to be monitored. These are names of programs whose ports will NOT be monitored. The program name will be matched against the first 9 characters of the names in the list separated by two pipelines "||". Format: program=program-name||program=program-name. Do not define if the Values: String. Mandatory: No. Up to three values can be defined. |
environment-name | Name of the application. Values: String Mandatory: Yes, for a federation installation. |
show-historical-data | Indicates if historical data from the deleted instance is shown (true) or deleted (false). Values: true/false Mandatory: No. This parameter is only relevant when the setup-mode is uninstall. |
...
Element | Description |
---|---|
installation-cd-path | Indicates the absolute path to the folder where the Precise download was downloaded to. Values: String Mandatory: Yes |
setup-process | Setup process. always apptier-OS Mandatory: Yes |
setup-mode | Setup mode. Values: install, edit, uninstall Mandatory: Yes |
collector-server-machine-name | Name of the server on which the OS Collector will be installed. Values: String Mandatory: Yes |
instance-name | Name of the server on which the OS Collector will be installed. Values: String Mandatory: Yes |
environment-name | Name of the application. Values: String Mandatory: Yes, for a federation installation |
install-alert-customized | Values: true/false Mandatory: No Set to true to in case you want to have customized alerts metrics for this instance. |
show-historical-data | Indicates if historical data from the deleted instance is shown (true) or deleted (false) Values: true/false Mandatory: No. This parameter is only relevant when the setup-mode is uninstall. |
Installing
...
Precise for
...
vCenter Server with the Precise CLI utility
Installing Siebel Collectors on a server enables you to sample Siebel instances on the server. A Siebel Tier Collector can be installed on all servers.
Before installing a Siebel Tier Collector with the Precise CLI utility, verify the following issues:
- The Precise for Oracle FocalPoint and Precise for Oracle Collector instance or Precise for SQL Server FocalPoint and Precise for SQL Collector instance are installed and running.
- The Precise Listener on the target server on which the Insight Savvy for Siebel Collector is to be installed was installed.
To install Interpoint for Siebel
The installation of Precise for vCenter Server can be performed using AdminPoint and by using the Precise CLI utility. For information on installing Precise for vCenter Server using AdminPoint, see Installing the Precise for vCenter Server.
Before installing Precise for vCenter Server with the Precise CLI utility, verify the following issue:
- The server on which you install Precise for vCenter Server must contain a Precise Listener
To install Precise for vCenter Server
- Prepare XML parameters file to specify the Precise for vCenter Server installation parameters.
- Prepare the log in details for the server with VMware vCenter Server.
- On the FocalPoint, run the following command from the <precise_root> folder to install the CLI utility installation script:
- Create the Interpoint for Siebel 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 Interpoint for Siebel parameter file.
- 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 <interpoint<precise_for_siebelvcenter_server_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 <interpoint<precise_for_vcenter_siebelserver_installation_parameters_file_name>
Anchor |
---|
...
|
...
|
...
Precise for
...
vCenter Server parameter file
You need to prepare the Interpoint Precise for Siebel vCenter Server parameter file by creating an XML file with elements tags that represent the installation parameters and inserting the appropriate values.
The following is an example of an Interpoint for Siebel a server parameters file:
<parameters>
<parameter name="setup-process" value="apptier-SBVC" />
<parameter name="setup-mode" value="install" />
<parameter name="collector-server-machine-name" value="srv1inf-fw-10" />
<parameter name="instance-server-machine-name" value="EnDevphy-vmtest-db1" />
<parameter name="siebelvmware-databasecenter-server-nameuser" value="dbsrv2VCuser" />
<parameter name="siebelvmware-databasecenter-instanceclear-namepassword" value="SBLDBVCpassword" />
<parameter name="siebelvmware-center-gatewayexclude-serverservers" value="srv2server=vm*|server=inf-fw-20" />
<parameter name="siebelvmware-center-pathport" value="d:\sea752\siebsrv443" />
<parameter name="siebel-uservmware-center-use-ssl-configuration" value="sadmintrue" />
<parameter name="siebel-encrypted-passwordvmware-center-ssl-use-certificate" value="ICLFAHMGHKEAIItrue" />
</parameters>
The following table describes the updated elements of the parameter file. Element names marked with an asterisk (*) can be updated after parameters file is an XML file containing a list of parameters for a Precise for vCenter Server installation.
Table 25 Elements Elements of the Interpoint Precise for Siebel vCenter Server parameter file
Element | Description | ||||
---|---|---|---|---|---|
installationsetup-cd-path | Indicates the absolute path to the folder where the Precise download was downloaded to. Values: String Mandatory: Yes | process | Name of the setup process. Always apptier-VC | setup-process | Setup process. Values: apptier-SB Mandatory: Yes |
setup-mode | Must be in one of the following modes:
Setup mode. Values: install, edit, uninstallMandatory: Yes | ||||
collector-server-machine-name | Name of the server the Siebel Tier will be installed onwhere Precise is located. The name must be written in lowercase letters only. Values: String Mandatory: Yes | ||||
instance-server-machine-name | Indicates the Siebel connection name. This Name of the server where the vCenter Server is located. The name must be uniquewritten in lowercase letters only. Values: String Mandatory: Yes | ||||
siebelvmware-databasecenter-server-nameuser | Name of the user who has permissions for the vCenter ServerThe server on which the Precise for Oracle Collector is running. Values: String Mandatory: Yes If using an SQL Server, this field is not required. | ||||
vmware-center-encrypt-password | Password of the user who has permissions for the vCenter Server | siebel-database-instance-name | Indicates the Oracle or SQL Server database instance name. Values: StringEncrypted string Mandatory: Yes. Alternatively the vmware-center-clear-password can be used, allowing you to specify a clear password instead of an encrypted string. For more information, see Encrypt command. | ||
vmware-center-exclude-servers | Names of the servers that are excluded from the VCenter Server | siebel-gateway-server* | Indicates the Siebel gateway name. Values: String separated by |. For example server=vm*|server=inf-fw-20 Mandatory: YesNo | ||
vmware-center-port | Port of the vCenter Server instance | siebel-path* | Indicates the Siebel installation path. Values: StringNumeric Mandatory: Yes | siebel-user* | |
vmware-center-use-ssl-configuration | Indicates if SSL configuration is usedIndicates the Siebel user name. Values: String(true/false). The default setting is true. Mandatory: YesNo | ||||
vmware-center-ssl-use-certificate | Indicates if an SSL server certificate needs to be used | siebel-encrypted-password* | Password for Siebel. Values: Encrypted String. For more information, see Encrypt command(true/false). The default setting is false. Mandatory: Yes. Alternatively the siebel-clear-password can be used, allowing you to specify a clear password instead of an encrypted string. install-alert-customizedNo. | ||
show-historical-data | Indicates if historical data from the deleted instance is shown (true) or deleted (false) Values: true/false Mandatory: No Set to true in case you want to have customized alerts metrics for this instance. |
Installing Precise for vCenter Server with the Precise CLI utility
The installation of Precise for vCenter Server can be performed using AdminPoint and by using the Precise CLI utility. For information on installing Precise for vCenter Server using AdminPoint, see Installing the Precise for vCenter Server.
Before installing Precise for vCenter Server with the Precise CLI utility, verify the following issue:
- The server on which you install Precise for vCenter Server must contain a Precise Listener
To install Precise for vCenter Server
...
. This parameter is only relevant when the setup-mode is uninstall. |
Anchor | ||||
---|---|---|---|---|
|
Extricate CLI allows you to fetch installation related parameters. For example, if you have installed an Oracle instance in Precise, you can run extricate CLI to find all Oracle instance installation parameters. You can then use these parameters for informative purpose, and/or use the parameters to edit and modify the instance settings using CLI edit mode. For more information, see Edit & uninstall.
To use extricate CLI you should identify the related installation. This includes the following:
...
- For Framework installation - supply the Precise FocalPoint server name parameter and setup-process=framework
- For Precise FocalPoint installation - supply the Precise FocalPoint product code and server name parameters and setup-process=focal-<PRODUCT_CODE> (see Product Codes.)
- For instance installation - supply the instance name, and instance/collector server name parameters and setup-process=apptier-<TECHNOLOGY_CODE> (see Technology Codes.)
- Windows infra\bin\psin_cli.bat
-i3-user <user_name>
...
- {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action
...
- extricate
[-parametersfile
...
- <path_
...
- to_
...
- input_
...
- parameters_file>] [-parameter <name=value>]
[-output-file <file>]
UNIX ./infra/bin/psin_cli.sh
-i3-user <user_name>
...
- {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
...
- -action
...
- extricate
...
- [-parametersfile
...
- <path_
...
- to_
...
- input_
...
- parameters_file>] [-parameter <name=value>]
[-output-file <file>]
For example:
infra\bin\psin_cli.bat
-i3-user admin
-i3-clear-password admin
-action extricate
-parameter setup-process=apptier-OR
-parameter
...
You need to prepare the Precise for vCenter Server 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="apptier-VC" />
<parameter name="setup-mode" value="install" />
<parameter name=" collector-server-machine-name" value="inf-fw-10" />
<parameter name="instance-server-machine-name" value="phy-vmtest-db1" />
<parameter name="vmware-center-user" value="VCuser" />
<parameter name="vmware-center-clear-password" value="VCpassword" />
<parameter name="vmware-center-exclude-servers" value="server=vm*|server=inf-fw-20" />
<parameter name="vmware-center-port" value="443" />
<parameter name="vmware-center-use-ssl-configuration" value="true" />
<parameter name="vmware-center-ssl-use-certificate" value="true" />
</parameters>
The parameters file is an XML file containing a list of parameters for a Precise for vCenter Server installation.
Table 26 Elements of the Precise for vCenter Server parameter file
...
Name of the setup process. Always apptier-VC
Mandatory: Yes
...
Must be in one of the following modes:
- install (used to install Precise for vCenter Server)
- edit (used to update Precise for vCenter Server)
- uninstall (used to uninstall Precise for vCenter Server)
Mandatory: Yes
...
Name of the server where Precise is located. The name must be written in lowercase letters only.
Values: String
Mandatory: Yes
...
Name of the server where the vCenter Server is located. The name must be written in lowercase letters only.
Values: String
Mandatory: Yes
...
Name of the user who has permissions for the vCenter Server.
Values: String
Mandatory: Yes
...
Password of the user who has permissions for the vCenter Server.
Values: Encrypted string
Mandatory: Yes. Alternatively the vmware-center-clear-password can be used, allowing you to specify a clear password instead of an encrypted string. For more information, see Encrypt command.
...
Names of the servers that are excluded from the VCenter Server.
Values: String separated by |. For example server=vm*|server=inf-fw-20
Mandatory: No
...
Port of the vCenter Server instance.
Values: Numeric
Mandatory: Yes
...
Indicates if SSL configuration is used.
Values: (true/false). The default setting is true.
Mandatory: No
...
Indicates if an SSL server certificate needs to be used.
Values: (true/false). The default setting is false.
Mandatory: No.
...
Indicates if historical data from the deleted instance is shown (true) or deleted (false)
Values: true/false
Mandatory: No. This parameter is only relevant when the setup-mode is uninstall.
poolsun5
-parameter instance-name=ORCL
The output will be done to an XML parameters file which is created by the CLI.
Table 26 Elements of the Extricate command parameters file
Element | Description |
---|---|
i3-user | See Authenticate to CLI Utility. |
i3-encrypted-password | See Authenticate to CLI Utility. |
action | Values: always extricate Mandatory: Yes |
parameter | Specify parameters to identify the related installation. Mandatory: Yes |
parameters-file | Specify the parameters to identify the related installation. The parameters can be specified in the command line as arguments and in a parameters file in the following format: <parameters> |
output-file | Path to a file that will be created. The file will contain the installation related parameters that are extracted. Values: String Mandatory: No. If this is omitted, the CLI utilities will set the path for the output file and will notify you of its location. |
Anchor | ||||
---|---|---|---|---|
|
Using CLI you can install, edit, and uninstall components in Precise. Editing an installation allows you to modify its settings. For example - change Precise password used for Oracle instance, or change instrumentation folders for Web instance.
To edit an installation
Use the Extricate command. For more information, see Extricate command.
Update the related parameters in the parameters file. Run CLI setup using parameter setup-mode=edit. For more information, see Installation with Precise CLI.
To uninstall an installation
Prepare an input XML file with the required parameters to identify the installation. For more information, see Extricate command.
Run CLI setup using parameter setup-mode=uninstall. For more information, see Installation with Precise CLI.
Anchor | ||||
---|---|---|---|---|
|
There are cases in which you want to install a new instance and use the historical data from an old instance (this might be required in case you have moved or renamed your instance). To do so, use the old instance ID for the new installed instance. The following procedure describes how to do this.
Info |
---|
Data related to deleted instances may be deleted permanently by the PMDB maintenance process. If you intend to use the deleted instance's data, you should check that it is not deleted by the PMDB. You can see if the check box of the purge parameter in the PMDB Maintenance (Weekly) process is not marked. |
Info |
---|
Old instance data is kept as part of the related FocalPoint schema. This means that the instance historical performance data is only kept while the FocalPoint is installed. If you uninstall the related FocalPoint, you no longer can recover the instance historical performance data. |
To install a new instance using an uninstalled instance ID
Info |
---|
Trying to install an instance, while using an ID that was not deleted will cause an error (You will also get this error when you try to install an instance with an ID of an unmonitored instance). Therefore, if the old instance is not yet uninstalled, uninstall it now without historical data using the GUI or CLI. |
From the <precise_root> folder on the main Precise FocalPoint, run the following query command to retrieve the instance ID:
Windows infra\bin\psin_cli.bat
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action get-instance-id
-technology <technology_code>
-instance <instance_name>
-server <server_name>
UNIX ./infra/bin/psin_cli.sh
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action get-instance-id
-technology <technology_code>
-instance <instance_name>
-server <server_name>
Table 27 Elements of the Retrieve instance ID query commandElement Description i3-user See Authenticate to CLI Utility. i3-encrypted-password See Authenticate to CLI Utility. action always get-instance-id
Mandatory: Yes
technology Values: Technology code. For more information, see Technology Codes.
Mandatory: Yes
instance The instance name.
Values: String
Mandatory: Yes
server The instance server name.
Values: String
Mandatory: Yes
- If there are several instances with the same name, the CLI utility will provide the latest instance ID in the output. A non-deleted instance will appear as installed.
- Create CLI parameters file to install the new instance. Add the
recovered-instance-id
parameter to the parameters file with the instance ID that was detected and run the CLI to install the new instance. For more information, see Installing a Tier with the Precise CLI utility.
...
Extricate CLI allows you to fetch installation related parameters. For example, if you have installed an Oracle instance in Precise, you can run extricate CLI to find all Oracle instance installation parameters. You can then use these parameters for informative purpose, and/or use the parameters to edit and modify the instance settings using CLI edit mode. For more information, see Edit & uninstall.
To use extricate CLI you should identify the related installation. This includes the following:
- For Framework installation - supply the Precise FocalPoint server name parameter and setup-process=framework
- For Precise FocalPoint installation - supply the Precise FocalPoint product code and server name parameters and setup-process=focal-<PRODUCT_CODE> (see Product Codes.)
- For instance installation - supply the instance name, and instance/collector server name parameters and setup-process=apptier-<TECHNOLOGY_CODE> (see Technology Codes.)
Windows infra\bin\psin_cli.bat
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action extricate
[-parametersfile <path_to_input_parameters_file>] [-parameter <name=value>]
[-output-file <file>]
UNIX ./infra/bin/psin_cli.sh
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action extricate
[-parametersfile <path_to_input_parameters_file>] [-parameter <name=value>]
[-output-file <file>]
For example:
infra\bin\psin_cli.bat
-i3-user admin
-i3-clear-password admin
-action extricate
-parameter setup-process=apptier-OR
-parameter collector-server-machine-name=poolsun5
-parameter instance-name=ORCL
The output will be done to an XML parameters file which is created by the CLI.
Table 27 Elements of the Extricate command parameters file
...
Values: always extricate
Mandatory: Yes
...
Specify parameters to identify the related installation.
Mandatory: Yes
...
Specify the parameters to identify the related installation. The parameters can be specified in the command line as arguments and in a parameters file in the following format:
<parameters>
<parameter name=”...” value=”...”/>
</parameters>
...
Path to a file that will be created. The file will contain the installation related parameters that are extracted.
Values: String
Mandatory: No. If this is omitted, the CLI utilities will set the path for the output file and will notify you of its location.
...
Using CLI you can install, edit, and uninstall components in Precise. Editing an installation allows you to modify its settings. For example - change Precise password used for Oracle instance, or change instrumentation folders for Web instance.
To edit an installation
Use the Extricate command. For more information, see Extricate command.
Update the related parameters in the parameters file. Run CLI setup using parameter setup-mode=edit. For more information, see Installation with Precise CLI.
To uninstall an installation
Prepare an input XML file with the required parameters to identify the installation. For more information, see Extricate command.
Run CLI setup using parameter setup-mode=uninstall. For more information, see Installation with Precise CLI.
...
There are cases in which you want to install a new instance and use the historical data from an old instance (this might be required in case you have moved or renamed your instance). To do so, use the old instance ID for the new installed instance. The following procedure describes how to do this.
Info |
---|
Data related to deleted instances may be deleted permanently by the PMDB maintenance process. If you intend to use the deleted instance's data, you should check that it is not deleted by the PMDB. You can see if the check box of the purge parameter in the PMDB Maintenance (Weekly) process is not marked. |
Info |
---|
Old instance data is kept as part of the related FocalPoint schema. This means that the instance historical performance data is only kept while the FocalPoint is installed. If you uninstall the related FocalPoint, you no longer can recover the instance historical performance data. |
To install a new instance using an uninstalled instance ID
Info |
---|
Trying to install an instance, while using an ID that was not deleted will cause an error (You will also get this error when you try to install an instance with an ID of an unmonitored instance). Therefore, if the old instance is not yet uninstalled, uninstall it now without historical data using the GUI or CLI. |
From the <precise_root> folder on the main Precise FocalPoint, run the following query command to retrieve the instance ID:
Windows infra\bin\psin_cli.bat
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action get-instance-id
-technology <technology_code>
-instance <instance_name>
-server <server_name>
UNIX ./infra/bin/psin_cli.sh
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action get-instance-id
-technology <technology_code>
-instance <instance_name>
-server <server_name>
Table 28 Elements of the Retrieve instance ID query command
...
always get-instance-id
Mandatory: Yes
...
Values: Technology code. For more information, see Technology Codes.
Mandatory: Yes
...
The instance name.
Values: String
Mandatory: Yes
...
The instance server name.
Values: String
Mandatory: Yes
...