Activating the Linux Agent
 | New in Version 2.13 CDP Server supports Agent license pooling. Agent License Pools allow customers to create and delete their own CDP Server license out of their pool through the web portal at https://dist.r1soft.com. Agent and add-on entitlements can be returned to the pool using the CDP Server user interface. |
Before adding a Host to the System, you need to install the CDP Agent software on the Host. For more information, refer to the Windows Agent Getting Started Guide or Linux Agent Getting Started Guide.
Once you have the Agent installed, you will need to copy the CDP Server's Public Key to the Linux Agent. Follow the instructions below to accomplish that. For the Windows Agent, refer to Activating the Windows Agent.
Option 1 - Using the #r1key command line utility
You can use the #r1key command line utility to manage the Agent RSA Public Keys without having to copy and paste.
Run the r1key --add --server=IP command.
| Note The --add function downloads the Key from the Server. For this option to work, the Server should be up and the Agent should be able to access the Server via the network. |
Example:
To add a Server with IP address 192.168.0.222 to the list of Servers known to the
Agent, run the r1key --add --server=192.168.0.222 command.
More Examples:
Read more in the Linux Agent CLI Guide.
Option 2 - Using Copy-Paste method
The following instructions provide the steps for the copy-paste method.
1. Open the Web browser connecting to the Linux CDP Server Web Interface and
log in.
2. Click on "Options" in the Main Menu.
3. On the "Options" page, click on "Server Key."
4. The Server Key will be displayed in the following format:
Now you can download the file:
You can also copy the text by highlighting it with your mouse and pressing Ctrl+C.
| Note Copy the entire Server Key including the " -- Begin Public Key -- " and " -- End Public Key -- " strings. |
5. Place the text file containing the CDP Server's Public Key in the server.allow directory on the CDP Server installation.
5.1 Then open a SSH session to the Linux Host running the Agent. Obtain root permissions either by logging in as root or by running command su or sudo after login.
5.2 By default, the Public Key should be placed in the following file (SERVER_IP is the IP address of the CDP Server):
| Note After finishing the installation of the Agent, you are informed of the path where the Server Key(s) should be placed.  |
 | New in Agent Version 1.56 The file should be obligatory named as SERVER_IP if the IP Authentication Agent configuration parameter is equal to "yes." The default value is "no" meaning the Agent will only do RSA Key authentication and not check the source IP address of the connecting CDP Server. If IP Authentication is set to "yes," the Agent looks for a file in the server.allow directory matching the IP address of an incoming connection before doing RSA Key authentication. Read more in Linux Agent Configuration. |
5.3 Open the file in your favorite Linux text editor - vi, emacs, pico, or mcedit, enter or paste the Server Key, and save the file. The following image shows the file opened in mcedit - the editor which is built into the Midnight Commander file manager.
Example: If the CDP Server IP address is 192.168.0.215, then the file should be the following:
| Note If you do not know how to work with text editors in Linux SSH session, run the following command: cat > /etc/buagent/server.allow/SERVER_IP Paste the Server Key from the clipboard and press Ctrl-D.  |
| Note It is recommended to use PuTTY as a SSH client. PuTTY allows you to paste the text from the Windows clipboard by pressing the right mouse button. You can download PuTTY from here: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html |
After the Server Key is added, requests from the CDP Server should be accepted.
The next steps are described in Adding A Host.