Skip to main content
Jump to: navigation, search


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.

Skip to the next section if you plan to use Apache Derby as the database repository.

  • DB2 8 for Linux UNIX and Windows. Click here for more information about this relational database.

Complete the steps in this section if you plan to use DB2 as the Aperi database repository.

Perform the following steps to download and set up DB2 for use with Aperi Storage Manager:

  1. Download DB2. You can download DB2 from here.
  2. Install DB2 using the default settings. Note the db2admin password that you choose during the installation.
  3. Continue to the next section Install the Aperi Storage Manager files.

Install 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.

  1. Make sure you have a Java Runtime Environment (JRE) from IBM or Sun 1.5 installed on your machine. To check for Java on a machine, start a command prompt window (Start > Programs > Accessories > Command Prompt) and type java -version from a command line.
     If you see text similar to the following then continue to step 2:
     java version "1.5.0_07"
     Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_07-b03)
     Java HotSpot(TM) Client VM (build 1.5.0_07-b03, mixed mode)
     If you see text like the following, download the JRE from the IBM or Sun ( web sites before continuing:
     'java' is not recognized as an internal or external command, operable program or batch file.
  2. Set java into your PATH by typing the following at the command prompt:
     set path=%path%;C:\path_to_java_directory\jdk1.5.0_07\bin
     where path_to_java_directory represents the directory where the JRE is installed.
     Setting the Java path has two purposes: 1) it is used to run the Installer, and 2 ) it is stored in the Aperi startup scripts and used to run Aperi Storage Manager. This means that if you later uninstall the Java with this path, you won't be able to start Aperi Storage Manager until you reconfigure Aperi.
     Note: You can also edit the install.bat file or the System Path to contain the JRE pathname.
  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.

Copyright © Eclipse Foundation, Inc. All Rights Reserved.