Virbox Protector License (CLI)

1. Introduction

For Developer use Virbox Protector CLI tool to protect their software project in project build in process, they can use cloud license (Trial period), soft license or use Hardware dongle (Virbox Elite 5) to be the license container, to login license, bind the license or license key or unbind the license or license key before they use Virbox Protector to protect the software project. In this section, we introduce how to login license, bind license and log out, unbind license when developer use Virbox Protector CLI tools.

​2. Virbox Command line tools (CLI tool)

When you install Virbox Protector in your machine, You can find Virbox Protector CLI tool : virboxprotector_con.exe in below folder/path (on default directory)

Windows:
Commercial release：
C:\Program Files\senseshield\Virbox Protector 3\bin\virboxprotector_con.exe
Trial release：
C:\Program Files\senseshield\Virbox Protector 3 Trial\bin\virboxprotector_con.exe

Linux:
Commercial release：
/usr/share/virboxprotector/bin/virboxprotector_con
Trial release：
/usr/share/virboxprotector-trial/bin/virboxprotector_con

macOS:
Commercial release：
/Applications/Virbox Protector 3.app/Contents/MacOS/bin/virboxprotector_con
Trial release：
/Applications/Virbox Protector 3 trial.app/Contents/MacOS/bin/virboxprotector_con

Note：

1）Add the path ofvirboxprotector_con into the system environment variable，you can use the Virbox Protector CLI in the command console directly；

2）If Virbox Protector not add in to the environment variable, you need to specify the absolute path of Virbox Protector CLI tool virboxprotector_con, or entry the folder which Virbox Protector virboxprotector_con located to execute and protect the project.

3. Soft license

Virbox Protector supports 2 kinds of soft license to developer to login/bind with machine:

• Account based soft license

• License key

3.1 Use the account based soft license to bind with windows machine

1. Use following command to view help information:

virboxprotector_con.exe --help

Use CLI to view Help info

1. Execute following Command to select the type of license：

virboxprotector_con.exe -bind

1）Bind with account

2) Bind with license key

When you use the soft license (email account based license), select 1) to bind the soft license with your machine;

When you received a series digital code to activate the Virbox Protector, select 2) to bind the license key with your machine

Here, we select 1)

Note:

Virbox Protector support 2 kinds of Soft license to bind with your machine: Account based soft license and license key, Both soft license and license key supports to use in Online environment and use the license key to bind the machine in offline environment.

1. Input your email account and relevant password

1. Input email account and password, then it will show and list all of soft license in your account, select and input the number to bind with correspondence soft license, as shown in the sample below (in the sample, we select 7 to bind with correspondence .Net License with machine )

1. When bind the license with your machine successfully, then you can use the license at present machine, till the license expired or you want to unbind the license. otherwise, it is not necessary to bind license again.

3.2 Use License key to bind license with windows machine

1. Use following command to bind the license with machine

virboxprotector_con.exe -bind

and select:

2) Bind with license key

1. Input the license key to bind the license with your machine

3.3 Bind license key in Linux environment

Online Environment

Activate the license key in online environment

1. Open terminal windows in Linux system, use following command:

ssclt --online_bind_license_key --license_key 26W7-4ZTP-38YP-JRX1

The script 26W7-4ZTP-38YP-JRX1 in above is the license key in sample, pls replace with your own license key respectively

1. use command to view if the license has been bind and activate:

    ssclt --slock 

   Offline Environment

When you bind the license key in offline machine, another online machine required. this online machine will be used to exchange the d2c file in Virbox User center. The online machine with windows system will be fine. (linux machine also will be fine;)

Pre requisition

in your offline machine, pls install Virbox User license tools first.

1. Open terminal windows to generate the file contained the offline machine hardware fingerprinting information (c2d file):

    ssclt --offline_bind_c2d --c2d ./

   then a file with c2d suffix will be generated under present folder accordingly.

   For example:

   ZHOUZH-EPC_192.168.0.54_bind_20210428.c2d

2. Copy this c2d file to another machine in online environment which access internet;

3. in this online machine, visit and access following url to exchange d2c file and input the license key

   https://user.lm.virbox.com/sn/login.html

   input the license key you received;

For detail process to exchange c2d file in Virbox user center, you may refer process:

Virbox Protector License: Offline Environment

Step 2:

Exchange and get d2c file from Virbox User license center

1. Use the c2d file generated to exchange d2c file (click input box then you can select the c2d file which saved in your online machine)

   note: d2c file is the file which used to activate Virbox Protector in offline machine.

2. click "exchange d2c file" to download the d2c file to your online machine;

   sample d2c file name is: ZHOUZH-EPC_192.168.0.54_bind_20210428.D2C

3. Copy the d2c file and save this file to your offline machine; and execute the command:

   to activate the Virbox Protector license in your offline machine

   View and check the license bind with your offline machine. use the command:

   For more CLI command in Linux system, you can view CLI user manual.

3.4 Unbound Soft license

1. Use following command to get and view help information:

virboxprotector_con.exe --help

1. Use following command to view all of soft license bound with your machine, input the correspondence Number to unbind correspondence soft license, input 0 to unbound all of soft license bind with your machine.

   in the sample below, we input 9 to unbind Virbox Protector Java BCE license from the machine

virboxprotector_con.exe -unbind

4. Cloud License

1. Use following command to view the help information

virboxprotector_con.exe --help=global

1. Execute following command to login the cloud license:

virboxprotector_con.exe -global --username=<> --password=<>

1. When you login account successful, then you can use Virbox Protector command line interface tool to protect your project

Note:

1. it is mandatory to execute the login license and protect the project in 2 sperate steps. you can not to combine 2 command in one steps;

2. When you login the license, and the soft license contained in your account can be bound with local machine.