Page History
...
Table 2-27 Elements of the Extricate command parameters fileElement Description
| Element | Description |
|---|---|
| i3- |
...
| user | See Authenticate to CLI Utility on page 8. |
| i3-encrypted- |
...
| password | See Authenticate to CLI Utility on page 8. |
| 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 on page 9.
To uninstall an installation
Prepare an input XML file with the required parameters to identify the installation. For more information, see Extricate command.
...
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 2-
...
28 Elements of the Retrieve instance ID query command
...
Element Description i3-
...
user See Authenticate to CLI Utility on page 8. i3-encrypted-
...
password See Authenticate to CLI Utility on page 8.
...
action always get-instance-id
Mandatory: Yes
...
technology Values: Technology code. For more information, see Technology Codes on page 174.
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-idparameter 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.
Precise. Performance intelligence from click to storage. Learn more > >
...