Installing Front Server on Linux

 

1.Prepare a Linux server. See System Requirements for more details.

2.Log in to the Linux server as the root user.

Note: Front Server has dependencies on several third-party packages. Before you install the Front Server, run the yum install glibc.x86_64 glibc.i686 libstdc++.x86_64 libstdc++.i686 libuuid.x86_64 libuuid.i686 pam.x86_64 pam.i686 -y command to install these third-party packages. Make sure the server has access to the Internet and the yum command has been installed.

Note: If you are using RHEL 7.0 or CentOS 7.0, the operating system will be upgraded to version 7.5 automatically after you run the above command to install the third-party packages.

3.Run the mkdir command to create a directory under the /opt directory to place the Front Server installation package. For example, netbraintemp.

4.Obtain the netbrain-frontserver-linux-x86_64-rhel7-7.1a2.tar.gz file from NetBrain, and then copy it to the /opt/netbraintemp directory.

Option 1: If the Linux server has no access to the Internet, upload the netbrain-frontserver-linux-x86_64-rhel7-7.1a2.tar.gz file to the /opt/netbraintemp directory by using a file transfer tool.  

Option 2: If the Linux server has access to the Internet and the yum command has been installed:

1)Run the yum -y install wget command to install the wget command if it has not been installed.

2)Run the cd /opt/netbraintemp command to navigate to the /opt/netbraintemp directory.

3)Run the wget <NetBrain IE 7.1a Front Server download link> command under the /opt/netbraintemp directory to directly download the netbrain-frontserver-linux-x86_64-rhel7-7.1a2.tar.gz file to this directory.

Tip: Contact NetBrain Support Team to get the download link address.

Note: The download link is case-sensitive.

5.Run the tar -zxvf netbrain-frontserver-linux-x86_64-rhel7-7.1a2.tar.gz command under the /opt/netbraintemp directory to extract installation files.

[root@localhost netbraintemp]# tar -zxvf netbrain-frontserver-linux-x86_64-rhel7-7.1a2.tar.gz
FrontServer/
FrontServer/fix_releaseinfo.json
FrontServer/frontserver.tar
FrontServer/install.sh
FrontServer/install_frontserver.conf
FrontServer/uninstall.sh

6.Run the cd FrontServer command to navigate to the FrontServer directory.

7.Modify the following arguments in the install_frontserver.conf file located under the FrontServer directory and save the changes. For how to modify the configuration file, see Appendix: Editing a File with VI Editor for more details.

#NetBrain frontserver config file
SystemUser                         netbrain 
SystemGroup                        netbrain 
InstallPath                        /opt/netbrain/frontserver

SystemUser — the system user created on the Linux server to run the Front Server service. Keep the default name as it is.

Note: The value of the SystemUser and SystemGroup arguments cannot contain any of the following special characters:
{ } [ ] : " , ' | < > @ & ^ % \ and spaces

Note: If you modified the default umask value, make sure this system user has the read and execute permissions to the directory (including its parent directory) where the Front Server is installed.

SystemGroup — the system group created on the Linux server to run the Front Server service. Keep the default name as it is.

InstallPath — the storage path for all binary and other installation files of the Front Server.

Note: Don't set the InstallPath argument under any personal directories, such as /root, or contain any special characters or spaces except slashes (/).

Note: If you modified the default umask value, you must run the chmod o+rx /opt/netbrain command to assign the read and execute permissions of the /opt/netbrain directory to the system user that you specify in SystemUser.

Note: Make sure the destination directory has more than 1GB free space to save all the files. You can run the df -h command to check which directory has been mounted to a large disk.

8.Run the ./install.sh script under the FrontServer directory to install the Front Server.

[root@localhost FrontServer]# ./install.sh
Linux localhost.localdomain 3.10.0-327.el7.x86_64 #1 SMP Thu Nov 19 22:10:57 UTC 2015 x86_64 x86_64 x86_64 GNU/Linux
Check the environment
Start installing the Front Server
It may take a few minutes to install the Front Server. Please wait.
Created symlink from /etc/systemd/system/multi-user.target.wants/NetBrainFrontServer.service to /usr/lib/systemd/system/NetBrainFrontServer.service.
Successfully installed the Front Server.

Note: The Front Server service will not be automatically started until it is successfully registered. You cannot register a Front Server immediately until adding the Front Server to a Tenant.

9.To install more Front Servers for load balancing, repeat the above installation steps on separate machines.