Installing and Configuring the Package Manager

As a system administrator, you install and configure the Package Manager to manage Packs on an Automation Engine client.

As of version 21.0, the Automation Engine and the Java components communicate using TLS/SSL. These components establish a connection with the Java communication process (JCP), which uses trusted certificates to prove its identity to other communication partners.

You can use the trustedCertFolder= parameter in the respective configuration file to define the path to the folder where the trusted certificates are stored. Otherwise, the certificates should be installed in the Java trust store. For more information, see Securing Connections to the AE (TLS/SSL).

This page includes the following:

Installing the Package Manager

  1. Download the Package Manager from https://downloads.automic.com/.
  2. Unpack the .zip file to your preferred location.

    Example: C:\Automic\apm.

    Note: If you have downloaded the full product bundle, you find the Package Manager in the Tools/Package.Manager folder.

  3. (Optional) Add the \bin folder to your PATH environment variable.

Configuring the Package Manager

  1. Set up the connection to your AE in the uc4config.xml file or copy your AE configuration file uc4config.xml to the conf folder.

    Example: C:\Automic\apm\conf

  2. (Optional) Store your credentials in the login_dat.xml file that is located in the conf folder.

    APM accesses the AE. Therefore APM prompts for AE user name and password.

    Tip: If you want to store the credentials so that you do not have to enter them every time, store your credentials (system name, client, department, user) in the login_dat.xml file.

    Note: The password is never read from login_dat.xml. You must use the parameter -pw <password>.

  3. (Optional) If you want to have the local repository somewhere else than in the folder where the Package Manager application is located (Example: C:\Automic\apm), you can add a location element in the pmconfig.xml file located in the conf folder

    Example:

    <localRepo> <location>C:\myrepo</location> </localRepo>

  4. Ensure that the user executing the Package Manager has write permissions on the folder where the local repository is stored.

Folder Structure

The folder structure after a new installation is the following:

  • Package Manager Program Folder: C:\Automic\apm (example)

    • \bin

      Contains executables apm and automic-pm

    • \conf

      Contains configuration files (operational/templates)

    • \lib

      Contains JAR archives

    • \locale

      Properties files for localization

Other folders after first package import are:

  • Package Manager Program Folder: C:\Automic\apm (example)

    • \index

      Contains index files

    • \logs

      Contains log files (trace.log)

    • \packages

      Contains downloaded packages

See also: