Download the command-line interface to your local computer to perform administrative tasks
on Cloud Pak System.
Before you begin
Ensure that the local computer to which you are downloading
the command-line interface tool is running a supported Windows or Linux® operating
system.
The command-line interface tool cannot be downloaded without form-based authentication. Therefore, either log in
to the user interface or use form-based authentication if a REST client is used. Download the
current version of the command-line interface tool and ensure that the command-line interface
tool version must match the Cloud Pak System
version.
Ensure that you have Java™ Runtime
Environment (JRE) Version 8 with the latest updates installed on the local computer, and that either
the JAVA_HOME or the PATH environment variable is set to the
location of your JRE.
About this task
Complete the procedure in this task to download and install
the command-line interface tool from the Welcome page of Cloud Pak System.
Procedure
- From the Welcome page, click .
You are prompted
to save a compressed file, with a file name in the form of pure.cli-<version>.zip.
- Save the compressed file to your local computer in a temporary
directory.
- Extract the contents of the compressed
file to a directory on your hard disk. When extracted, a single directory
called pure.cli is created.
- Optional: If you are using Windows Server 2003 or 2008, perform this
step.
In the
pure.cli directory,
create a
registry file in the
lib/<version> with
the following line:
python.os=nt
This causes
Jython to bypass the normal operating system detection logic and treat
the system as a Windows machine.
By
default, the only subdirectory in the lib directory
is a <version> subdirectory
that matches the firmware level of the product from which the command-line
interface was downloaded. If you use this command-line interface installation
to communicate with different firmware levels, then there is one subdirectory
under the /lib directory for each of these firmware
levels. You must copy the registry file into each of these subdirectories,
for example, /lib/3.0.0.0-12345/registry.
Results
After you install the command-line interface tool, you can verify the installation by running the
shell script (pure.bat on Windows and pure on Linux) from the pure.cli/bin directory.
Optionally, you can also specify the --help argument
for more information.
What to do next
Invoke the command-line interface.