Administering the Plugin Manager

The Plugin Manager is an extension to the AWI that can be used to install, upgrade, and remove Packs to enhance the functionality of your system.

Configuring the Access to Packs

As a Administrator, you can retrieve an updated list of available Packs and versions from the CA Automic Index GIT public repository (https://github.com/Automic/Index.git) to install and update Packs.

To do so, you configure the URL to the public repository in the PM_INDEX_URL key of the UC_SYSTEM_SETTINGS or UC_CLIENT_SETTINGS VARA objects. For more information, see PM_INDEX_URL.

When you trigger the Update Index button in the Packs view of the Administration perspective, the UC_PM_INDEX_CONTENT VARA object is created, which contains the Pack list and metadata in JSON format.

Important! Read rights on the UC_PM_INDEX_CONTENT VARA object are required. For more information, see Granting Automation Engine Authorizations.

Importing GIT Certificates to Update the Index

  1. Make sure that the java library runs on the applicationserver.
  2. Export the certificates from https://github.com/Automic/Index and https://downloads.automic.com/downloads
  3. Open the Java security folder (for example: C:\Program Files\Java\jre1.8.0_201\lib\security)
  4. Open CMD in this location and import the certificates with the following commands:

    + keytool -import -file C:\downloadsautomiccom.crt -keystore cacerts -alias "automic"

    + keytool -import -file C:\github.crt -keystore cacerts -alias "github"

  5. Restart the application server.

Updating the Index from an SSH URL

  1. Create an account on Github (https://github.com/settings/profile)
  2. Generate an SSH key with PuTTYgen or with the command line: ssh-keygen -t rsa
  3. Copy the public key and add it to the SSH key on https://github.com/settings/keys
  4. Clone the index with the command line to generate the known_host of the SSH URL:

    git clone git@github.com:Automic/Index.git

    The index URL is configured in the UC_SYSTEM_SETTINGS or UC_CLIENT_SETTINGS VARA objects.

    • Key: PM_INDEX_URL
    • Value: git@github.com:Automic/Index.git

    For more information, see PM_INDEX_URL

  5. Start the web application with the same user used to deploy the private key. For example, if the Administrator user was used to deploy the private key in C:\Users\Administrator\.ssh, the Administrator user has to be used to start the web application.

Configuring the Connection to a Proxy Server

If the server where your AWI is running has no Internet access, you can configure the PM_PROXY_SERVER and PM_PROXY_PORT keys to enter the connection details to a proxy server.

Important!

  • If the PM_PROXY_SERVER and PM_PROXY_PORT keys are not defined in the UC_SYSTEM_SETTINGS or UC_CLIENT_SETTINGS VARA objects, the settings are taken from the PROXY_SERVER and PROXY_PORT keys of the UC_TELEMETRY_SETTINGS VARA object.
  • If the PROXY_SERVER and PROXY_PORT keys are not defined in the UC_TELEMETRY_SETTINGS VARA object, the Internet is accessed directly.

More information:

Configuring the Import/Export Method for Packs

Packs can be imported and exported in two different formats:

  • .xml and
  • .json.

You can define which format to use either in the PACKS_COMPATIBILITY_MODE parameter of the UC_CLIENT_SETTINGS or by adding the corresponding option in the apm download command (Package Manager).

More information:

See also: