Subscribe to Email Updates

    Installation | 6 min read

    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


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

    Install the Operating 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


    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"

    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"


    • 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
    [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
    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 -s
    root 1256 0.4 0.8 2603884 274604 ? Ssl Jan02 328:48 /opt/nodeum/bin/mount_point_scanning/mount_point_scanning -l -n nodeum-quali
    root 1253 0.0 0.2 1501292 77228 ? Ssl Jan02 3:33 /opt/nodeum/bin/refparser/nodeum_ws_xml -l -mysql-host -mysq
    root 9604 0.0 0.2 2250004 87820 ? Ssl Jan26 5:22 /opt/nodeum/bin/scheduler/nodeum_scheduler -l -n
    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


    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


    💡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$" 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:

    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=""



    Related Categories


    You may also like:

    Installation Product Specification

    Linux-Based Solution

      Description  Core's Nodeum is built on a Linux-based platform, from this foundation, we added the different required p...


    Extend the Nodeum Cache

    Based on the server type, you have multiple the solution to increase the cache size.

    Installation Product Specification Architecture

    Server Specification

    Prerequisites The solution can be deployed on Physical server (x86 commodity servers) Virtual Server Global Recommendati...

    Let Us Know What You Thought about this Post.

    Put your Comment Below.

    Learn and grow with award-winning support and a thriving community behind you.

    Get the free version