Follow

How can I install Intigua using RPM's?

Here are the steps for installing Intigua using RPM's.

List of RPMs

Here's a tables with the name and description of the RPMs

RPM
Description
intigua-server-base-XXX-XXX.x86_64.rpm

Contains the tomcat server. doesn't include the intigua software

deploys to: /usr/share/tomcat

intigua-server-XXX-XXX.x86_64.rpm

The intigua server war

deploys to: /usr/share/tomcat/webapps

intigua-connector-XXX-XXX.x86_64.rpm

vLink installers. Doesn't install the vlink it self, just makes the installers available to the intigua server.

deploys to: /usr/share/intigua/bin,package

intigua-web-XXX-XXX.x86_64.rpm configures nginx settings, SSL certificates and firewall rules to allow port 80 and 443 communication
intigua-va-XXX-XXX.x86_64.rpm final touches, like rest api

Step-by-step guide

Provision a machine

1.  Provision OS

Provision a new CentOs\RHEL 6 64 bit machine.  Recommended minimum specifications are:

  • CPU: 8 cores
  • RAM: 8 GB
  • Disk: 50 GB

2.  Configure a resolving hostname.

Intigua 2.6 needs to access its host server by hostname. To enable this:

  • Configure a server hostname:
    • Log into the server, and open the following file for editing: /etc/sysconfig/network

      Edit network settings
      vi /etc/sysconfig/network
    • Set the HOSTNAME to the new hostname. For example: HOSTNAME="intigua.example.com"
    • Save the file.
    • Run:

      Hostname
      hostname <hostname>
    • where <hostname> is the new hostname. For example:

      Hostname
      hostname intigua.example.com
  • Make sure the hostname is accessible by local applications:
    • Run:

      Hostname FQDN
      hostname -f
    • If the correct hostname is returned, it is available to applications and you're done with this. Otherwise:
    • Check if nss-myhostname is installed. If not, run:

      Install nss-myhostname
      yum install nss-myhostname
    • and wait for installation to complete.
    • Open the following file for editing: /etc/nsswitch.conf
       

      Edit nsswitch.conf
      vi /etc/nsswitch.conf
    • Find the line beginning with hosts, and add the new hostname to the end of the line. For example, change
      hosts: files mdns4_minimal dns
      to
      hosts: files mdns4_minimal dns intigua.example.com
    • Again run hostname -f to confirm that the hostname is successfully resolved.

3.  Install OS pre-req's

In case you installed a minimal CentOS system, we need the 'patch' packages to be installed.

Install patch package
yum install patch

4.  Install NGINX

To install nginx using yum, create the file "/etc/yum.repos.d/nginx.repo". if you are using RHEL 6, just copy-past this configuration:

nginx.repo for RHEL 6.X
[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/rhel/6/$basearch/
gpgcheck=0
enabled=1

and then execute

install nginx
yum install nginx

See full instructions: see http://wiki.nginx.org/Install

After installing, remove the nginx default configuration file at /etc/nginx/conf.d/default.conf

as the intigua-web packges will install an intigua configuration file with conflicting settings.

5.  Install Java

Install Java JDK 7, by downloading the rpm, and install it ("rpm -i").  Do not use the default open jdk packages, as these are not supported.

Use Oracle java, available here: http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html

6.  Install VMware VIX

Install VMWare VIX
sudo sh VMware-VIX-x.x.x-nnnnnn.mmmm.bundle

Note: You must use VIX 1.12.1

7.  Install the intigua RPM's

Copy the RPMs to the machine. install them in this order

  1. intigua-server-base
  2. intigua-server
  3. intigua-connector-installer, intigua-web, intigua-va

These should automatically start the tomcat and nginx services.

8.  Set Core Server URL in Intigua Console

Log into the Intigua Console and go to Settings > Advanced Settings. Configure the Core server URL: The URL used by endpoint connectors to communicate with the Intigua server. Must be a hostname (not IP address) that is resolvable and reachable from endpoints.

 

Comments