Versions Compared

Key

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

...

CLI receives its input from command line arguments and/or from parameters files. CLI input can be provided as arguments, for example, to provide server name:

./infra/bin/psin_cli.sh -server <my_server>

In some cases CLI input can be provided as parameters. In such cases, you can provide the parameters in CLI argument or as parameters file. For example, to provide server name parameter, you can use any one of the following:

./infra/bin/psin_cli.sh -parameter server=my_server

or

./infra/bin/psin_cli.sh -parametersfile input.xml

Where input.xml contains:

<parameters>
<parameter name="server" value="my_server"/>
</parameters>

...

Info

For all sections (unless otherwise stated), the maximum length of a parameter string is 256 characters and only integer values can be used for numeric parameters.

Anchor
WheretorunCLIUtility
WheretorunCLIUtility
Where to run CLI Utility

CLI should be executed on the main Precise FocalPoint (unless otherwise stated). Always run CLI from Precise root (Precise installation folder on the server).

 

Anchor
AuthenticatetoCLIUtility
AuthenticatetoCLIUtility
Authenticate to CLI Utility

...

To authenticate using CLI you can use the clear text password:Windows    infra

  • Windows. infra\bin\psin_cli.bat -i3-user admin -i3-clear-password admin ...

...

  • UNIX. ./infra/bin/psin_cli.sh -i3-user admin -i3-clear-password admin ...

or use encrypted password:Windows    

  • Windows. /infra\bin\psin_cli.bat -i3-user admin -i3-encrypted-password _EncryptI3_A_1_81AD2B0309 ...

...

  • UNIX. ./infra/bin/psin_cli.sh -i3-user admin -i3-encrypted-password _EncryptI3_A_1_81AD2B0309 ...

Table 1-1    Authenticate 1 Authenticate to CLI

Element

...

Description
i3-

...

user

The Precise user name used for authentication.

Mandatory: Yes

i3-encrypted-

...

password

Values: The encrypted password used for authentication of the user specified in -i3-user argument. For more information, see Encrypt command on page 148.

Mandatory: Yes

Alternatively the i3-clear-password can be used, allowing you to specify a clear password instead of an encrypted string.

Anchor
Errorreporting
Errorreporting
Error reporting

All Precise CLI utility commands return the following return codes:•    0

  • 0 The requested operation finished successfully.

...

  • 1 The requested operation encountered errors.

In addition, the CLI prints an error report to STDOUT/STDERR.•    Informative

  • Informative errors are printed with prefix: "Informative message"

...

  • Errors related to the CLI operation are printed to log ~i3/logs/infra.cli.log

Anchor
Installationpackages
Installationpackages
Installation packages

...

If you are running CLI from a server which is not the main Precise FocalPoint server, verify that one of the options below are correct:•    Precise

  • Precise download is accessible to the Precise FocalPoint process on the Precise FocalPoint server (notice that in

...

  • Windows, Precise FocalPoint service cannot access network share).

...

  • You have copied all files from the Precise v9.

...

  • 6 download/I3/distribution folder to the installed main

...

  • Precise FocalPoint under folder <precise_root>\products\i3fp\distribution_source\installer.

If you want to prevent CLI from copying files, you can copy the files yourself to the server and extract them. Note that this is not the recommended method of work.

For a list of required installation packages per each component, see About the installation files on page 162.

 

 

 

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

...