CA Identity Manager Connector Guides › Connector Xpress Guide › Installing Connector Xpress › Upgrading Metadata

Upgrading Metadata

Connector Xpress automatically upgrades your existing metadata when you open your old project into the new version of Connector Xpress. As you take advantage of the new features in this release, they are automatically added to your existing metadata.

Note: When you open an old project for the first time in Connector Xpress, redeploy the metadata and generate the CA Identity Manager User Console Account Screens.

Where User Preferences Are Stored

Connector Xpress stores user preferences through the Java Preferences API.

On Windows, Java Preferences API stores data in the following registry key:

HKEY_CURRENT_USER\Software\JavaSoft\Prefs

On UNIX, Java Preferences API stores data in the users home directory under the following folder:

.java/.userPrefs

Note: The uninstaller does not remove this data, so subsequent installs preserve user preferences.

Set Preferences

You can change various aspects of the way Connector Xpress looks and behaves, such as its look and feel, search limits, and command parameters.

Follow these steps:

1. Click Tools, Preferences.

   The Connector Xpress Preference dialog appears.

2. Compete the fields on the dialog, then click OK.

   Connector Xpress applies and saves your preferences.

More Information:

Preferences Dialog

Where Settings Are Stored

Settings are stored using the Java Preferences API. The API stores the values in the registry on Windows and in a file under the user’s home directory on Solaris.

On Windows, the value is stored in the following registry key:

HKEY_CURRENT_USER\Software\JavaSoft\Prefs\com\ca\iam\conman

Set Up TLS/SSL for a JNDI Data Source

In Connector Xpress, you can define a JNDI data source as TLS/SSL enabled.

If a JNDI data source is TLS/SSL enabled, import the JNDI data source certificate into the Connector Xpress trusted certificate store.

Follow these steps:

1. Create a PEM file for each issuer in the target certificate’s chain.
2. For each file enter the following command:

   keytool -import -trustcacerts -keystore "conxp-home/conf/ssl.keystore" -file trusted-certificate.pem
   

   The JNDI Data Source certificate is imported into the ssl.keystore

   Repeat this command for each PEM file.

3. Restart Connector Xpress.
4. Test the TLS/SSL connection in Connector Xpress.

Set Up Data Sources

A data source is a reference to a server or other source of schema information that Connector Xpress can construct a connector for.

Connector Xpress supports the following data sources from supported vendors:

• JDBC—Any service accessible through the JDBC API, typically a relational database server.
• JNDI—Any service accessible through the JNDI API, typically an LDAP server.

You can connect to a data source to read its schema and then use Connector Xpress to map the schema to a new endpoint type. Connector Xpress maintains a list of data sources that you configure. You can set up JNDI or JDBC data sources.

Note: When you create a Connector Xpress project, Connector Xpress prompts you to set up your data sources.

Follow these steps:

1. Click Tools, Data Sources.

   The Select Data Source for new Project dialog appears.

2. Click Add.

   The Source Types dialog appears.

3. Select an available data source type from the list, then click OK.

   The Edit Source dialog appears, specific to the type of data source you are adding.

4. Complete the fields on the dialog, then click Test to verify your settings and authentication details.

   Depending on the authentication method chosen, a subsequent authentication dialog can appear.

   Complete the fields on this dialog to continue the test.

5. When the test has completed successfully, click OK.

   You have successfully configured the data source type you selected.

More Information:

Select Data Source for new project Dialog

Source Types Dialog

Create a Project

Configure the CA IAM Connector Server Host to Communicate with Standalone CA IAM Connector Server

There are two ports (non tls (ssl) and ssl) that a client can use to communicate with the standalone CA IAM Connector Server. To allow the Connector Server Manager or Connector Xpress to access the standalone CA IAM Connector Server, configure the firewall on your CA IAM Connector Server server host to allow communication on these ports.

Provide License Files for Sybase and UDB for z/OS to Connector Xpress

The Sybase and DB2 for z/OS connectors both use JDBC, and they both require a license file to connect to the endpoints.

The following sections in the Installation Guide describe how to set up these license files:

• Set Up License Files for the DB2 for z/OS Connector
• Set Up License Files for the Sybase Connector