Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Aperi/install

Plan for the Database Repository

Use this section to determine what relational database to use as the database repository for Aperi. There are two relational databases available for use with Aperi:

  • Apache Derby is a relational database implemented entirely in Java and available under the Apache License, Version 2.0. Click here for more information. Apache Derby is included with the Aperi installation and can be installed using the Aperi Configurator. Click here for instructions on how to install it using the Aperi Configurator.

Note about Apache Derby Security: Aperi Storage Manager does not currently implement all the security features in Derby for an enterprise-wide management application. Most notably, the Aperi Configurator does not configure any user authentication for the Derby RDBMS.This means that anyone will be able to connect to and use the installation of Derby that comes with Aperi.

HOWTO Install DB2 for the Aperi Repository

Download and Unzip Aperi Storage Manager files

Install the Aperi Storage Manager files on machines:

  • Whose storage you want to manage and monitor.
  • Where you want to run the Aperi Storage Manager's user interface
  • Where you want to run the server component. This machine must be able to communicate with the machines where you install the agents and user interface.

Perform the following steps to install the server, agent, or GUI on a machine:

  1. Locate the Aperi Storage Manager .zip file.
  2. Place the .zip file in the directory where you want to install the product.
  3. Use an unzipping tool to unzip the file.
  4. Download required components that are not distributed with the Aperi Storage Manager .zip file. There are two methods for downloading required third-party files:
    1. Use Aperi's Installer to automatically download the files
    2. Manually download and install the required files by hand HOWTO Hand download and install external dependencies

Install Aperi Storage Manager

Use the Install tool to set up Aperi Storage Manager components on the machine where you unzipped the product. The package that you unzipped contains the run-time files for all of Aperi Storage Manager's main components: a host-based agent, a server, and a GUI. You do not have to configure all the components on each machine; rather, use the Installer to set up only the components that you want to run on a particular machine.

   Note: Keep in mind that you must configure the server on one machine, called the "server host". The server host normally also has the agent and GUI configured on it.

The Installer will ask you several questions to help you configure Aperi Storage Manager for your environment.

Make sure you have a Java Runtime Environment (JRE) from IBM or Sun 1.5 installed on your machine.

  3. Change to the [aperi_install_directory>\install subdirectory where you installed the Aperi Storage Manager files. For example, type cd c:\aperi\install ] and press Enter.
  4. Start the Installer using the following steps:
     Note: when running under Linux, you must first execute the following command against the cfgaperi file: chmod +x install
         * Type install and press Enter. Continue to the next section.
  5. Use the Installer

When the Installer starts, a graphical interface will appear:

  1. The welcome screen introduces the installer.  Press Next.  
  2. Read the license agreement.  Press Accept.
  3. Indicate which components you want to configure on the machine. If this is your first time, or you wish to do things "normally", accept the defaults and answer Next.
  4. Agent - If you are configuring the agent, you are asked to supply port value for the subagent. The subagent will open a socket on this port for communication with the server. You may choose any valid port number (0..65535) although, of course, you should not choose a port that are already in use. The only reason to override the default for this two question is when you know the default value is already in use.
  5. Server - Configure the servers: data, device, and report servers.  If you answered Yes to the server question in step 1, the following will appear:
     * Server hostname: [localhost]
     * Data server port: [9549]
     * Device server port: [9000]
     * Administrator group: [Administrators]
     * Report server repository path: [default path]


  6. Database - Either Derby or DB2.  If the database already exists, a new one will not be created.
     * Hostname: [localhost]
     * Port: [default]
     * Driver: [default]
     * Username (if db2)
     * Password (if db2)
  7. Installation Progress - Click install to begin the actual installation (configuration)

Uninstall Aperi Storage Manager

To uninstall Aperi:

  1. Shut down any Aperi components that are running. See Shut Down Aperi Storage Manager for instructions on how to shut down Aperi components.
  2. Delete the Aperi installation directory.

Back to the top