Starting in interactive mode

You can start the command-line interface in interactive mode.

About this task

You run the shell script (pure.bat on Windows and pure on Linux®) from the pure.cli/bin directory on your local computer. In this procedure you start in interactive mode, specifying the host name or IP address for the system, along with an authorized user ID and password to start a user session.

Procedure

  1. On your local computer, navigate to the pure.cli\bin directory, where you installed the command-line interface tool (example on Windows: C:\Download\PureAS\pure.cli-2.0.0.0\pure.cli\bin.
  2. In the local command prompt window, from the \bin directory, run the shell script, specifying the (pure.bat on Windows or pure on Linux) command name, along with the following arguments:
    -h <host_or_IP>
    Specifies the host name or the IP address of the system. If you specify this option, do not use the URL to access the web interface. If this parameter is not specified, the command-line interface uses the value of the host_name environment variable to determine the host name.
    -u <userID>
    Specifies the user identifier that you use to authenticate to the system. Use the same user identifier that you use to log in to the console.
    -p <password>
    Specifies the password that is used to authenticate to the system. Use the same password that you use to log in to the console. You are not required to specify a password to access the help for the command-line interface.
    -a
    Automatically accepts the certificates from the system. You can also format the parameter as --acceptcert.
    -i
    Ignore version comparison. If you connect to a system with a lower version than the CLI version, an unsupported error version occurs. Use this option to ignore version comparison. You can also format the parameter as --ignoreversion.

    Usage example:

    pure -h 127.10.111.22 -u user01 -p password01 --acceptcert

    When the command-line interface is started, the >>> prompt is displayed, indicating that the command-line interface is ready to accept commands.

What to do next

Issue commands from your local computer to perform administrative tasks on Cloud Pak System. For additional help on commands, attributes, or methods on the command-line interface, see the Related tasks. A set of sample scripts that demonstrate some of the command-line interface functions is available in the pure.cli\samples directory.