Versions Compared

Old Version 1

changes.mady.by.user Nadja Pollard

Saved on

compared with

New Version 2

changes.mady.by.user Nadja Pollard

Saved on

Key

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

This section includes the following topics:•    Encrypt

  • Encrypt command

...

  • Apply License command

...

  • Change an installed Precise Listener port

...

  • Create support file command

...

  • Update main registry command

...

  • Clean Main DB and Infra DB CLI command

...

  • LDAP Sync command

...

  • List Applications, Tiers, and instances

...

  • Associate/Disassociate instance Tier

...

  • Copy Report Manager Reports

...

  • Create inventory report

...

  • Change GUI server port

...

  • Join instances to cluster

...

  • Configure SmartLink for an application

...

  • Downtime command

...

  • AdminPoint Dashboard acknowledgement

Encrypt command

The Encrypt command encrypts passwords that are used as parameters. The encryption is based on the encryption type that is currently configured on the site.

...

-action encrypt

-password <password>

 

 

password element

The following table describes the syntax of the password element.

...

dba-encrypted-password

to:

dba-clear-password

Apply License command

The Apply License CLI applies a new license to Precise.

...

i3-user    See Authenticate to CLI Utility on page 8. 

i3-encrypted-password    See Authenticate to CLI Utility on page 8.

 

action    Always apply-license

...

license-file    Specifies the path to the license file name that needs to be applied.

 

Change an installed Precise Listener port

The Listener Port Change command enables you to change the port number of an installed Precise Listener.

...

-action port-change

-port <port_number>

Create support file command

The Create a support file command enables you to generate a support file for Precise. The created support file is saved in the <precise_root>/support folder on the main Precise FocalPoint.

...

i3-user    See Authenticate to CLI Utility on page 8. 

i3-encrypted-password    See Authenticate to CLI Utility on page 8.

 

action    Always support

Mandatory: Yes

...

Mandatory: Only for a federated installation

Update main registry command

The update main registry command updates the main registry with the proxy registry. The command should run on the proxy that the change was made on, and will update the main registry.

...

i3-user    See Authenticate to CLI Utility on page 8. 

i3-encrypted-password    See Authenticate to CLI Utility on page 8. 

action    Update-main-registry

...

It should not be a relative, nor an absolute path. The path should be the path to an existing registry file without the .xml suffix, for example /registry/products/infrastructure/thin.

Clean Main DB and Infra DB CLI command

Precise maintains logically deleted entities for its operation. This allows, for example, reusing deleted instance's historical data for new instance installation. However as the Precise system ages, performance might be affected. To improve performance, clean the deleted entities using the following CLI.

...

{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}

-action clean-infra-db 

Table 15-5    Elements for Clean Main DB and Infra DB CLI

...

i3-user    See Authenticate to CLI Utility on page 8. 

i3-encrypted-password    See Authenticate to CLI Utility on page 8.

 

 

NOTE    Reusing deleted instance's historical data will not be available once this is used.

LDAP Sync command

Precise can use LDAP for its roles & users management. For more details about LDAP and Precise integration, see the Precise Administration Guide and/or the Precise Installation Guide. Precise automatically runs LDAP sync once a day at 00:08.

...

i3-user    See Authenticate to CLI Utility on page 8.

 

i3-encrypted-password    See Authenticate to CLI Utility on page 8. 

List Applications, Tiers, and instances

Using CLI you can list the entire Precise applications, Tiers and instances structure in a XML formatted file. To list, run the following command on the main Precise FocalPoint from the <precise_root>:

...

[-output-file <output_file>] 

Table 15-7    Elements for List Applications, Tiers, and instances

...

i3-user    See Authenticate to CLI Utility on page 8.

 

i3-encrypted-password    See Authenticate to CLI Utility on page 8.

 

action    Always environments-list

...

If output-file argument is omitted, output will be redirected to a new file created in infra/cli/output folder.

Mandatory: No

Associate/Disassociate instance Tier

This command associates or disassociates instances to the Tier. Please note the following:

...

[-apptier-application <application_code>] [-apptier-frontend {true|false}]

[-force {true|false}] 

Table 15-8    Elements for Associate/Disassociate instance Tier

...

i3-user    See Authenticate to CLI Utility on page 8.

 

i3-encrypted-password    See Authenticate to CLI Utility on page 8.

 

action    Always instance-apptier

...

Mandatory: Yes if changing the instance Tier when the instance is part of a cluster

 

Copy Report Manager Reports

CLI enables you to copy reports from one Tier to another. This can also be done between different Nodes, meaning between 2 applications on the same Precise federated installations that each belongs to different Node. To copy Report Manager reports from one Tier to another run the following command from the main Precise FocalPoint root folder:

...

<parameter name="destination-apptier" value="SQL Server"/>

</parameters>

 

NOTE    To copy a Cross-Tier report, you should use the following string for both the "source-apptier" and "destination-apptier" parameter: "Cross-AppTiers".

...

i3-user    See Authenticate to CLI Utility on page 8. 

i3-clear-password    See Authenticate to CLI Utility on page 8.

 

action    Values: fs-copy-foresight-custom-report

...

parametersfile    Values: Mandatory:

Create inventory report

The create inventory report enables you to create an Excel file containing information regarding your installation servers, nodes, PW, and instances.

...

[-output-file <output_file_name>] 

Table 15-10    Elements for Create an inventory report

...

i3-user    See Authenticate to CLI Utility on page 8. 

i3-encrypted-password    See Authenticate to CLI Utility on page 8. 

action    Values: Always inventory-report.

...

Mandatory: Only for a federated installation

Change GUI server port

You can change the GUI server port using CLI. To change the GUI server port run the following command on the Precise FocalPoint whose GUI server port you want to change:

...

[-shutdown-port <the_new_shutdown_port>] [-url <the_gui_server_url>]

 

Table 15-12    Elements for Change GUI server port

...

i3-user    See Authenticate to CLI Utility on page 8.

 

i3-clear-password    See Authenticate to CLI Utility on page 8.

 

action    Always change-gui-port

...

url    URL used to access the GUI server. This can also be used in case you have changed GUI server to use SSL, and you want to update Precise of this.

Mandatory: No

Join instances to cluster

Web and J2EE technologies support cluster installation. When installing an instance, you can choose whether to install the instance as a standalone instance or as a cluster.

...

[[-installation-cd-path <cd_path>] 

UNIX    infra/bin/psin_cli.sh

...

i3-user    See Authenticate to CLI Utility on page 8.

 

i3-clear-password    See Authenticate to CLI Utility on page 8. 

action    Always join-instances-to-cluster

...

Values: String

Mandatory: Yes

Configure SmartLink for an application

SmartLink is set by default for an application containing Web/J2EE/.NET Tiers. If you want to disable SmartLink for the application, run the following CLI utilities command on the main Precise FocalPoint:

...

-enable <enable_smartlink> 

Table 15-14    Elements to configure SmartLink

...

i3-user    See Authenticate to CLI Utility on page 8. 

i3-encrypted-password    See Authenticate to CLI Utility on page 8. 

action    Always smartlink-config

...

Values: true, false

Mandatory: Yes

Downtime command

The downtime command defines new downtime rules for an application, server, or specific Instance. Define the downtime using CLI utilities by running the following command:

...

i3-user    See Authenticate to CLI Utility on page 8.

 

i3-encrypted-password    See Authenticate to CLI Utility on page 8.

 

action    Always downtime

...

Values: Time (format: HH24:MI:SS)

Mandatory: Yes

AdminPoint Dashboard acknowledgement

The AdminPoint Dashboard provides information regarding health of the Precise installation. The information is displayed in categories for each category per components. If you want to ignore a report for a specific component, for instance because the problem is currently being handled, you will have to add the Unique Key column to the Dashboard and use this relevant key in a CLI utillities command.

...

NOTE    Ignored components are shown with a gray severity icon.

 

NOTE    If you have added the type add for the ignored item, it will also be listed in a new category named Acknowledged. 

NOTE    You can specify an expiration date for the acknowledgement and you can also delete them.

 

Windows    infra\bin\psin_cli.bat

...

i3-user    See Authenticate to CLI Utility on page 8. 

i3-encrypted-password    See Authenticate to CLI Utility on page 8. 

action    Always dashboard-ignore-handle

...

Values: Integer

Mandatory: No. 

 

 

Precise. Performance intelligence from click to storage. Learn more > >

...