iS5 Communications RAPTOREye Linux Installation Guide

iS5 Communications RAPTOREye Linux Installation Guide

Overview

This document provides installation and upgrade instructions for the following products:

Upgrade Support
This document contains upgrade procedures supporting the following.

Introduction
The RAPTOREye Linux Installation Guide contains the information and steps required to install RAPTOREye on Linux. Please read each section carefully and ensure to complete all steps before proceeding further with the installation.

RAPTOREye supports two types of installation:

• New Installation
• Upgrade Installation

Prerequisites

This section lists the prerequisites to install RAPTOREye.

License
RAPTOREye requires a valid license file. Contact iS5 Support to obtain a license file for RAPTOREye. Once a license file is obtained, copy it to the machine which will run RAPTOREye.

Software Dependencies

The following packages should be present before installation:

• bc
• unzip
• net-tools
• fontconfig
• libicu
• zip

The packages may be installed with the following command: sudo yum install

Ports
The following ports are required for RAPTOREye to run. The installer will check if there are any conflicts with the ports listed below and issue a warning before continuing.

Requirements

This section lists the requirements to install RAPTOREye.

RAPTOREye Binaries
The following files are the official releases of RAPTOREye:

18fe1354a800e2880322c45591be3dc7d3a1ec2e3b599e6a08eaefdac5f76677 SHA-1 7a505d3419fc0cdfd7dd73dc3dc873de44676d72
RAPTOREye-LinuxInstaller-1.8.0.bin| SHA-256 3a39a410ca02851dd253ce0bed992fed9b05919ecf40deda810af6f5da5c6574 SHA-1 e2885eaff30b924c43ac5fcd3df4d09079a5dd17
RAPTOREye-LinuxInstaller-1.7.1.bin| SHA-256 83e786bcb395993965e9e955a16f0024992021b7c7bc219b48bb1ddf658d6b4b SHA-1 14cd5c7a4f06f22982c85ba8c73087c094338f59 MD5 f68cc785c12aa4c7301bda078dc29b8d
RAPTOREye-LinuxInstaller-1.7.0.bin| SHA-256 bc267036cabb8c99af71801bc1d2aff3f582e8668cdaac99d368ec39e074d643 SHA-1 a919b113da059200258bc130540acc93fee9c027 MD5 09d3f31e9753baa080e224c0fd61cb4b
RAPTOREye-LinuxInstaller-1.6.0.bin| SHA-256 27db3e82614203df82e7f3031b8780deb2a8155f55bfa3adcbabe1763c7040a2 SHA-1 0144568e93b683be2a046afe1a5edba8f7982a7b MD5 5cfb53c2fa97980afd556ca918651f0e
RAPTOREye-LinuxInstaller-1.5.1.bin| SHA-256 767c03d5d72611760aada6ef90e14005b33a416349430930f71b6d1bb ae2897e SHA-1 f5369d43d74144ec52d436c36f986b1a706960f0 MD5 f533998d0ae3a698afa50123150864c5
RAPTOREye-LinuxInstaller-1.5.0.bin| SHA-256 b9d01b67484e341fddd93b586f9063dcf6af9aaac5bfb77204f9776070a c7d23 SHA-1 2595f506154d69b31de250ecb5303f59a027fc86 MD5 0816ce95db673de4cfc961568c6a0cf1
RAPTOREye-LinuxInstaller-1.4.0.bin| SHA-256 c9d53cfe9433c95cd3b79f45ce0ff0f75fa3f07672422f2df1bcb38b3357 e054 SHA-1 9d9b2c495a8139d0da5528d53ebf0acf936d1e99 MD5 66f408536cd9a160f7426c89200fd0ac
RAPTOREye-LinuxInstaller-1.3.0.bin| SHA-256 6bad3678753e99bb9be612bf6eea8af3e28d317397d34c2bdbefcd547 d39d382 SHA-1 2c77408d59be5b39b7ba57cd03369f04511ef6f3 MD5 4978d3dc8cb1259f604f5907f6a6b195
RAPTOREye-LinuxInstaller-1.2.0.bin| SHA-256 62e5f0e94aa610c7636cbdcb4cfe755b3ebcef5256a6281a65f7389b90 a7b70e SHA-1 bffa0f405137cb1d75182e25ca5643e80c27a633 MD5 c11c7d952104cea23d4dbe8dbe68505e

Software Requirements
RAPTOREye can run on the following version of Linux:

• CentOS 7.x

Supported Web Browsers
The following web browsers are required to run RAPTOREye:

• Mozilla Firefox: https://www.mozilla.org/en-US/firefox/new/
• Google Chrome: https://www.google.com/chrome/
  It is recommended to use a screen resolution of 1366 x 768 or higher.

Hardware Requirements

The minimum resource requirements for the RAPTOREye server are:

• Processor: Quad Core 2.66 GHz
• Memory (RAM): 8 GB
• Disk Space: 100 GB

The minimum resource requirements for the web browser client are:

• Processor: Single Core 2.66 GHz
• Memory (RAM): 2 GB
• Disk Space: 20 GB

Installing RAPTOREye – New Installation

This section describes how to install RAPTOREye on Linux as a new installation.
CONTEXT:
The following steps are involved in a new installation of RAPTOREye:

1. Login as a user who is a member of the wheel group.

2. Ensure the RAPTOREye installer has execute permissions.
   FOR EXAMPLE: chmod +x RAPTOREye-LinuxInstaller-1.9.0.bin

3. Run the RAPTOREye installer.
   FOR EXAMPLE: sudo ./RAPTOREye-LinuxInstaller-1.9.0.bin
   STEP RESULT: You should see the following:
   Welcome and thank you for using the RAPTOREye.
   Please choose any of the below options and press ‘Enter’

   ---

   RAPTOREye Setup

   ---

4. Install/Upgrade RAPTOREye – 1.9.0

5. Uninstall existing RAPTOREye installation

6. Quit

   ---

   Enter an option from the above menu :

7. Enter 1 to install RAPTOREye.
   STEP RESULT: The following prompt will appear:
   You have chosen the option – Install RAPTOREye.
   RAPTOREye 1.9.0 INSTALLER SETUP Preparing to commence RAPTOREye Network Management System installation.
   This software and related documentation (the “iS5Com Materials”) is licensed by iS5 Communications Inc. subject to the terms and conditions of an end u ser license agreement (the “EULA”). All use of the iS5Com Materials must be in accordance with the EULA.
   The EULA can be found at: https://is5com.com/terms-and-conditions/.
   Do you agree with the terms above? [ YES (y) | NO (n)] :

8. Read the License Agreement then enter y then press enter
   Note:The full RAPTOREye License Agreement can be found at the following URL: http://is5com.com/terms-and-conditions/
   STEP RESULT: The installer will perform the following checks:
   Note: The IP address and OS Version might be different then what is shown below
   10.2.0.12 address is selected from ifconfig command result.
   RAPTOREye server ip will be 10.2.0.12
   OS : CentOS Linux release 7.9.2009 (Core)
   Architecture : x86_64
   Both OS and Architecture are supported by RAPTOREye 1.9.0.
   Going to perform memory checks..
   Memory checks done..
   Going to perform disk space checks..
   Disk space checks done..
   No RAPTOREye installation found at /opt/product/iS5/NMS. Proceeding with fresh installation..

9. The following prompt will appear:
   STEP RESULT:
   Enter PostgreSQL DB username [Default: admin] :

10. Press Enter to accept the default username or type in the preferred username and press Enter to continue.
    STEP RESULT: The following prompt will appear:
    Enter password [Default: admin123]:

11. Press Enter to accept the default password or type in the preferred password and press Enter to continue.
    STEP RESULT: The following prompt will appear:
    Enter the location of the license file in the system : [Example:
    /root/LicenseFile]:

12. Type in the full path to where the RAPTOREye license file is located and press Enter.
    FOR EXAMPLE: /root/LicenseFile
    STEP RESULT: The following will occur:

    • The installer will check the required ports are available. If the ports are not available, the installer will show a warning. You will need to make those ports available and start the installation again.
      Going to perform port availability checks…
      Port availability checks successful.

    • The installer will check if the linux firewall is enabled. If a firewall is enabled, you will be notified with a warning message and you can disable the firewall.
      Going to perform firewall checks…

    • The installer will unzip all required packages and copy the license file to the required location.
      Installing RAPTOREye …
      Please wait while packages are unzipped …
      iS5_NMS_Complete_Linux.zip successfully unzipped
      jre_Linux64bit.zip successfully unzipped.
      Copying license files …
      License files successfully copied.

    • The installer will start PostgreSQL and create a database. During this process the installer will ask you to input the Postgres password 3 times. Please enter the same password as chosen previously
      Please wait while starting PostgreSQL …
      Startup may ask for the database password up to three times. Reminder: the password entered was “admin123”.
      Password for user admin:
      Password for user admin:
      Password for user admin:

    • The RAPTOREye server will run as a service (service name is nms).
      Note: The IP address, password and log file name may be different then what is show below
      Starting RAPTOREye as a service …
      Server startup may take a while, please check server log files for completion.
      Checking whether RAPTOREye server has started …
      RAPTOREye Server Started Successfully.
      Now you can start managing your iS5 RAPTOREye devices by connecting to the RAPTOREye Web interface at https://10.2.0.12
      Default Username: admin and Password: admin123
      The log file from this installation is available at /opt/product/iS5/NMS/server/ems/log/RAPTOREye_install_20210316 104946.log
      Installation Successful

RESULT:
RAPTOREye has now been successfully installed.

Installing RAPTOREye – Upgrade Installation

This section describes how to upgrade RAPTOREye on Linux.

PREREQUISITE:
A previously released version of RAPTOREye has been installed on the system you intend to upgrade.

CONTEXT:
The following steps are required to upgrade RAPTOREye.

1. Login as a user who is a member of the wheel group.

2. Ensure the RAPTOREye installer has execute permissions.
   FOR EXAMPLE: chmod +x RAPTOREye-LinuxInstaller-1.9.0.bin

3. Run the RAPTOREye installer.
   FOR EXAMPLE: sudo ./RAPTOREye-LinuxInstaller-1.9.0.bin
   STEP RESULT: You should see the following:
   Welcome and thank you for using the RAPTOREye.
   Please choose any of the below options and press ‘Enter’

   ---

   RAPTOREye Setup

   ---

4. Install/Upgrade RAPTOREye – 1.9.0

5. Uninstall existing RAPTOREye installation

6. Quit

   ---

   Enter an option from the above menu :

7. Enter 1 to upgrade RAPTOREye.
   STEP RESULT: The following prompt will appear:
   You have chosen the option – Install RAPTOREye.
   RAPTOREye 1.9.0 INSTALLER SETUP
   Preparing to commence RAPTOREye Network Management System installation.
   This software and related documentation (the “iS5Com Materials”) is licensed by iS5 Communications Inc. subject to the terms and conditions of an end u ser license agreement (the “EULA”). All use of the iS5Com Materials must be in accordance with the EULA.
   The EULA can be found at: https://is5com.com/terms-and-conditions/.
   Do you agree with the terms above? [ YES (y) | NO (n)] :

8. Read the License Agreement then enter y then press enter
   Note:The full RAPTOREye License Agreement can be found at the following URL: http://is5com.com/terms-and-conditions/
   STEP RESULT: The following prompt will appear:
   RAPTOREye installation already exists (1.8.0) at /opt/product/iS5/NMS
   Do you want to upgrade it to the latest version?: YES(y)/NO(n) [Default:YES]:

9. Press Enter.
   STEP RESULT: The following will occur:

   • The installer will perform the migration check and stop the existing RAPTOREye server.
   • The installer will perform Memory and Disk space checks.
   • The installer will confirm the required ports are available. If the ports are not available, the installer will show a warning. You will need to make those ports available and start the installation again.
   • The installer will check if a firewall is enabled. If a firewall is enabled, you will be notified with a warning message and you can disable the firewall.

10. The installer will prompt if you would like to restore the old SSL certificate.
    FOR EXAMPLE: Do you want to resotre old SSL Certificate? [ YES (y) | NO (n)] [Default: NO]:

11. Type y and press Enter to restore the SSL certificate.
    STEP RESULT: The following will occur:

    • The installer will restore the SSL certificate.
    • The installer will restore the database and other settings from the backup.
    • The RAPTOREye service will start.

RESULT:
RAPTOREye has now been successfully upgraded.

Start RAPTOREye Server

This section describes how to start the RAPTOREye Server.

CONTEXT :
The following step is required to start the RAPTOREye server:

1. To start the RAPTOREye server manually, open a terminal on the RAPTOREye server machine and run the following command:
   FOR EXAMPLE: sudo service nms start
   To view startup progress of the service refer to the ems.log file available in:
   /opt/product/iS5/NMS/server/ems/log

RESULT:
RAPTOREye has now been successfully started.

Stop RAPTOREye Server

This section describes how to stop the RAPTOREye Server.

CONTEXT:
The following step is required to stop the RAPTOREye server:

1. To stop the RAPTOREye server manually, open a terminal on the RAPTOREye server machine, and run the following command.
   FOR EXAMPLE: sudo service nms stop

RESULT:
RAPTOREye has now been successfully stopped.

References

• Terms & Conditions - iS5 Communications
• RAPTOREye License Agreement - iS5 Communications
• Get Firefox for desktop — Mozilla (US)

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>