XOG Client Installation
Download and install the XML Open Gateway (XOG) client, test connectivity, and verify the XOG client version. You can also configure FIPS 140-2 mode.
Download and Install the XOG Client
Follow these steps:
- ClickAdministration,General Settings,Client Downloads.
- For the Windows operating system:
- Click theWindows InstallerDownloadlink.
- Save the XOG.exe file to a directory on your local computer.
- Run the XOG.exe file and follow the on-screen instructions.
- For other supported operating systems:
- Click theCross-platform ZIPDownloadlink.
- Save the xogclient.zip file to your local computer.
- Create a local folder that is namedxogclientand extract the xogclient.zip files to that folder.
- (UNIX only) Run thechmod +x run.shcommand from thebindirectory.
XOG Client Directories
The following directories are copied to your computer when you run the XOG client installer:
- bin(batch files to run the XOG client; you can also run the XOG client using the test.properties file)
- lib(libraries that are required to run the XOG client)
- wsdl(the XOGService.wsdl file)
- xml(sample XML read and write files for the XOG-supported objects)
- xsd(XML schemas for the XOG-supported objects)
Verify the XOG Client Version and Connectivity
After you install the XOG client, test its connectivity to the
Clarity PPMserver. Over time, a mismatch between
Clarity PPMand the XOG client can occur if the product is upgraded but the XOG client is not. Verify that the XOG client version that you are using matches your version of
After you download and install the XOG client, download the Java Runtime Environment (JRE) and set the JAVA_HOME variable. Complete this step before you verify the XOG client version and the connectivity.
Follow these steps:
- InClarity PPM, determine your release version number by clickingAboutin the upper-right corner of any page.
- Open a command prompt.
- Windows: From theStartmenu, selectAll Programs,CA,Clarity,Clarity PPMXML Open Gateway
- UNIX: Navigate to theXOGclient home directory.
- Issue the following commands to see the XOG client version number:
- HTTP enabled- xog
- HTTPS enabled- xog -sslenabled true
- If the version numbers do not match, download and reinstall the XOG client.
- Issue the following command to verify the connection:login <username>/<mypassword>@<myserver>:<port>For example, if you are connecting tohttps://cppm-testsite-1234.ca.com/nikuwith the username and password of admin1/password2, issue the following command:login admin1/[email protected]:443
(Optional) Set Up FIPS 140-2 Mode
The FIPS 140-2 standard defines U.S. federal government requirements for encrypting sensitive data. If this standard is required for your business, set up FIPS 140-2 mode.
(For SaaS)Contact CA Support to let them know if you are a Clarity PPM customer who wants to enable FIPS mode.
Clarity PPM15.3 (released in September 2017), a new Bouncy Castle Cryptography Package for FIPS replaced the RSA B-SAFE FIPS provider from previous releases.