2. How to install Agent 3.06 for Windows?

System Requirements #

Approach #

• User/Admin has bought a valid SSL certificate from the trusted vendors of Salesforce.
  –  Outbound Messaging SSL CA Certificates
• User/Admin has got the deployment package and transferred it to the deployment server.

Installation New Agent 3.06 with Mode ‘Opening-Firewall’ #

In the ‘Opening-Firewall’ installation mode, the user can only use the connection mode.

• Opening-Firewall

1. Once we have the Skyvva Integration Agent setup file available. We can execute it by double-clicking on it.

2. Hit Next, it will ask you to accept the License Agreement. Read the agreement and accept it. This is mandatory to proceed further with the installation.

3. Hit I Agree, it will take you to Choose the installation directory. By default, it will be
C:\Program Files\Skyvva Integration Agent
You can update it or leave it as is.

Then click Next.

4. It will take you to choose the Start Menu Folder name, by default it will be Skyvva Integration Agent.

Then click Next.

5. Input Agent Service Port, Agent Username and Agent Password.
Sample: Port: 9057, Username: skyvva, Password: skyvva@12!

6. Enter your database password, and you can rename the database schema following ‘skyvva_’ with the agent port.
*Note:Database Schema defulft name ‘skyvva’

Then click Next.

7. For the ‘Opening-Firewall’ mode, you don’t need to select an Authentication Type, as this option does not require.

Then click Next.

Then click Next.

Then click ‘Install’

Then click ‘OK’

Then click ‘OK’

Then click ‘OK’

8. The final step click ‘Finish’ your Agent service will start.

9. You can find the installer artifacts in the folder that was selected during the installation.

10. Here’s the schema name in the PostgresSQL.

 

 

Installation New Agent 3.06 with Mode ‘Non-Opening-Firewall’ #

In the ‘None-Opening-Firewall‘ installation mode, the user can use boths the connection mode.

• Opening-Firewall
• None-Opening-Firewall

1. Once we have the Skyvva Integration Agent setup file available. We can execute it by double-clicking on it.
2. Hit Next, it will ask you to accept the License Agreement. Read the agreement and accept it. This is mandatory to proceed further with the installation.

3. Hit I Agree, it will take you to Choose the installation directory. By default, it will be
C:\Program Files\Skyvva Integration Agent
You can update it or leave it as is.

Then click Next

4. It will take you to choose the Start Menu Folder name, by default it will be Skyvva Integration Agent.

Then click Next

5. Input Agent Service Port, Agent Username and Agent Password.
Sample: Port: 9058, Username: skyvva, Password: skyvva@12!

Then clcik Next.

6. Enter your database password, and you can rename the database schema following ‘skyvva_’ with the agent port.
Note: Database Schema defulft name ‘skyvva’

 7. Please select Agent Mode, first mode ‘NON-Opening-Firewall’ with Authentication Type ‘OAuth2 Username-Password’.

*Note: In this step, you can choose installation with 2 authentication types: OAuth2 Username-Password or OAuth2 Client-Credential.

• Select Authentication Type: OAuth2 Username-Password

 Plase Input information form your Salesforce Org.

• Select Authentication Type: OAuth2 Client-Credential.

Plase Input information form your Salesforce Org.

Then Click Install.

Then Click ‘OK’

Then click ‘OK’

Then click ‘OK’

Then click ‘OK’

Then clcik ‘OK’

8. The final step click ‘Finish’ your Agent service will start.

9. You can find the installer artifacts in the folder that was selected during the installation.

10. Here’s the schema name in the PostgresSQL.

 

 

How to Upgrade the Agent to the New Patch or Version #

1. In case if we want to upgrade Skyvva Integration Agent to a new patch, then all we have to do is just install the new upgrade file.
2. While upgrading, the installer will not touch the database file, so we don’t have to bother about that file at all.

Uninstall Agent #

1 Stop the Agent Service first by run SkyvvaIntegrationAgent-stop.bat

2. If you are using a certificate, please make a backup of it.

3. Backup skyvva_application.properties file.

4. Uninstall the old version 3.5.14
C:\Program Files\Skyvva Integration Agent 

5. Look for the uninstall.exe, and execute it by double-clicking on it.

6. After completing the uninstallation process, please install the new version of the Agent 3.06 with old database schema.

4. Input Agent Service Port, Agent Username and Agent Password.

5.Please copy the ‘Database Schema’ from the backed-up skyvva_application.properties file.

 

6. Enter your database password and ensure that it matches your old schema.

6. After completing the other steps, proceed to the final step ‘Finish’ to start the Agent service.

8. Restore the certificate back.

9. Please locate the previous skyvva_application.properties file, copy the entire ‘Agent SSL Properties’ section, replace the corresponding section in the new skyvva_application.properties file, and then remove the ‘#’ to enable it.e.

10. Check the Agent Service and ping the Agent via local URL: http://localhost:9059/application/systemInfo/getSystemInfo

 

Setup SSL for Agent Instance #

We need a valid SSL certificate in .pfx format available to setup SSL for Agent Instance. Please check out the list of available trusted vendors (Outbound Messaging SSL CA Certificates) from which you can purchase an SSL certificate.
1. Copy the new valid SSL certificate to the deployment directory i.e. C:\skyvva-agent
2. Once we have copied the new SSL certificate to the deployment directory, we need to change the property file so that the Agent Instance can pick up the SSL certificate. Open the property file with the name skyvva_application.properties and look for the properties mentioned below.

1. If the user is using SSL, please navigate to the installation directory and click on ‘config’.

 

2. Click on ‘skyvva_application.properties’

3. Copy from ‘skyvva_application.properties’.

==================================
# Agent SSL Properties
# ==================================

# Change this to true, if SSL has to be enabled
skyvva.h2.db.ssl.enabled=false
# Uncomment the following properties to enable SSL for Agent Services
#server.ssl.key-store-type=PKCS12
#server.ssl.key-store=C:\\skyvva-agent\\ssl-certificate.pfx
#server.ssl.key-store-password=Skyvva@12!
#server.ssl.key-alias=1
#security.require-ssl=true

4. As we can see above, all the properties except one have been commented out (which means starts with ‘#’). We will have to uncomment them i.e. remove ‘#’ from the starting of the lines. Once done it will look like as shown below.