Watsonx as a Service on AWS includes a command-line tool that is called ObjectManager. The tool enables you to import and export configuration data, such as field definitions, workflow definitions, application text, and more. You install ObjectManager on a local computer. The tool accesses your instance remotely.

The computer where you install ObjectManager must meet the following requirements:

• IBM SDK, Java™ Technology Edition 8 or Java Runtime Environment (JRE) 8 is installed.
• JAVA_HOME is defined.
• The remote system has access to your instance.

To do this task, you need the instance ID (GUID) of your instance. In the IBM SaaS Console, view the list of your instances, click the name of the instance that you want to work with, and then copy the Instance ID.

You also need the URL of your instance. In the Instance Management console, click the Environment tab. Copy the URL.

To install ObjectManager, do the following steps:

1. Log in to Fix Central and download the latest Client Tools package for OpenPages.

   The package name is OpenPages-<version>-openpages-tools-client.zip

2. Extract the .zip file to a new directory.

3. Go to the openpages-tools-client/bin directory.

4. Open the openpages-tools-client.properties file in a text editor.

5. Set the values of the following properties

   • rest.url.path: Type the base URL of the public REST API.

     https://<instance\_url\>/grc/api
     

     Replace <instance\_url\> with the URL of your instance.

   • saas_authenticator_type: Set this to mcsp.

   • saas_authenticator_url: Set this to https://account-iam.platform.saas.ibm.com

   • saas_mcsp_key_scope: Set this to the ID of your instance.

   • insecure.skip.tls.verify: Set this to true.

   For example:

   rest.url.path=https\://<instance\_url\>/grc/api
   saas_authenticator_type= mcsp
   saas_authenticator_url=https://account-iam.platform.saas.ibm.com
   saas_mcsp_key_scope=<instance\_ID\>
   insecure.skip.tls.verify=true
   

6. Save and close the file.

ObjectManager is installed. You can run it from the openpages-tools/bin directory.

To learn more, see the following topics:

• Running ObjectManager commands
• Load command syntax
• Dump command syntax
• Examples

Parent topic: Managing your watsonx.governance environment on AWS (ongoing maintenance)