You are here: RPM Installation > Installation and Configuration > Installing Insight

3.11 Installing Moab Insight

This topic contains instructions on how to install Moab Insight (Insight).

Because Insight accumulates data for one cluster at a time, one Insight Server (daemon) should service one Moab instance.

Moab Workload Manager and Insight both tend to heavily consume system resources. Therefore, Adaptive Computing requires that the Insight Server and the Moab Workload Manager Server run on different hosts. For these installation instructions, the "Moab Server Host" refers to one host and the "Insight Server Host" refers to another host.

In this topic:

3.11.1 Open Necessary Ports
3.11.2 Dependencies, Packages, or Client Installations
3.11.3 Install Insight

3.11.1 Open Necessary Ports

If your site is running firewall software on its hosts, you will need to configure the firewall to allow connections to the necessary ports.

Location	Ports	Functions	When Needed
Insight Server Host	5568	Insight Server Port	Always
Moab MongoDB Database Host	27017	Moab MongoDB Server Port	Always
Insight MongoDB Database Host	27017	Insight MongoDB Server Port	Always
Moab Server Host	5574	Moab Data Port	Always
Moab Server Host	5575	Moab Reliability Port	Always

See 2.11 Opening Ports in a Firewall for general instructions and an example of how to open ports in the firewall.

3.11.2 Dependencies, Packages, or Client Installations

In this section:

3.11.2.A Install Java
3.11.2.B Install MongoDB

3.11.2.A Install Java

Install the Linux x64 RPM version of Oracle® Java® 8 Runtime Environment.

Oracle Java 8 Runtime Environment is the recommended Java environment, but Oracle Java 7 is also supported. All other versions of Java, including OpenJDK/IcedTea, GNU Compiler for Java, and so on cannot run Insight.

On the Insight Server Host, do the following:

Install the Linux x64 RPM version of Oracle Java SE 8 JRE.
1. Go to the to the Oracle Java download page.
2. Copy the URL for the Linux x64 RPM version, and run the following command:
```
[root]# rpm -Uh <URL>
```

3.11.2.B Install MongoDB

On the Insight MongoDB Database Host, do the following:

Install MongoDB.
```
[root]# yum install -y mongodb-org
```

Enable and start MongoDB.

[root]# chkconfig mongod on
[root]# service mongod start

Add the required MongoDB users to the Insight MongoDB and Moab MongoDB; regardless of whether they share a host.

The passwords used below (secret1, secret3, and secret4 are examples. Choose your own passwords for these users.
- Insight MongoDB
```
[root]# mongo
> use admin
> db.createUser({"user": "admin_user", "pwd": "secret1", "roles": ["root"]})

> use insight
> db.createUser({"user": "insight_user", "pwd": "secret4", "roles": ["dbOwner"]})
> db.createUser({"user": "mws_user", "pwd": "secret3", "roles": ["read"]})
									
> exit
```
- Moab MongoDB
```
[root]# mongo
> use admin
> db.auth("admin_user", "secret1")

> use moab
> db.createUser({"user": "insight_user", "pwd": "secret4", "roles": ["read"]})

> exit
```
Because the admin_user has read and write rights to the admin database, it also has read and write rights to all other databases. See Control Access to MongoDB Instances with Authentication for more information.

Set MongoDB Configuration Options.
- The configuration file for MongoDB is /etc/mongod.conf. See https://docs.mongodb.com/manual/reference/configuration-options for information.
- Adaptive Computing recommends that you set security.authorization to enabled. See https://docs.mongodb.com/manual/reference/configuration-options/#security-options for more information.
By default, /etc/mongod.conf sets net.bindIp to 127.0.0.1. You will need to change this setting if the MongoDB server needs to be accessible from other hosts or from other interfaces besides loopback. See https://docs.mongodb.com/manual/reference/configuration-options/#net-options for more information.
```
# Sample /etc/mongod.conf file
net:
  port: 27017
  # bindIp: 127.0.0.1
processManagement:
  fork: true
  pidFilePath: /var/run/mongodb/mongod.pid
security:
  authorization: enabled
storage:
  dbPath: /var/lib/mongo
  journal:
    enabled: true
systemLog:
  destination: file
  logAppend: true
  path: /var/log/mongodb/mongod.log
```
Restart MongoDB.
```
[root]# service mongod restart
```

3.11.3 Install Insight

You must complete the tasks to install the dependencies, packages, or clients before installing Insight Server. See 3.11.2 Dependencies, Packages, or Client Installations.

If your configuration uses firewalls, you must also open the necessary ports before installing Insight Server. See 3.11.1 Open Necessary Ports.

These instructions contain steps to edit the /opt/insight/etc/config.groovy file.

Commented out values in the config.groovy file are not necessarily the default values.

It is recommended that anytime you edit the config.groovy file that you first stop Insight, edit the file and then restart Insight.

If you have not already done so, complete the steps to prepare the Insight Server Host. See 3.3 Preparing for RPM Installs for more information.
On the Insight Server Host, install the Insight RPM.
```
[root]# yum install moab-insight
```
If the installation returns the following warning line:
warning: rpmts_HdrFromFdno: Header V4 RSA/SHA1 Signature, key ID 952741e1: NOKEY
Retrieving key from file:///opt/adaptive-rpm-repository/key/GPG_ADAPTIVE_COMPUTING_INC_EL_6_KEY
Importing GPG key 0x952741E1:
Userid: "Adaptive Computing Enterprises, Inc. (EL 6 key) <[email protected]>"
From : /opt/adaptive-rpm-repository/key/GPG_ADAPTIVE_COMPUTING_INC_EL_6_KEY
This is normal. You can safely input y and continue.
If you are using MWS, on the MWS Server Host, do the following:
1. Add or edit the following parameters in the /opt/mws/etc/mws-config.groovy file to specify connection information for the Insight Server.
```
insight.server = "<insight_server_ip_address>"
insight.command.port = 5568
insight.command.timeout.seconds = 5
```
  In this example,
  - <insight_server_ip_address> represents the DNS name for the host on which the Insight Server is running.
  - the default Insight command port number (5568) is used.
  See Configuration in the Moab Web Services Reference Guide for more information on the MWS configuration properties.
2. Restart Tomcat.
```
[root]# service tomcat restart
```
Configure Insight's connection to the Insight MongoDB database and the Moab MongoDB database. On the Insight Server Host, edit /opt/insight/etc/config.groovy as follows:
```
mongo.host="<insight mongo host>"
mongo.port=<insight mongo port>
mongo.username="insight_user"
mongo.password="secret4"

moab.mongo.host="<moab mongo host>"
moab.mongo.port=<moab mongo port>
moab.mongo.username="insight_user"
moab.mongo.password="secret4"
```
Use mongo.host="localhost" when the Insight MongoDB resides on the Insight Server Host (strongly recommended).
"secret4" is the password you specified when installing the mongoDB. See 3.11.2.B Install MongoDB.
On the Insight Server Host, verify that Insight runs on startup.
```
[root]# chkconfig insight on
```
On the Moab Server Host, configure Moab's connection to Insight.
1. In /opt/moab/etc/moab.cfg, configure the INSIGHTENDPOINT parameter so that Moab can connect to Insight. See Moab Parameters in the Moab Workload Manager Administrator Guide for parameter information.
```
INSIGHTENDPOINT <hostname>[:<port>]
```
  <hostname> is the server where Insight is located. <hostname> is required, <port> is optional.
2. If you have not done so already when installing MWS, in /opt/moab/etc/moab-private.cfg file, configure the MESSAGEQUEUESECRETKEY parameter so that Moab can connect to Insight. See Secure communication using secret keys.
```
MESSAGEQUEUESECRETKEY <secret key>
```
  The <secret key> is required when updating the Insight configuration file later in this procedure.
3. Restart Moab in order for the new configuration parameters to take effect.
```
[root]# service moab restart
```
4. Verify that Moab is properly configured to connect to Insight.
```
[root]# mdiag -S | grep Insight
```
  You should see something similar to the following:
```
ZeroMQ Insight connection is bound on port 5574 (reliability port 5575) on host * using Insight endpoint <the insight hostname displays here>:5568
encryption is on)
ZeroMQ Insight reliable message delivery is using store file(s) up to 1024 MB in /opt/moab/spool/insight_store/
```
On the Insight Server Host, configure the moab.host and messageQueue.secretKey parameters in the Insight configuration file /opt/insight/etc/config.groovy.
```
moab.host = "<moab server>"
messageQueue.secretKey = "<secret key>"
```
The <secret key> must match the secret key configured in moab-private.cfg on the Moab server for the MESSAGEQUEUESECRETKEY configuration parameter.
On the Insight Server Host, start Insight.
```
[root]# service insight start
```
The first time you start Insight it will take a minute or two to create the database schema. Although 'service insight start' will quickly return OK, it is not safe to terminate Insight while this initialization is taking place. Rebooting or terminating Insight during this initialization may cause the database to not be initialized correctly.
You will know it is safe to reboot or terminate Insight if you see the following line in /opt/insight/log/insight.log.
```
2014-12-11T18:36:08.059-0700    main    INFO    com.ace.insight.app.Application 0           Started Application in 89.502 seconds (JVM running for 89.882)
```