Jump to: navigation, search

Using the Command Line Console (CLC)

The Command Line Console (CLC) enables administrators to use the command line to execute certain GAX functions on solution definitions (SPDs) and installation packages (IPs). For example, you might use the CLC to silently deploy SPDs onto remote hosts.

You must be able to access the operating system's command-line interface to use the CLC. If you are not on the GAX host machine, you must have the CLC tool (gaxclc.jar) available on the local machine.

To access CLC's embedded Help file, execute one of the following commands:

java –jar gaxclc.jar help
java –jar gaxclc.jar ?
Important
As you execute commands with CLC, a log file is generated in the same location as where the tool is executed.

Structure

CLC supports commands that use the following structure:

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> <function> <operation> <args>

In the above example:

  • -u:user is the user name to log in to Configuration Server.
  • -p:password is the password to log in to Configuration Server. CLC assumes there is no password if this flag does not specify a value.
  • -s instructs CLC to use a secure https connection to the GAX server. If this flag is not specified, CLC uses http.
  • -h:<host>:<port> specifies the host and port of the GAX server. If this flag is not specified, CLC uses the following value: -h:localhost:8080.
  • <function> can be either ip or spd.
  • <operation> specifies the operation to be executed. The valid values for this flag are specific to the function you specified in the previous step (ip or spd).
  • <args> specifies the operation arguments. The valid values for this flag are specific to the <function> and <operation> parameters you specified in the previous steps.

The following is an example of a CLC command:

java -jar gaxclc.jar -u:default -p:password -h:localhost:8080 spd execute 10054 1 "C:/GAX/input.txt"

SPDs

CLC supports the following operations for SPDs:

  • add
  • query
  • querybyid
  • execute
  • delete
  • encrypt (see execute tab)

add

Overview

This operation adds an SPD to the GAX database. If the SPD already exists, as determined by the name and version in the SPD XML, this operation replaces the existing SPD.

If successful, the operation returns the ID of the added SPD.

Format

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd add "file path"
  • "file path"—The path to the XML file.

Example

java -jar gaxclc.jar -u:default -p:password spd add "c:\GAX\newSpd.xml"

query

Overview

This operation queries all SPDs and displays a table that lists the following for each SPD:

  • ID number
  • Name
  • Version
  • Tenant DBID

The following is an example:

10054 gvp 8.1.5 1
10060 genesysOne 8.1.5 1
10060 eServices 8.1.5 1

Format

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd query

Example

java -jar gaxclc.jar -u:default -p:password -s -h:132.45.43.45:443 spd query

querybyid

Overview

This operation queries an SPD by its ID. If the SPD does not exist, the operation fails.

If successful, the operation displays a table that lists the following details about the SPD:

  • Profile ID
  • Name

For example:

1 Install

Format

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd query SPDID
  • SPDID—The ID of the SPD that is being queried.

Example

java -jar gaxclc.jar -u:default -p:password -h:132.45.43.45:8080 spd query 4374

execute

Overview

This operation executes a SPD.

Format

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd execute SPDID profileName|-profileID:profileID|-profileName:profileName -encrypted "input file"


  • SPDID—The ID of the SPD to be executed.
  • profileName|-profileID:profileID|-profileName:profileName—The SPD profile to be executed.
Important
If no flag is specified, then profileName is assumed as the SPD profile to be executed.
  • -encrypted—If specified, indicates if the input file is encrypted.
[+] Show Usage
  • "input file"—Specifies the input file that contains SPD parameters. If -encrypted is set, the input file is encrypted.

The input file must be in JSONObject format and include SPD parameters for a specific profile. The file must be encoded in UTF-8 format.

[+] Show usage

Example

java -jar gaxclc.jar -u:default -p:password -s -h:localhost:8080 spd execute 10054 -profileID:1 "C:/GAX/input.txt"


java -jar gaxclc.jar -u:default -p:password -h:localhost:8080 spd execute 10054 -profileName:"Install profile" "C:/GAX/input.txt"


java -jar gaxclc.jar -u:default -p:password -s -h:localhost:8080 spd execute 10054 1 -encrypted "C:/GAX/encryptedinput.txt"

delete

Overview

This operation deletes an SPD. If SPD does not exist, the operation fails.

Format

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd delete SPDID
  • SPDID—The ID of the SPD to be deleted.

Example

java -jar gaxclc.jar -u:default -p:password spd delete 5436

IPs

CLC supports the following operations for the ip function:

  • add
  • query
  • querybyid
  • delete

add

Overview

This operation adds an IP (packaged as a .zip file) to the GAX database. If the IP already exists, it is replaced.

If successful, the operation displays the ID of the IP.

Important
The .zip file must contain the IP and the templates folder for the IP.

Format

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> ip add "path to IP zip file"


Example

java -jar gaxclc.jar -u:default -p:password ip add "C:\GAX\TESTS\zippedIpUpload\PRODUCTION\IP_TSrvSIP64_18100079b1_ENU_windows.zip"

query

Overview

This operation queries all IPs and displays a table that lists the following details for each IP:

  • ID number
  • Name
  • Version
  • OS
  • Locale
  • Status

Format

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> ip query

Example

java -jar gaxclc.jar -u:default -p:password -s -h:132.45.43.45:443 ip query

querybyid

Overview

This operation queries an IP by its ID and displays a table that lists the following details:

  • ID number
  • Name
  • Version
  • OS
  • Locale
  • Status

Format

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> ip query IPID
  • IPID—The ID of the IP to query.

Example

java -jar gaxclc.jar -u:default -p:password -h:132.45.43.45:8080 ip query 543

delete

Overview

This operation deletes an IP.

Format

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> ip delete IPID
  • IPID—The ID of the IP to delete.

Example

java -jar gaxclc.jar -u:default -p:password ip delete 547

Feedback

Comment on this article:

blog comments powered by Disqus
This page was last modified on November 21, 2016, at 12:29.