Ansible based installation

Install the Operating system

System

1. Root User Access is required during the installation.

2. SELinux will be disabled during the Ansible deployment and this will also require to reboot the Operating System.

User

Nodeum will define one user which needs ID : 1000. This ID is created automatically when the package is deployed. If a user already use these ID, you have to change their id :

$ usermod -u 1001 "username"
admin:x:1000:1000::/dev/null:/bin/false

It is the same for group, where group ID 1000 and group ID 1001 needs to be available. If group already use these ID, you have to change their id :

$ groupmod -g 1002 "groupname"
admin:x:1000:

Install & Update

To proceed with a Nodeum installation or an update, the following instructions must be performed.

An unlimited internet connection is necessary.

$ yum install wget
$ wget get.nodeum.io/public/nodeum-v1-9xx.tar.gz 
$ tar -xvzf /root/nodeum-xxx.tar.gz
$ cd v1-9xx-xx
$ ansible-playbook check_install.yml
$ ansible-playbook install.yml

Once the ansible-playbook is fully installed, and it ends up with this screen.

It is important to notice that there is no failed result

Then Nodeum is now ready to use, you can access it through your browser at this URL: http://your nodeum ip address/or via the DNS name.

If you can't access the Console through the default http port, you may have a local firewall is running. We recommend to either configuring it properly to allow access to the server through the http/https protocol.

Advanced Settings

Proxy requirement

If your network configuration requires a Proxy server to reach the internet, you need to configure the Proxy servers as follows:

$ vi /etc/environment
export http_proxy=http://xxxxx:[email protected]:8080
export https_proxy=http://xxxxx:[email protected]:8080
export ftp_proxy=http://xxxxx:[email protected]:8080
no_proxy=http://xxxxx:[email protected]:8080

If the password have special characters as !,@, you need to use unicode characters in hexadecimal.

For example, if your password is :

F@o:o!B#ar$, the following export will not work

export http_proxy="http://user:F@o:o!B#[email protected]:8080"

Convert special characters to hexadecimal format, such as

In this example :

@ becomes %40, 
: becomes %3A, 
and so on. 

(For example,https://www.online-toolz.com/tools/text-hex-convertor.php)

In our case, the password: F@o:o!B#ar$ is transformed to F%40o%3Ao%21B%23ar%24

The http_proxy export is formatted as follows:

export http_proxy="http://user:F%40o%3Ao%21B%23ar%[email protected]:8080"

Network Interface

Service mapping

Each service can be bound to a specific network interface.

After updating the inventory files to match your desired mapping, simply reapply the Ansible

Within the extracted Nodeum installation package, you will find a file /inventory/hosts_vars/srv1.

This file contains various configurations and settings to be applied to host.

A section exists for defining the service

By default, the iface_name parameter uses the main network interface but it can be overwritten.

# If there is no default network interface defined or you want to override it
# iface_name: eth0

Afterward, in the same file, you can find different parameters to bind a list of services to a specific interface name.

# Specific name of interface for each services. Default to iface_name 
# or default network interface) if undefined
# smb_iface_name: eth0
# nfs_iface_name: eth0
# rails_iface_name: eth0
# zookeeper_iface_name: eth0
# solr_iface_name: eth0
# catalog_indexer_iface_name: eth0

Description of each parameter :

Parameter	Service Name
smb_iface_name	SAMBA
nfs_iface_name	NFS
rails_iface_name	RAILS
solr_iface_name	SOLR
catalog_iface_name	CATALOG INDEXER