Introduction
The infinit.e-platform.prerequisites.online and .offline RPMS contains a collection of packages, data files, and scripts that are necessary to prepare a clean CentOS 5.6/6+ or Red Hat Enterprise Linux 5.5/6+ server for the installation of IKANOW's Infinit.e.
There are two types of installation mode supported by infinit.e-platform.prerequisites:
- Online
infinit.e-platform.prerequisites.online - The Online installation is for target machines that have an active connection to the internet that allows YUM to retrieve the latest version of packages required for the installation. - Offline
infinit.e-platform.prerequisites.offline - The Offline installation is for target machines that are not connected to the internet. When the installation script (install.sh) is run YUM is pointed to the /mnt/opt/infinite-install/rpms directory where the required RPMs and their dependencies are located.
Infinit.e's architecture consists of two different types of server nodes:
- Infinit.e API Server Node
- Infinit.e DB Server Node
The installation mode and node type can be specified during installation via the use of command line arguments (see Running install.sh below).
Note that the install bundles on the IKANOW downloads page contain a single script that will install all required RPMs, both in online and offline modes. These "quick install"s are described here.
1. Installation of the RPM
To install from the Ikanow repo, simply run:
yum install infinit.e-platform.prerequisites.online
For offline installs:
Once infinit.e-platform.prerequisites RPM has been copied to the target machine execute the following command (assuming that you are within the same directory in which the RPM is located):
yum localinstall infinit.e-platform.prerequisites.online-*.rpm --nogpgcheck OR yum --disablerepo=* localinstall infinit.e-platform.prerequisites.offline-*.rpm --nogpgcheck
depending on the type of install.
Note that in the offline case all existing yum repositories are removed so that yum does not try to go out over the Internet to fetch dependencies. Running the offline install script (below) will then create a single local repository ("infinite").
2. Running install.sh
The RPM will unpack all of the files required to complete the installation into the following directory:
/mnt/opt/infinite-install
infinit.e-platform.prerequisites copies the online_install.sh or offline_install.sh script from following directory on the target machine:
/mnt/opt/infinite-install/scripts
to :
/mnt/opt/infinit.e-install/install.sh
If you are not already in you root directory type the following command within terminal:
cd /mnt/opt/infinite-install/
API Node
By default install.sh will create an API Node with all the latest RPMs when you type the following command.
sh install.sh
Alternatively you could explicitly pass the install mode and node type arguments as shown below.
sh install.sh apinode_latest
From v0.3 (May 2014) onwards, the default version of elasticsearch used is 1.0. Prior to v0.3, the much older 0.19 was used, which is not compatible with 1.0.
In order to install Infinit.e with the older version (eg if joining a new node to an old cluster) use "sh install.sh old_apinode"
DB Node
To install a DB Node type:
sh install.sh dbnode
3. Configuring the Node via the infinite.configuration.properties.TEMPLATE File
When the install.sh script has completed running you should see the following message:
################################################################################ IMPORTANT: Copy /mnt/opt/infinite-install/config/infinite.configuration.properties.TEMPLATE to /mnt/opt/infinite-install/config/infinite.configuration.properties and edit the properties contained within the file to match your deployment environment. ################################################################################
Follow the instructions above before continuing with the next steps of the Infinit.e installation, e.g.:
> cp /mnt/opt/infinite-install/config/infinite.configuration.properties.TEMPLATE.STANDALONE /mnt/opt/infinite-install/config/infinite.configuration.properties or > cp /mnt/opt/infinite-install/config/infinite.configuration.properties.TEMPLATE.AWS /mnt/opt/infinite-install/config/infinite.configuration.properties > vi /mnt/opt/infinite-install/config/infinite.configuration.properties
Note: See Appendix B - infinite.configuration.properties.TEMPLATE (STANDALONE and AWS) for more information on editing the infinite.configuration.properties file. The github templates may be found here (AWS) and here (standalone).