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/netbraintemp10.0a command to navigate to the /opt/netbraintemp10.0a 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-rhel-10.0a.tar.gz file from NetBrain and then upload it to the /opt/netbraintemp10.0a 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/netbraintemp10.0a 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.

6.Run the tar -zxvf netbrain-licenseagent-linux-x86_64-rhel-10.0a.tar.gz command under the /opt/netbraintemp10.0a directory to extract installation files.

[[email protected] netbraintemp10.0a]# tar -zxvf netbrain-licenseagent-linux-x86_64-rhel-10.0a.tar.gz
License/
License/include/
License/include/yaml.sh
License/include/yq
...
License/install.sh
...

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

8. 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.

[[email protected] 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 32767. 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

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

10. 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.

[[email protected] 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: Starting to check Linux OS info...
INFO: Creating installation log file SUCCEEDED 
INFO: Dependent packages:
INFO: Component Name: License Agent
INFO: RPM name: netbrainlicense
INFO: Preprocessing SUCCEEDED.
...
INFO: Installing /opt/netbraintemp/License/sources/netbrainlicense-10.0a-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-10.0a-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: Port 27654 is added to the firewall.
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/netbrain/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/netbrain/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: 2021-02-24 01-30-48.747: Successfully installed License Agent. Service is running. 
INFO: 2021-02-24 01-30-48.775: Backing up uninstall.sh SUCCEEDED
INFO: 2021-02-24 01-30-48.785: Successfully installed License Agent.

Note: If the Service Monitor Agent was not previously installed, it will be installed with License Agent. You'll need to use the interactive command line to install it. See Installing MongoDB on Linux for more details. You can also install the Service Monitor Agent separately before installing License Agent.

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

[[email protected] ~]# 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 Wed 2021-02-24 01:30:48 EST; 8min ago
  Process: 6054 ExecStart=/usr/bin/netbrainlicense/licensed -f /etc/netbrain/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/netbrain/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.