30: Install target agent

1. On the navigation bar, click Target.

2. Click the (+) sign in the bottom of the agents list
   
   

   Open

   

    

3. Choose Remote deploy (to deploy the agent automatically) or Register agent (to deploy the agent manually)

Remote deploy

1. This is the default and the recommended option for Linux. Other OS are not supported in this option - use the Register agent manual approach.

Open

2. Fill all the fields:

   1. Name - name of the agent

   2. Description - an optional description

   3. Host - the IP or hostname of the source server

   4. Agent port - pick a port that is available on the server. The default is 8443.

   5. SSH Username - Make sure that the SSH user is either root or has sudo privilege

   6. Choose authentication - SSH password or SSH key

   7. Enter the SSH password of SSH key

   8. Optionally change advanced parameters:

      Open

      

      1. Mount options - used for NFS mount when building Golden Image. If not specified, the default is:
         -t nfs -o rw,bg,hard,nointr,rsize=32768,wsize=32768,tcp,vers=3,timeo=600,nolock

      2. Protocol - the protocol that is used by the agent. Choose between HTTPS (default) or HTTP.

      3. Force creation - If not chosen - then any error will stop the deployment process. If chosen - then ignore all errors during the deployment process.

3. Click “Add” in the end - the agent will be start deploying.

4. The process will automatically connect to the target server, perform verifications, deploy the agent and register it in the application.

   Open

   

    

Register agent

1. This is the less recommended option. Use it as plan B , when the automatic deploy did not work

2. Choose OS - either Linux, Windows or AIX
   
   

   Open

   

    

3. Click “download Target agent” to get the agent’s installation kit. Wait about 2 minutes until the file appears in the downloads box.

4. For Linux or AIX:

   1. Login as root to the target server

   2. Choose an app directory for the agent, e.g. /apps/accelario/target_agent

   3. Unzip the agent installation kit into the app directory

   4. Change into the app directory and execute
      chmod +x Accelario_linux_target_agent_installation.sh
./Accelario_linux_target_agent_installation.sh

   5. By default the port is 8443. If you want to use another port - specify it as the first parameter:
      ./Accelario_linux_target_agent_installation.sh 8555

5. For Windows:

   1. Login as administrator to the target server

   2. Choose an app directory for the agent, e.g. C:\Acc\target_agent

   3. Unzip the agent installation kit into the app directory

   4. By default the port is 8443. If you want to use another port - edit file service_parameters.list

   5. Change into the app directory and execute command:
      service_install.cmd my_user_name my_password target acc_target_agent .\jre1.8

      1. my_user_name - the OS user that will be used for the service. If using domain user then use in format of domain\username, if using local user then use the format .\username

      2. my_password - the password of the above user. If your password consists of special characters, then add an escape (^) character before each of them and put the whole password into double quotes. Additional information can be found in this link: Quotes, Escape Characters, Delimiters - Windows CMD - SS64.com

      3. target - type of the agent, here always target

      4. acc_target_agent - optional parameter of short service name, default acc_target_agent

      5. .\jre1.8 - optional parameter of JRE, default .\jre1.8, make sure it exists

   6. Go to Services, locate the newly created service with name “Accelario Virtualization target agent acc_target_agent", start it

6. Go back to the application’s dialog box and fill all the fields:

   1. Agent port - pick a port that was selected during the installation, by default 8443

7. Click “Add” in the end - the agent will be registered