Page History

Prerequisites

• The individual performing this installation has a small bit of Linux experience.

• Root access is available.

• Internet access is required for installing any missing, but required software packages.
• NMIS must be installed on the same server that opEvents is being installed on. opEvents requires If you do not yet have a working MongoDB installation (but not necessarily on the same server)installation of NMIS in your server, please follow the procedure in the NMIS 8 Installation Guide and install NMIS before installing opEvents
• You will need a license for opEvents (evaluation available here HERE).
• All licenses are added/updated at https://<hostname>/omk/opLicense .

Preparation

• For detailed information about Opmantek's interactive installer, including installation options (non-standard directory, non-interactive install, etc.)  please review the Opmantek Installer page.

• opEvents requires a working MongoDB installation (but not necessarily on the same server). With If you do not have a MongoDB installation yet, either follow the instructions in the MongoDB Installation Guide or (with opEvents 1.2.6 and newer ) tell the installer to will install and configure MongoDB for you. For previous versions of opEvents please follow the instructions in the MongoDB Installation Guide

  • While opEvents does not require any specific MongoDB setup,

  but

  • you will have to provide opEvents with the correct MongoDB server information, database name and user name/password (if you use authentication). opEvents works best with the default database name "nmis", and with MongoDB authentication enabled.

• If you do not yet have a working installation of NMIS in your server, please follow the procedure in the NMIS 8 Installation Guide.
• Download opEvents from the Opmantek website.

Installing (or Upgrading) opEvents

As of February 2016, opEvents is distributed in a self-extracting download format that simplifies the installation process quite a bit. More information on running the installer can be found HERE: The Opmantek Installer

Transfer the opEvents tarball installer onto the server in question, either by direct download from the Opmantek website (using wget as demonstrated below), or from your desktop with scp or , sftp or a similar file transfer tool.
Make a record of where you put the tarball installer (we recommend using root's home directory or /tmp are as good locations).

• Become root and unpack the tarball:

  Code Block# become root sudo sh # if the tarball was saved in a different location, adjust the following command cd tar xzf opEvents-x86_64-1.2.0.tar.gz

  Remember, you must have root access to run the installer, so either use sudo or log in as root.

• Start the interactive installer and follow its instructions. The installer now fully covers both initial installations as well as upgrades from earlier versions of opEVentsopEvents.

  Code Block

  sudo sh cd opEvents-1.2.0 ./installer# Next, start the interactive installer and follow the prompts. sh ./opEvents-Linux-x86_64-2.4.1.run Verifying archive integrity... All good. Uncompressing opEvents 2.4.1 100% ++++++++++++++++++++++++++++++++++++++++++++++++++++++ opEvents (12.24.01) Installation script ++++++++++++++++++++++++++++++++++++++++++++++++++++++ This installer will install opEvents into /usr/local/omk. To select a different installation location please rerun the installer with the -t option. Ok to proceed with installation? Type 'y' or <Enter> to accept, or 'n' to decline: ...

  
  

• The installer will interactively guide you through the steps of installing opEvents. Please make sure to read the on-screen prompts carefully.
• When the installer finishes, opEvents is installed into /usr/local/omk, and the default configuration files are in /usr/local/omk/conf, ready for your initial config adjustments.
• A detailed log of the installation process is saved as /usr/local/omk/install.log, and subsequent upgrades or installations of other Opmantek products will add to that logfile.
  
• For detailed information about the interactive installer please check the Opmantek Installer page.
a small warning: the
• 
  

Initial Configuration

• You If the interactive installer installed MongoDB it will also configure opEvents to connect to it. However, if you did not instruct the installer to install mongoDB, or if yoy want to point opEvents to use mongoDB on another server, you will need to adjust the MongoDB-related settings:open 

  • Open /usr/local/omk/conf/opCommon.nmis in an editor, go to the database section and change the server, username and password to reflect your MongoDB installation.

  • The

  result

  • example below is from a default installation with a local MongoDB installed by the opEvents installer. Your entries should look similar to the following (but there might be extra settings related to other products):

    Code Block
    'database' => { 'db_admin_port' => '28017', 'db_connection_timeout'

  • => 20000, 'db_

  server

  • name' => '

  localhost

  • nmis',

  • 'db_password' => 'op42flow42', 'db_ping_timeout' => 2000, 'db_port' => '27017',

  • 'db_query_timeout' => 5000, 'db_

  name

  • server' => '

  nmis',

  • localhost', 'db_use_v26_features' => 1, 'db_username' => 'opUserRW',

  • 'db_

  password

  • write_concern' =>

  'op42flow42',

  • 1 },

    
    

• For opEvents versions before 1.2.2 Only 

/usr/local/omk/bin/opeventsd.pl act=setup
# you can also get an overview of opeventsd's capabilities by running opeventsd.pl --help

• After completing your configuration changes you'll need to restart both the opEvents daemon (opeventsd) as well as the Opmantek daemon (omkd).
  Simply run the following commands as root:

  Code Block
  # don't forget to become root, using sudo sh or su service opeventsd restart service omkd restart # to verify the status of the daemons: service opeventsd status service omkd status

  
  

...

opEvents offers a rich and flexible set of configuration options to ensure it meets your requirements, but there are many more options than can be listed here. Please consult the opEvents documentation for details.