Versions Compared

Key

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

...

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<precise_root>root>:

Windows  

...

 infra\bin\psin_cli.bat
                    -i3-user

...

<user_

...

name>
                    {-i3-encrypted-password

...

<encrypted_

...

password> | -i3-clear-password

...

<clear_

...

password>}
                    -action environments-list
                    [-output-file

...

<output_

...

file>]

...

UNIX            ./infra/bin/psin_cli.sh
                    -i3-user <user

...

_

...

name>
                    {-i3-encrypted-password

...

<encrypted_

...

password> | -i3-clear-password

...

<clear_

...

password>}
                    -action environments-list
                    [-output-file

...

<output_

...

file>]

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

Element

...

Description
i3-

...

userSee Authenticate to CLI Utility on page 8.
i3-encrypted-

...

passwordSee Authenticate to CLI Utility on page 8.

...

action

Always environments-list

Mandatory: Yes

output-

...

file

Values: path to output file

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

Mandatory: No

Anchor
AssociateDisassociateinstanceTier
AssociateDisassociateinstanceTier
Associate/Disassociate instance Tier

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

  • You can connect an instance to only one Tier in an application.

...

  • An instance must be part of at least one Tier.

...

  • To move an instance to another Tier, first associate the instance with the target Tier, and then disassociate the instance from the original Tier.

...

  • The OS Tier name must be "OS".

...

  • The Other Tier name must be identical to the instance name.

...

  • If you are associating an instance to a non-existent Tier and application, the specified Tier and application are automatically created.

...

  • If you are disassociating an instance from an Tier, and the Tier no longer contains instances, the Tier is automatically deleted. If there are no more Tiers in the related application, the application is also deleted.

...

  • Any Tier change performed on an instance which is part of a cluster, is automatically applied to all instances of that cluster.

Windows  

...

 infra\bin\psin_cli.bat
                    -i3-user

...

<user_

...

name>
                    {-i3-encrypted-password

...

<encrypted_

...

password> | -i3-clear-password

...

<clear_

...

password>}
                    -action instance-apptier
                    -technology

...

<technology_

...

code>
                    -instance-server-machine-name

...

<server_machine_

...

name>
                    [-proxy-alias

...

<node_

...

alias>]
                    -instance-name

...

<instance_

...

name>
                    -apptier-name

...

<Tier_

...

name>
                    -environment-name

...

<application_

...

name>
                    -type

...

<type>}
                    [-apptier-application <application

...

_

...

code>] [-apptier-frontend {true|false}]
                    [-force {true|false}]

...

UNIX            ./infra/bin/psin_cli.sh
                    -i3-user

...

<user_

...

name>
                    {-i3-encrypted-password

...

<encrypted_

...

password> | -i3-clear-password

...

<clear_

...

password>}
                    -action instance-apptier
                    -technology

...

<technology_

...

code>
                    -instance-server-machine-name

...

<server_machine_

...

name>
                    [-proxy-alias

...

<node_

...

alias>]
                    -instance-name

...

<instance_

...

name>
                    -apptier-name

...

<Tier_

...

name>
                    -environment-name

...

<application_

...

name>
                    -type

...

<type>
                    [-apptier-application <application

...

_

...

code>] [-apptier-frontend {true|false}]
                    [-force {true|false}]

Table 15-8    Elements 8 Elements for Associate/Disassociate instance Tier

Element

...

Descriptions
i3-

...

userSee Authenticate to CLI Utility on page 8.
i3-encrypted-

...

passwordSee Authenticate to CLI Utility on page 8.

...

action

Always instance-apptier

Mandatory: Yes

technology

...

Values: Technology code. For more information, see Technology Codes on page 174.

Mandatory: Yes

instance-server-machine-

...

name

The instance server machine name.

Values: string

Mandatory: Yes

proxy-

...

alias

The proxy alias.

Values: alias of the related node

Mandatory: Only for a federated installation

instance-

...

name

The instance name.

Values: string

Mandatory: Yes

apptier-

...

name

The Tier name.

Values: string

Mandatory: Yes

environment-

...

name

The application name.

Values: string

Mandatory: Yes

...

type

Values: one of DISSOCIATE,ASSOCIATE use ASSOCIATE to add an instance to a Tier use DISSOCIATE to remove an instance from a Tier.

Mandatory: Yes

apptier-

...

application

Values: Application code is optional and can be specified only for the following technologies: Other – CTX, .Net - ASP,DNT, WEB - WEB, SAP, PST, SBL.

Mandatory: No

apptier-

...

frontend

Indicates whether the Tier is a frontend Tier.

Values: true or false

Mandatory: No

force

...

Indicates whether this operation should be performed even if it affects several instances.

Values: true or false

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

Anchor
CopyReportManagerReports
CopyReportManagerReports
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:

Windows    infra infra\bin\psin_cli.bat

-i3-user <user_name>

...

-parametersfile <parameters_file_path>

UNIX    ./infra/bin/psin_cli.sh

-i3-user <user_name>

...

To create an inventory report, run the following command on the main Precise FocalPoint:

Windows    infra infra\bin\psin_cli.bat

-i3-user <user_name>

...

[-output-file <output_file_name>]

UNIX    ./infra/bin/psin_cli.sh

-i3-user <user_name>

...

To update the logger configuration, run the following command on the Main Precise FocalPoint:

Windows    infra infra\bin\psin_cli.bat

-action clean-logger-cache

...

[-proxy-alias <node_alias>]

UNIX    ./infra/bin/psin_cli.sh

-action clean-logger-cache

...

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:

Windows    infra infra\bin\psin_cli.bat

-i3-user <user_name>

...

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

UNIX    ./infra/bin/psin_cli.sh

-i3-user <user_name>

...

To join the instances, run the following CLI utility command from the Main Precise FocalPoint root folder:

Windows    infra infra\bin\psin_cli.bat

-i3-user <user_name>

...

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

UNIX    infra infra/bin/psin_cli.sh

-i3-user <user_name>

...

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:

Windows    infra infra\bin\psin_cli.bat

-i3-user <user_name>

...

-enable <enable_smartlink>

UNIX    ./infra/bin/psin_cli.sh

-i3-user <user_name>

...

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:

Windows    infra infra\bin\psin_cli.bat

-i3-user <user_name>

...

-end date <end_date>

-end time <end_time>

UNIX    ./infra/bin/psin_cli.sh

-i3-user <user_name>

...

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

Windows    infra infra\bin\psin_cli.bat

-i3-user <user_name>

...

{-expire-in-days<expire_in_days>}

UNIX    ./infra/bin/psin_cli.sh

-i3-user <user_name>

...