Popular Search how tohow to useagenthowdatarestformulacustombatchstore
View Categories

Install on Windows PC or Laptop

Overview #

In this chapter we will see the procedure to create the installer for Windows operating systems. This installer can be delivered to the customer as a single file, which will install everything required to start the SKYVVA Integration Agent as a windows service.
[su_box title=”Note” box_color=”#2a8af0″ title_color=”#000000″]This setup is prepared and available on our Windows EC2 instance with the following details[/su_box]
Instance Name: agent-app-windows
Instance DNS Name: ec2-18-158-217-193.eu-central1.compute.amazonaws.com
Username: Administrator
Password: -erQPsqriMDG9Y.%n*B@mk%N-?4@suXF

Pre-requisites #

In order to create the installer we need to have the template location available in the following directory. This location will hold all the files which we will be packaged together to create the
installer.
C:\Skyvva-Installer\Skyvva Integration Agent – Installation Template

  1. In the above directory, we can see that Skyvva-Agent.jar file exists. Whenever we are delivering a new patch to customer, we need to replace this Jar file with the new one.
  2. A new jar file may have the version number in its name, so ensure that you remove it and the name
    must become Skyvva-Agent.jar only.
  • Ensure that another folder with the path as mentioned below exists.
    C:\Skyvva-Installer\Installer-Setup-Output


Ignore the existing files, for now.

  • NSIS must be installed already.
  • CreateAgentWindowsInstaller.nsi script is available at the following location.

C:\Skyvva-Installer

Procedure #

1. Open command prompt and go to the NSIS installation directory
cd C:\Program Files (x86)\NSIS\Bin

2. Execute the following command
makensis.exe C:\Skyvva-Installer\CreateAgentWindowsInstaller.nsi

3. You will see the following output

Post the execution of the above command, we can find out the newly created installer at the following location.
C:\Skyvva-Installer\Installer-Setup-Output

Pre-required

  • Create Salesforce connected app
  • Create Remote Site
  • Create Connection name on Agent Control Board

Step -1: Create Connected app on Salesforce          

  • Navigate to the search box and just type “app…” for finding the App Manager menu then click New Connected App to create a new connection on Salesforce

  • Fill required information

  • After that click button Save

  • Click continue

  • Here is the Client-Id (Consumer Key) and Client-Secret (Consumer Secret). But we cannot use those keys immediately as Salesforce has a display of a warning in the red line

Step -2: CreateRemote Site
 
We need to create a new Remote Site for allowed Salesforce access to your external system.
Put host URL and Agent port number
Example: http://18.158.217.193:9055

Step -3:Create new Connection name

  • Provide the credential to Connection Destination

Destination→New
Name→any name
Description→ (optional)
Type →any type, for example, Agent Database. If we work with Database, so Type is “Agent Database”. We need to create a connection type depends on the working target.

Then click on the Continue button

  • Second, provide the credential of Agent for ping connection from Salesforce to AGENT

Host URL→ http://18.158.217.193
Port Forward→ 9055 (default)
Username→skyvva (default)
Password→skyvva@12! (default)

Then click on the Ping Agent Connection button

  • Third, provide the credential of Salesforce for ping connection from AGENT to Salesforce

Username→ username of your org
Password→ password of your org
Security Token→optional, but if the org has been generated the Security Token we need to put it
Server Environment→Sandbox/Production
Consumer Key and Consumer Secret users get from the connected app from the Salesforce side


Then Click on the Ping Salesforce Connection button
After we ping successfully then we can save the connection name.

And then we can use any Tab on the Agent Control Board, like checking system information of the Agent server

[su_box title=”Note” box_color=”#2a8af0″ title_color=”#000000″]

1. Users have to open the firewall for their region, If the firewall does not open ping connection will not work.
2. Please follow the link to understand how it works.

Salesforce IP Addresses and Domains to Allow

[/su_box]