Virbox Protector License （Network License)

1. Introduction

For Developer worked use Virbox Protector in same site, team or same company, They can purchase Virbox Protector Network License and install the Virbox Protector in multiple machines , then select one of machine to be the License server to provide Network license in remote to other machine, and the rest of developer can access the Network license, verification and use the network license to protect their project in remote site.

The License container for Network license supported includes hardware dongle and soft license, after setting completed in remote machine, then the network license can be used to protect the software project in remote machine accordingly.

In this chapter, we will introduce how to

1. Set up the environment and use license in remote machine;

2. How to configure in the network license server & Client machine;

2. Use network License from client machine (Virbox Protector GUI tool)

Process in Client machine

2.1 Open your Virbox Protector GUI tool, Click License Information, Select the Network License, click to add the network license, input the IP address of the machine to be the Network license.

see attached screenshot:

Follow up steps shown in the steps in below to add server machine address

2.2 When the license dongle (Virbox Elite 5) or Network license contained in the License Server (machine), it will list all of license contained in the server machine.

2,3 You can start to protect application when the correspondence Virbox Protector license in the license list on the License Server.

Note:
1）One license session will be used when the machine set to be the Network license server and client both.
2）If the No. of the client machine which use the Virbox Protector license is out of the maximum Number of license setting, it will popup a message "up to maximum concurrent number of set " when you execute the Virbox protector to protect applications.

3. Network License setting in license server/client

3.1 Server/Client setting in Windows environment

3.1.1 Server setting

1. Install the Virbox Protector in your server machine.

2. Search Virbox User License tool : ssclient.exe

The on default installation directory would be:

C:\Program Files (x86)\senseshield\ss\Tools>ssclient.exe

Open it. the GUI is attached as shown in below

1. Select the service mode: Client/Server mode

Click Service->Service mode->Client/Server Mode (Network Concurrent license),

Click Save & Restart

Note

1）If the Server IP address is located at same network section, it will be identified automatically and add it into the server list;

2）If the server IP address doesn't located at the same IP network section, and available by ping , you can add server by manually: Click Add button in the Client machine to add the server.

3.1.2 Client Setting

1. Add Server in your client machine (applicable to add the server which IP address located at different IP network section, prerequisite is the server is reachable by use of command ping)

Follow the action step by step as the screenshot shown in below:

Tips:

1）Above setting applied for adding the Server machine in different network section from client machine, The premise is that the server and client can ping each other;

2）For Server machine and client machine are located in the same network section, you can skip and ignore above steps.

1. Find the Server by using Virbox Protector GUI tool, You can follow the steps to add the server IP address when you open and execute the Virbox Protector GUI tool;

3.2 Server setting (Windows) and Client setting (Linux/mac)

3.2.1 Server setting

Click [Windows Server setting](3.1.1 Server setting) and view the setting

3.2.2 Client setting

1. For the Linux/mac client, Use following command to add the server in the client machine.

sscfg -a -n xx -i 192.168.1.23 -p 10334
Note: usually, the xx follow with -n is the server name, which can be named freely.

add server

1. it will prompt to restart service message when successful to set the Client/Server mode, Use the command in below to restart the service.

1）Restart service in Linux system:

sudo systemctl status senseshield

2）Restart service in mac system:

sudo launchctl stop com.sense.scp
sudo launchctl start com.sense.scp

Note:

1）Above setting applied for adding the Server machine in different network section in Linux/mac client machine, The prerequisite is that the server and client can ping each other;

2）For Server machine and client machine are located in the same network section, you can skip and ignore above steps.

1. [Add the server ip address in the Virbox Protector GUI too](2. Use network License from client machine (Virbox Protector GUI tool))l, you can follow the steps to add the server IP address when you open and execute the Virbox Protector GUI tool;

3.3 Server setting (Linux/mac) and Client setting (Windows)

3.3.1 Server Setting

1. Install Virbox Protector in the server machine (Use correspondence installation package)

2. View and check if the system has been set to be: Client/Server mode, if not, you need to change to Client/Server mode, you may refer following command to view and check the service mode of the system:

sscfg -s

Client

1. Set the system's service mode to: Client/Server mode, you may refer following command to set the service mode:

sscfg -e cs

1. When successful setting the system's service mode, the system will prompt to restart service, you may refer following command to restart system:

Restart service in Linux System

sudo systemctl status senseshield

Restart service in mac System

sudo launchctl stop com.sense.scp
sudo launchctl start com.sense.scp

1. View and check current system service mode setting:

sscfg -s

server

Tips:

1）The command to check and view the system service mode to Linux system and mac system is same, only the command to restart service is different.

2）If the IP address of server and client is locate same network section, the system will automatically identified the address and add it into server list.

3）If Server machine and client are located in different network section from, and be reachable by use the command to ping each other. you can add the server IP address manually in the client machine.

3.3.2 Client Setting

1. View the client setting in the [window system](3.1.2 Client Setting)

2. [Add the server IP address in Virbox Protector GUI tools](2. Use network License from client machine (Virbox Protector GUI tool))

3.4 Server setting (Linux/mac) and Client setting(Linux/mac)

3.4.1 Server setting

1. View and check the [server setting](#3.3.1 Server Setting) in the Linux/macOS system

3.4.2 Client Setting

1. View the [client system setting](3.2.2 Client setting) in Linux/macOS:

2. [Add the server IP address in Virbox Protector GUI tools](2. Use network License from client machine (Virbox Protector GUI tool))

4. Command line operation & process

Command line

1. Install Virbox Protector, entry the installation directory, and find virboxprotector_con.exe under the subdirectory \bin；

2. Use the command:

virboxprotector_con.exe --help=global

​ to view network license status

Comand line

1. Command Option

Command Option	Description
--set-servers=<ip_or_hostname>	Add the server's IP address
--list-servers	List the IP address of Server
--delete-servers	Delete the IP address of Server
--username=<user_name>	The License account
--password=<user_name>	The password of license account

The command to execute Virbox Protector to protect application:

After adding the server IP address, if the server has been issued the Network license or hardware dongle plugin, then the client can use the license in server to protect the application in client end:

1. The command to add designated server:

virboxprotector_con.exe -global --set-servers=192.168.71.219

1. The command to add multiple servers (sample command add 2 servers in 2 IP address:

virboxprotector_con.exe -global --set-servers="192.168.71.219;192.168.71.220"

1. The command to Delete the designate server

virboxprotector_con.exe -global --delete-servers=192.168.71.219

1. The command to Delete the multiple server added:

virboxprotector_con.exe -global --delete-servers="192.168.71.219;192.168.71.220"

1. Use command line to login the licensed account:

virboxprotector_con.exe -global --username=[e-mail] --password=123456

Note: when successful login your license account, 
The interface of Virbox Protector will not show the message to license logined successful, The Virbox User license tool on client end will be accept the license login successful on default, and it will verify the license when you use Virbox Protector CLI tool to protect the application.