Registering NetBrain Front Server

Select either of the following ways to register the Front Server, depending on the operating system of your machine:

Registering Front Server on Windows

Registering Front Server on Linux

Registering Front Server on Windows

Example: Register a Front Server on Windows Server 2012 R2.

Complete the following steps with administrative privileges.

1.On the machine where the Front Server is installed, click the Windows start menu and then click the icon to open the Apps pane.

2.Under the NetBrain category, right-click Registration and then select Run as administrator from the drop-down list.

3.In the Registration dialog, complete the registration form.
 

1)Enter the following information of Front Server Controller.

Hostname or IP address — the IP address or FQDN of the Front Server Controller and the port number (defaults to 9095).

Tip: If you set up a Front Server Controller group, enter the IP address and port number of the two members in two lines by pressing the Ctrl + Enter keys.

2)Configure the SSL settings.

a)Select the Use SSL check box to encrypt the connections to Front Server Controller with SSL. If SSL is disabled on Front Server Controller, leave it unchecked and skip step b) and c).

b)To authenticate the Certificate Authority (CA) of SSL certificates on Front Server, select the Conduct Certificate Authority verification check box.

c)If the CA has not been installed on this machine, click Browse to upload the CA file, for example, ca.pem; otherwise, select I have installed the Certificate Authority on this machine.

Note: Only the certificate in Base-64 encoded X.509 PEM format is supported.

3)Click Test to verify whether this Front Server can establish a connection to Front Server Controller with the configurations.

4)thefollowing information of the Front Server.

Tenant Name — the name of the tenant that this Front Server will serve.

Front Server ID — the ID created when you add this Front Server to a tenant.

Authentication Key — the authentication key created when you add this Front Server to a tenant.

4.Click Register. Then the Front Server will serve all domains in the current tenant.

Tip: After registering the Front Server successfully, you can open the Task Manager and navigate to the Services panel to check whether the NetBrainFrontServer service is running.

5.Click Close after the registration is finished. The Front Server information in the Front Server Controller Manager is synchronized.

 

Registering Front Server on Linux

1.On the machine where the Front Server is installed, run the cd <InstallPath>/conf command to navigate to the conf directory.

Note: The default install path of the Front Server is /opt/netbrain/frontserver. If you modified it in the install_frontserver.conf file during the installation, you must replace the <InstallPath> accordingly.

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

[root@localhost conf]# vi register_frontserver.conf
# Enter <hostname or IP address>:<port> of the Front Server Controller. For example, 192.168.1.1:9095
# Use a semicolon to separate multiple Front Server Controllers.
Front Server Controller =10.10.3.141:9095
 
# Define the SSL settings
Enable SSL = No
Conduct SSL Certificate Authority = No
SSL Certificate Path =
 
# Define the Front Server register to
Tenant Name =Initial Tenant
Front Server ID =FS1
Authentication Key =netbrain

3.Run the cd <InstallPath>/bin command to navigate to the bin directory.

Note: The default install path of the Front Server is /opt/netbrain/frontserver. If you modified it in the install_frontserver.conf file during the installation, you must replace the <InstallPath> accordingly.

4.Run the ./registration command under the bin directory to register the Front Server.

[root@localhost bin]# ./registration
Loading configuration files...
Stopping Front Server Service...
Registering Front Server...
Successfully registered to the tenant "Initial Tenant".
10.10.3.141: active.
Succeeded to start up front server service.

5.Run the service NetBrainFrontServer status command to verify whether the service of the Front Server starts successfully. For how to operate its service, see Service Management for more details.

[root@localhost FrontServer]# service NetBrainFrontServer status
Redirecting to /bin/systemctl status  NetBrainFrontServer.service
NetBrainFrontServer.service - NetBrain Front Server Daemon
Loaded: loaded (/usr/lib/systemd/system/NetBrainFrontServer.service)
Active: active (running)

Parameters

Parameter

Default Value

Description

Front Server Controller

 

The hostname, IP address, or FQDN of the Front Server Controller and the port number.

Note: If you deploy two Front Server Controllers for failover, enter the IP address and port number of the two members, separated by a semicolon. For example, 10.10.3.141:9095;10.10.3.143:9095

Enable SSL

No

Set whether to encrypt the connections to Front Server Controller with SSL.

If SSL is enabled on the Front Server Controller, type Yes; otherwise, leave the default value as it is.

Conduct Certificate Authority Verification

No

Set whether to authenticate the Certificate Authority (CA) of SSL certificates on the Front Server.

If you want to authenticate the Certificate Authority, type Yes.

SSL Certificate Path

 

The storage path and certificate name.

Note: Only the certificate in the Base-64 encoded X.509 PEM format is supported.

Tenant Name

Initial Tenant

The name of the tenant that this Front Server will serve.

Front Server ID

FS1

The ID created when you add this Front Server to a tenant.

Authentication Key

 

The authentication key created when you add this Front Server to a tenant.

 

See also:

Adding a Front Server to a Tenant

Logging into Tenant Management Page