Guide for converting a netLD installation into a redundant configuration.


This document will explain the steps required in order to convert a standalone Linux installation of Linux into a master/slave redundant installation on two Linux servers.


Overview

  1. Convert an existing netLD server to use postgresql database
  2. Configure standalone server as redundant master
  3. Install netLD slave system

1. Convert netLD server to use postresql database

NetLD uses a postgresql server as a database for redundant configurations. This postgresql database is included automatically as part of the netLD installation, so the user does not have to install this server themselves.

Note: For users of version 14.06, the latest full installer must be executed before performing this procedure. The online update mechanism in 14.06 didn't update all of the database tools so some of the steps might not function properly without having run the latest installer.

Take the following steps to convert the existing embeded derby database to progresql.
  1. Stop the netLD service using the following command  
    service netld stop


  2. Start the netld postgresql database service using the following command  
    service netld-pgsql start


  3. Convert the derby database to postgresql by running the following commands 
    cd /usr/share/netld
    ./dbutil -db=pgsql reset
    ./dbutil convert_derby_to_pgsql

     

  4. Start the netld server using the following command 
    service netld start

     

  5. Confirm that the database was properly migrated by logging in to the netLD user-interface.

2. Configure standalone server as master

Now that the netLD server is configured to use postgresql, we can enable it as a redundant master server.

  1. Stop the netld and netld-pgsql services by running the following commands 
    service netld stop
    service netld-pgsql stop

     

  2. Convert the server to a redundant master by running the following commands 
    cd /usr/share/netld
    ./radmin master <slave-ip-address>
    # (the <slave-ip-address> should be the IP address of the server that the redundant slave will be run on.)

     

  3. Restart the netld-pgsql and netld services by running the following commands 
    service netld-pgsql start
    service netld start

     

  4. Confirm that the system was logging into the netLD user-interface. You can also run the following command from the /usr/share/netld directory to check the current redundancy status: 
    ./radmin status

     


3. Install the netLD slave system

The final step is to install the netLD redundant slave.

  1. Run the netld installer for the slave on the desired server using the --slave installer switch 
    ./netld-2014.06.0-x86_64.bin --slave

     

  2. Enter the master server’s IP address when the installer asks for it
  3. The installer will then ask for the netld “admin” user’s password of the master server.
  4. The database will be copied from the master server to this new slave and the redundancy configuration will be automatically set up.
  5. You can check the current redundancy status by running the following command from the /usr/share/netld directory 
    ./radmin status