Install the Platform Analytics server

Install the Platform Analytics server on a UNIX or Windows host.

What you need to do

Check the following:

  • The Platform Analytics server host meets the detailed system and software requirements.

    For more details, refer to Prepare for the Platform Analytics installation.

  • The Platform Analytics server host operating system can handle daylight savings time correctly.

  • You removed any previous installations of Platform Analytics from your host.

  • If you are installing on a UNIX host, your host must have access to the X-Windows environment:

    • If you are connected to the intended Platform Analytics server host locally, the host must be running X-Windows.

    • If you are connected to the intended Platform Analytics server host via telnet, you must be running xserver on your local host.

  • The required ports for the Platform Analytics and database hosts are free. If a firewall exists, all these ports must be open in the firewall. All the required ports are TCP.

    For more details, refer to Platform Analytics hosts.

  • The Vertica database host is properly configured and running.

  • The Platform Analytics node host has access to the Vertica JDBC driver.

  • The Oracle database host is properly configured and running:

    • You have a user name, password, and URL to access the database server.

    • There is appropriate space in the database allocated for Platform Analytics.

    • Platform Analytics supports your version of the Oracle database.

  • The Platform Analytics server host has access to the Oracle JDBC driver (version 10.2.0.3 only). This driver is available from the following URL:

    http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html

  • The Platform Analytics server host has access to the Platform Analytics license file (license.dat).

  1. Log into the intended Platform Analytics server host.
    • In UNIX, if you log in as root, you will be able to update the rc.boot scripts and specify the user name and group of the Platform Analytics administrator during the installation.

      Otherwise, log in as the intended Platform Analytics administrator account.

    • In Windows, log in as the intended Platform Analytics administrator account.

  2. If you connected to the UNIX host via telnet and are running xserver on a local host, set your display environment.

    Test your display by running xclock or another X-Windows application.

    If the application displays, your display environment is already set correctly; otherwise, you need to set your display environment.

    • For csh or tcsh:

      setenv DISPLAY hostname:0.0

    • For sh, ksh, or bash:

      DISPLAY=hostname:0.0

      export DISPLAY

    where hostname is your local host.

  3. Run the Platform Analytics server installation package.
    • UNIX: ./platform_analytics8.0.2_server_platform.bin

    • Windows: platform_analytics8.0.2_server_platform.exe

  4. Follow the dialog prompts to complete the installation.

    To install the Platform Analytics server, you may need to input the following:

    • Installation directory

      Accept the default file path or specify your own installation directory.

      In this documentation, ANALYTICS_TOP refers to the top-level Platform Analytics installation directory in your host.

    • Base communication ports

      The Platform Analytics server requires the use of two consecutive ports, starting with the base port. The default base port is 9091, therefore, the Platform Analytics server uses ports 9091 and 9092 by default.

    • Email notification settings

      You can receive notifications of events via email. This means you will be made aware of potential problems in your cluster without having to constantly monitor the Platform Analytics Console.

      After enabling email notifications, specify the SMTP mail server and the intended recipient of the email notifications. The intended sender is the account that is used to send the email notifications.

      Note:

      You should enable the email notification during the initial installation rather than at a later time. If you do not enable email notification, you will need to check the Platform Analytics Console regularly to make sure that Platform Analytics is working properly.

    • Database connection properties

      Choose to connect to either the Vertica or Oracle database.

      The user name and password is generally the account that you used to create your database schema.

    • Set RC properties, if you installed on a UNIX host as root.

      Enable this setting to update the rc.boot script.

  5. If you are installing on a UNIX (Solaris or Linux) host, start the Platform Analytics server.

    ANALYTICS_TOP/bin/perfadmin start all

  6. Verify that the pats service has started.
    • UNIX: ANALYTICS_TOP/bin/perfadmin list

    • Windows: ANALYTICS_TOP\bin\perfadmin list