Installing License Agent 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: If a MongoDB replica set has been deployed, you must install the License Agent Server on both primary and secondary nodes.

3.Obtain the netbrain-license-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-license-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 NetBrain License download link> command under the /opt/netbraintemp directory to directly download the netbrain-license-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-license-linux-x86_64-rhel7-7.1a2.tar.gz command under the /opt/netbraintemp directory to extract installation files.

[root@localhost netbraintemp]# tar -zxvf netbrain-license-linux-x86_64-rhel7-7.1a2.tar.gz
License/
License/bin_7.1a1/
License/bin_7.1a1/libboost_chrono.so
License/bin_7.1a1/libboost_chrono.so.1.62.0
License/bin_7.1a1/libboost_date_time.so
License/bin_7.1a1/libboost_date_time.so.1.62.0
License/bin_7.1a1/libboost_regex.so
License/bin_7.1a1/libboost_regex.so.1.62.0
License/bin_7.1a1/libboost_system.so
License/bin_7.1a1/libboost_system.so.1.62.0
License/bin_7.1a1/libboost_thread.so
License/bin_7.1a1/libboost_thread.so.1.62.0
License/bin_7.1a1/libcrypto.so
License/bin_7.1a1/libcrypto.so.1.0.0
License/bin_7.1a1/libssl.so
License/bin_7.1a1/libssl.so.1.0.0
License/bin_7.1a1/licensed
License/fix_releaseinfo.json
License/install.sh
License/install_licenseagent.conf
License/netbrainlicense-7-1.noarch.rpm
License/upgrade.sh

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

7.Modify the parameters in the install_licenseagent.conf file located under the License directory according to your environment and save the changes. For how to modify the configuration file, see Appendix: Editing a File with VI Editor for more details.

[agent]
# The IP address of the License Agent Server.
bindIp=0.0.0.0
# The port number that the License Agent Server listens to. It should be more than 1024 and less than 65535. By default, it is 27654.
port=27654
# Specify whether to use SSL to encrypt the connections to the License Agent Server.
# By default, it is disabled. 0 indicates disabled, 1 indicates enabled.
UseSSL=0
# If SSl is enabled, you must enter the full path of the server certificate and key file.
Certificate=/etc/ssl/license_agent.crt
PrivateKey=/etc/ssl/license_agent.key
# Binary file location
#binRootPath=/usr
[log]
#Log path, file name is licensed.log
path=/var/log/netbrainlicense
#Log level, options: trace/TRACE, info/INFO, debug/DEBUG, warning/WARNING, error/ERROR, fatal/FATAL
level=INFO
#Log file size limit in bytes before rolling out, 100 or maxLogFileSize whichever is greater.
#After reach size limit, file will be rotated, backup file name would be with timestamp (in UTC) as suffix.
# licensed.log.<year>-<month>-<mday>T<hour>-<min>-<sec>, e.g. licensed.log.2018-01-17T19-49-43
maxLogFileSize=2000000

8.Run the ./install.sh script under the License directory to install the License Agent Server.

[root@localhost License]# ./install.sh
Preparing...                          ################################# [100%]
Bind IP: 0.0.0.0
License Agent port: 27654
The NetBrain License Agent will not use SSL to communicate.
Updating / installing...
   1:netbrainlicense-7-1              ################################# [100%]
Bind IP: 0.0.0.0
License Agent port: 27654
The NetBrain License Agent will not use SSL to communicate.
Service name: netbrainlicense
User name: netbrain
User group: netbrain
NetBrain License Agent Server has been started.
NetBrain License Agent uses port 27654.
Redirecting to /bin/systemctl status firewalld.service
Successfully install NetBrain License Agent.
Finished to execute install.sh

9.Run the service netbrainlicense status command to verify whether its service starts successfully.

[root@localhost License]# service netbrainlicense status
netbrainlicense.service - SYSV: This shell script takes care of starting and stopping NetBrain license agent service.
   Loaded: loaded (/etc/rc.d/init.d/netbrainlicense)
   Active: active (running) since Tue 2018-11-27 01:38:01 EST; 57s ago
     Docs: man:systemd-sysv-generator(8)
  Process: 19452 ExecStop=/etc/rc.d/init.d/netbrainlicense stop (code=exited, status=0/SUCCESS)
  Process: 19459 ExecStart=/etc/rc.d/init.d/netbrainlicense start (code=exited, status=0/SUCCESS)
   Memory: 3.0M
   CGroup: /system.slice/netbrainlicense.service
           19463 /usr/bin/netbrainlicense/licensed -f /usr/licensed/licensed.conf
...

License Agent Parameters

Refer to the following table for the parameters of License Agent.

Parameter

Default Value

Description

bindIp

0.0.0.0

Enter the IP address of the network card you want to use for the License Agent Server.

Note: Modify the value only if you have multiple network cards on this machine.

port

27654

The port number that the License Agent Server listens to.

UseSSL

0

Set whether to encrypt the connections to the License Agent Server with SSL.

To enable SSL, replace 0 with 1.

For detailed requirements of SSL certificates and keys, see Appendix.

Certificate

/etc/ssl/license_agent.crt

The storage path and name of the SSL certificate that contains the public key.

Note: It is required only if UseSSL is enabled.

Note: Don't set the values of the Certificate, PrivateKey, and path arguments to any personal directories, such as /root. Besides, don't include any special characters or spaces except slashes (/) in the values.

PrivateKey

/etc/ssl/license_agent.key

The storage path and name of the SSL private key file.

Note: It is required only if UseSSL is enabled.

path

/var/log/netbrainlicense

The storage path for all License Agent Server log files.

Level

INFO

The level of License Agent Server logs.

Other available options: trace/TRACE, debug/DEBUG, warning/WARNING, error/ERROR, and fatal/FATAL.

maxLogFileSize

2000000

The maximum size of the log file in bytes.