Installing License Agents on Linux

 

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

2.Log in to the Linux server where MongoDB is installed as the root user.

3.Run the cd /opt/netbraintemp8.0.3 command to navigate to the /opt/netbraintemp8.0.3 directory.

4.Download the installation package.

Option 1: If the Linux server has no access to the Internet, obtain the netbrain-licenseagent-linux-x86_64-rhel7-8.0.3.tar.gz file from NetBrain and then upload it to the /opt/netbraintemp8.0.3 directory by using a file transfer tool.

Option 2: If the Linux server has access to the Internet, run the
wget <download link> command under the /opt/netbraintemp8.0.3 directory to directly download the file from NetBrain official download site.

Note: Contact NetBrain Support Team to get the download link. The download link is case-sensitive.

Tip: Run the yum -y install wget command to install the wget command if it has not been installed on the server.

5.Run the tar -zxvf netbrain-licenseagent-linux-x86_64-rhel7-8.0.3.tar.gz command under the /opt/netbraintemp8.0.3 directory to extract installation files.

[root@localhost netbraintemp8.0.3]# tar -zxvf netbrain-licenseagent-linux-x86_64-rhel7-8.0.3.tar.gz
License/
License/config/
License/config/install_licenseagent.conf
License/config/setup.conf
...
License/install.sh
...

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

7.Modify the parameters in the setup.conf file located under the config directory according to your environment and save the changes. For how to modify the configuration file, refer to Editing a File with VI Editor.

[root@localhost config]# vi setup.conf
# 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 1025 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. no indicates disabled; yes indicates enabled.
UseSSL=no
# If SSL is enabled, you must enter the full path of the server certificate and key file.
Certificate=/etc/ssl/cert.pem
PrivateKey=/etc/ssl/key.pem
# LogPath is used to store log files for the service of netbrainlicense.
# This directory must be at least a second level directory and used exclusively for this purpose.
LogPath=/var/log/netbrain/netbrainlicense

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

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

1)Read the license agreement, and then type YES and press the Enter key.

2)Type I ACCEPT and press the Enter key to accept the license agreement. The script starts to check whether the system configuration of the Linux server meets the requirement, and all required dependent packages are installed for each Linux component.

[root@localhost License]# ./install.sh
Please read the End User License Agreement (“EULA”) for the license type (perpetual or subscription) 
purchased in the order form at https://www.netbraintech.com/legal-tc/ carefully. I have read the 
subscription EULA, if I have purchased a subscription license, or the perpetual EULA, if I have 
purchased a perpetual license, at the link provided above. Please type “YES” if you have read the 
applicable EULA and understand its and understand its contents, or “NO” if you have not read the 
applicable EULA. [YES/NO]: YES
 
Do you accept the terms in the subscription EULA, if you have purchased a subscription license, or 
the perpetual EULA, if you have purchased a perpetual license? If you accept, and to continue with 
the installation, please type "I Accept" to continue. If you do not accept, and to quit the 
installation script, please type "CANCEL" to stop. [I ACCEPT/CANCEL]: I ACCEPT
INFO: Creating installation log file...
INFO: Dependent Package: 
INFO: Component Name: LicenseAgent
INFO: RPM name: netbrainlicense
...
INFO: Collecting system information SUCCEEDED.
INFO: Starting to check Linux OS info...
INFO: Starting to check rpm existence...
INFO: Starting to check systemd service...
INFO: System checking SUCCEEDED
INFO: Dependent packages checking SUCCEEDED
INFO: Configuration parameters checking SUCCEEDED
INFO: Installing /opt/netbraintemp/License/sources/netbrainlicense-8.0.3-el7.x86_64.rpm
Preparing...                          ########################################
Find configuration file /var/log/netbrain/installationlog/licenseagent/install_licenseagent.conf.
Bind IP: 0.0.0.0
License Agent port: 27654
The NetBrain License Agent will not use SSL to communicate.
Updating / installing...
   1:netbrainlicense-8.0.3-el7               ########################################
Bind IP: 0.0.0.0
License Agent port: 27654
The NetBrain License Agent will not use SSL to communicate.
User name: netbrain
User group: netbrain
NetBrain License Agent Server has been started.
Redirecting to /bin/systemctl status firewalld.service
Successfully installed NetBrain License Agent.
INFO: 2020-01-13 00-26-30.295: Rpm package installing SUCCEEDED.
INFO: 2020-01-13 00-26-30.304: Starting permission assigning...
INFO: 2020-01-13 00-26-30.359: Permission assigning SUCCEEDED.
Created symlink from /etc/systemd/system/multi-user.target.wants/netbrainlicense.service to /usr/lib/systemd/system/netbrainlicense.service.
?netbrainlicense.service - NetBrain license agent service
   Loaded: loaded (/usr/lib/systemd/system/netbrainlicense.service; enabled; vendor preset: disabled)
   Active: active (running) since Mon 2020-01-13 00:26:30 EST; 18ms ago
  Process: 15534 ExecStop=/usr/bin/pkill licensed (code=exited, status=0/SUCCESS)
  Process: 15540 ExecStart=/usr/bin/netbrainlicense/licensed -f /etc/netbrainlicense/licensed.conf (code=exited, status=0/SUCCESS)
  Process: 15536 ExecStartPre=/bin/chmod o+r /sys/class/dmi/id/product_uuid (code=exited, status=0/SUCCESS)
 Main PID: 15541 (licensed)
   Memory: 1.0M
   CGroup: /system.slice/netbrainlicense.service
           15541 /usr/bin/netbrainlicense/licensed -f /etc/netbrainlicense/licensed.conf
Jan 13 00:26:30 localhost.localdomain systemd[1]: Starting NetBrain license agent service...
Jan 13 00:26:30 localhost.localdomain systemd[1]: Started NetBrain license agent service.
INFO: 2020-01-13 00-26-30.968: Successfully installed License Agent. Service is running. 
INFO: 2020-01-13 00-26-31.041: Backing up uninstall.sh SUCCEEDED
INFO: 2020-01-13 00-26-31.069: Successfully installed License Agent.

10.Run the systemctl status netbrainlicense command to check the service status of License.

[root@localhost ~]# systemctl status netbrainlicense
 netbrainlicense.service - NetBrain license agent service
   Loaded: loaded (/usr/lib/systemd/system/netbrainlicense.service; enabled; vendor preset: disabled)
   Active: active (running) since Tue 2020-01-14 00:43:41 EST; 27min ago
  Process: 6054 ExecStart=/usr/bin/netbrainlicense/licensed -f /etc/netbrainlicense/licensed.conf (code=exited, status=0/SUCCESS)
  Process: 5907 ExecStartPre=/bin/chmod o+r /sys/class/dmi/id/product_uuid (code=exited, status=0/SUCCESS)
 Main PID: 6138 (licensed)
   Memory: 8.2M
   CGroup: /system.slice/netbrainlicense.service
           └─6138 /usr/bin/netbrainlicense/licensed -f /etc/netbrainlicense/licensed.conf
 
Jul 19 09:02:40 localhost.localdomain systemd[1]: Starting NetBrain license agent service...
Jul 19 09:02:40 localhost.localdomain systemd[1]: Started NetBrain license agent service.

Parameters

The following table describes the parameters that can be configured when installing License Agent.

Parameter

Default Value

Description

BindIp

0.0.0.0

Specify the IP address of License Agent.

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

no

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

To enable SSL, modify it to yes.

Certificate

/etc/ssl/cert.pem

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

Note: It is required only if UseSSL is enabled.

Note: Do not set the values of the Certificate, PrivateKey, and LogPath arguments to any personal directories, such as /root. Besides, do not include any special characters or spaces except slashes (/) in the values.

PrivateKey

/etc/ssl/key.pem

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

Note: It is required only if UseSSL is enabled.

LogPath

/var/log/netbrain/netbrainlicense

Specify the storage path for all License Agent log files.