How to Deploy Nodeum - Mode Single Node ?

Mode Single Node - Install Nodeum software on-premise in using the Ansible deployment tools

Step by Step guide

Requirements
Installation
Post-installation checks

Requirements

Choose the platform where you want to deploy on
- Virtual Machine
- Physical Server
See following link: Server Specification for more details
Internet Connection for downloading the packages
OS : CentOS 7.9 - 8.x
RHEL 7.9 - 8.x
Rocky 8.x

Install the Operating system

System

Root User Access is required.
SELinux is disabled (this will be managed at deployment and will require a reboot).
The system must be up to date.

If you are running CentOS or RHEL, keep your system up-to-date as follows:

# RHEL or CentOS


[root@NODEUM ~]# sudo yum update -y
[root@NODEUM ~]# sudo reboot

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 :


[root@NODEUM~]# 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 :


[root@NODEUM~]# groupmod -g 1002 "groupname"
admin:x:1000:

Setup

The installation will be done by Ansible (this is managed at deployment).

Installation & Update - v1.x

Installation of prerequisite packages :

[root@NODEUM ~]# yum install python3-pip
[root@NODEUM ~]# pip3 install --upgrade pip
[root@NODEUM ~]# pip3 install ansible
[root@NODEUM ~]# pip3 install jinja2 --upgrade
[root@NODEUM ~]# pip3 install netaddr --upgrade

Note: if ansible is preinstall, we recommand to remove it to have the good version (min 2.10.3)

To deploy the Nodeum Package, follow these instructions WITH INTERNET CONNECTION :

[root@NODEUM ~]# yum install wget
[root@NODEUM ~]# wget get.nodeum.io/public/nodeum-v1-9xx.tar.gz 
[root@NODEUM ~]# tar -xvzf /root/nodeum-xxx.tar.gz
[root@NODEUM]# cd v1-9xx-xx
[root@NODEUM v1-9xx]# ansible-playbook check_install.yml
[root@NODEUM v1-9xx]# ansible-playbook install.yml

Nodeum is now ready to use. Access it through your browser at this URL: http://your nodeum ip address/ or via your favorite DNS name.

Post-installation checks

Run  #nodeumctl ps on the server to validate that all processes and up and running.

[root@nodeum]# nodeumctl ps
USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
root     37468  0.0  0.0 691328  7520 ?        Ssl  08:13   0:00 ./core_superv
root     37489  6.6  1.0 5488832 332072 ?      Ssl  08:13  18:06 ./core_manager
root     37683  0.1  0.0 911272  8532 ?        Ssl  08:13   0:17 ./core_fuse -- /mnt/FUSE -odefault_permissions -ohard_remove -oallow_other -obig_writes -
root     37637  0.0  0.0 298508  2684 ?        Ssl  08:13   0:02 ./data_mining
root     37589  0.2  0.0 847212 24640 ?        Ssl  08:13   0:37 ./library_manager
root     37692  0.0  0.0 604040  3648 ?        Ssl  08:13   0:11 ./core_watchdog
nodeum_+ 10341 14.3  0.7 1566132 248116 ?      Ssl  Jan26 5602:01 /opt/nodeum/bin/catalog_indexer/catalog_indexer -l 0.0.0.0:8083 -s http://10.3.1.187:898
root      1256  0.4  0.8 2603884 274604 ?      Ssl  Jan02 328:48 /opt/nodeum/bin/mount_point_scanning/mount_point_scanning -l 0.0.0.0:8082 -n nodeum-quali
root      1253  0.0  0.2 1501292 77228 ?       Ssl  Jan02   3:33 /opt/nodeum/bin/refparser/nodeum_ws_xml -l 0.0.0.0:8084 -mysql-host 10.3.1.187:3306 -mysq
root      9604  0.0  0.2 2250004 87820 ?       Ssl  Jan26   5:22 /opt/nodeum/bin/scheduler/nodeum_scheduler -l 0.0.0.0:8081 -n nodeum-qualif.mt-c.local:80
root      2034  0.0  0.0  75564  1928 ?        Ss   08:21   0:00 nginx: master process /opt/nginx/sbin/nginx
nobody    2046  0.0  0.0  75864  3172 ?        S    08:21   0:02  \_ nginx: worker process
[root@nodeum]#

Video Guide of a full deployment

Advanced Settings

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

Configuration Proxy Settings

[NODEUM:root]# vi /etc/environment
export http_proxy=http://xxxxx:xxxx
export https_proxy=http://xxxxx:xxxx
export ftp_proxy=http://xxxxx:xxxx
no_proxy=http://xxxxx:xxxx

💡Set/Export: http_proxy With Special Characters In Password

If the proxy server password has special characters such as !,@, you need to use unicode characters in hexadecimal.

For example, if your password is : F@o:o!B#ar$, the export http_proxy="http://user:F@o:o!B#ar$@server1.cyberciti.biz:3128/" will not work.

You need to convert the special characters in hexadecimals. In this example @ becomes %40, : becomes %3A, and so on. (You can use for example: https://www.online-toolz.com/tools/text-hex-convertor.php)

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

Thus the export http_proxy looks like this:

export http_proxy="http://user:F%40o%3Ao%21B%23ar%24@server1.cyberciti.biz:3128/"

Related Categories

Installation

Subscribe to Email Updates