Configure HPE IDOL Site Admin to Use OEM Encyption

In an OEM environment, IDOL components use OEM encryption to communicate.

You can configure HPE IDOL Site Admin to use OEM encryption to communicate with the IDOL Community component and the Coordinator component.

Start HPE IDOL Site Admin in OEM Encryption Mode

The following example shows you how to set up OEM encryption in your HPE IDOL Site Admin system properties.

To configure HPE IDOL Site Admin to use OEM Encryption

If you run HPE IDOL Site Admin as a service on Windows, you can also add the same arguments to the siteadmin.xml file.

If you run HPE IDOL Site Admin as a service on Linux, you can add the argument to the existing arguments variable in for SysV, or siteadmin.conf for Upstart.

When you modify the HPE IDOL Site Admin configuration by modifying the XML file or start scripts, you must restart HPE IDOL Site Admin to apply your configuration changes.

For more information on installing and running HPE IDOL Site Admin as a service on Windows or Linux, see Install HPE IDOL Site Admin.

Configure HPE IDOL Site Admin with OEM Encryption

When you use HPE IDOL Site Admin with OEM encrypted IDOL components (that is, when you need to set the -Dhp.idolsiteadmin.oemEncryptionKey system property), you cannot use the HPE IDOL Site Admin settings page to modify the configuration.

In this case, you must manually update the HPE IDOL Site Admin configuration file.

To configure HPE IDOL Site Admin in OEM Encryption Mode

  1. Attempt to start HPE IDOL Site Admin. When HPE IDOL Site Admin attempts to start, it generates an initial default configuration file. However, until you modify the configuration, the application does not start successfully.

  2. Open the generated configuration file.

  3. In the login section, add the method property. Set this property to the security type that your IDOL Community component is using to authenticate your users (normally autonomy). For example:

    "login": {
       "method": "autonomy",
       // remaining properties omitted

    You can find the security type that you are using by checking your IDOL Community component configuration file.

  4. In the datasource section, update the url parameter to use a file database by setting it to the string in the following example:

    "datasource": {
       "url": "jdbc:h2:file:PATH_TO_HOME_DIRECTORY/data/site-admin-db;DB_CLOSE_ON_EXIT=FALSE",
       // remaining properties omitted

    where PATH_TO_HOME_DIRECTORY is the path to your HPE IDOL Site Admin home directory.

  5. Update any additional options in the configuration file. In particular, ensure that the community and coordinator sections contain the correct host and port information for your IDOL Community component and Coordinator component, respectively.
  6. Save and close the configuration file.