SA Command Line Interface (OCLI)

The SA Command Line Interface (OCLI) consists of two tools:

• oupload – Uploads files into the Software Repository
• odownload – Downloads files from the Software Repository

These commands help to automate the setup tasks for package management in Server Automation. For a list of supported package types, see "Software management" in the SA Use section.

OCLI runs on a server managed by SA. The operating system of this server can be one of the following: Oracle Sun Solaris, Linux, IBM AIX, HP-UX, and Microsoft Windows.

Upload verification

After you upload a package with OCLI, verify that the upload has been successful by locating the package with the

SA Client. Typically, you add the uploaded package to a folder or a policy.

Encoding options for OCLI

The oupload and odownload commands include options for specifying the encoding scheme of packages or customer display names. These options are required only when you want to override the default setting in the LANG environment variable of your shell.

RPM uploads

For RPM packages, always remember to upload the source files after uploading a package. Uploading the source files is important from a maintenance perspective because it allows users to modify packages at a later date.

Passwords and environment variables

The oupload and odownload commands prompt for the SA user name and password when needed. Alternatively, you can set the ISMTOOLUSERNAME and ISMTOOLPASSWORD environment variables.

The 'ocli.conf' configuration file located at the root of the OCLI installation can be edited to set a OCLI username and password for connecting to SA. If you provide username and password in the ocli.conf file, then the password will be encrypted in the file after the first run of the oupload or odownload command.

Upload examples

To upload mytoolkit.rpm into the /Kit Apps/Services folder, enter the following command on a single line:

$ oupload --pkgtype RPM --os "Red Hat Enterprise Linux AS 3" 
--folder "/Kit Apps/Services" mytoolkit.rpm

To upload iPlanet_Web_Server-4.1sp19-LC~0.sparc64.rpm for the customer Opsware and the operating system Solaris 5.11, enter the following command on a single line:

$ <installation_directory>/bin/oupload --pkgtype RPM --old --customer Opsware
--os "SunOS 5.11" iPlanet_Web_Server-4.1sp19-LC~0.sparc64.rpm

Be sure to enclose values containing spaces, such as SunOS 5.11, in quotes.