Agent

• Overview

• Minimum Requirements

• Installation

• Settings

• Logs

  • Windows

  • Linus e Docker

  • Agent Registration: Possible Errors

Overview

Most ERPs do not have open and complete APIs that allow these software applications to be integrated with other applications and solutions. As an alternative, most ERP vendors allow or tolerate data-level integration. In this type of integration, an external agent, typically a service installed on the same machine as the database, has access to the database and can execute queries on tables or views within the system.

Based on this concept, we created "Agent", a secure extension of the Skyone Studio platform that can be installed in On Premises environments, using secure communication mechanisms. When used, the "Agent" is a passive component, only executing requests sent by external software or automated on the platform.

General characteristics of the "Agent":

• Connect locally to a database or REST resource

• Support for multiple database types

• Restful support

• Processing requests coming from any Skyone Studio Integration, with different users and permissions

• Connecting to Skyone Studio and keeping a communication channel open to receive calls immediately

• Receiving "RPC like" calls from Skyone Studio, which are mapped into actions in the database or into REST calls

• Responding asynchronously to Skyone Studio calls

• Automatically restarting itself if the computer on which it is installed is restarted, without the need to re-enter authentication data.

Minimum Requirements

The minimum requirements for the Agent:

Disk: 1GB free

Memory: 512MB

CPU: 1 core 1.5GHz

Installation

To download and install "Agente" :

1. Click on "Terminals" and then click on "Download Agent".

2. Note that there are three download options: Windows, Linux and Docker. Choose the most suitable option and click on "Download".

3. Follow the instructions according to your operating system:

Windows

For the Windows operating system:

1. On the screen that appears when you run the application, click on "Next". Wait for the installation to finish.

2. Once the installation has been successful, click on the "Launch application" option and then on the "Finish" button to complete the installation.

3. The Agent will start up and you will be presented with some steps for configuring it. Click on "Next".

   
4. Enter your Skyone Data access credentials and click "Next".

   
5. Select the organization (workspace) you want to use the "Agent" for and enter a name and location for it.

   

Done! Your "Agent" is configured and ready to be used in Windows environments. Click on "Finish" to end the configuration procedure.

Linux

To install the Agent on Linux, follow these steps:

1. Access Administrator Mode

You need to enter root mode. Use the following command:

sudo su

1. Download the Installer

Download the Agent .deb file using the curl command:

curl https://skyone-integrasky-inventory-hml.s3.amazonaws.com/agent/linux/IntegraSkyAgentSetup_v0.0.0.114.deb --output IntegraSkyAgentSetup_v<version>.deb

1. Install the Agent

Once the file is downloaded, run the installation of the .deb package:

apt install -f ./IntegraSkyAgentSetup_v<version>

1. Open the installation folder

Navigate to the folder where the Agent was installed:

cd /usr/local/bin/skyone-solutions/integrasky-agent  

1. Run the Agent

Start the Agent using the following command:

./IntegraSky

1. Register the Agent

Register the terminal with the provided credentials:

register -u <user@email> -p <password>

On the Skyone platform, you will have access to the command above with your email already included.

Your workspaces will be listed and you will be asked to select which one you want to connect:

Example

Docker

For Docker, first make sure you have Docker installed on your machine. If not, follow the procedure here.

After installing Docker on your machine, you need to download the image:

docker pull integrasky/agent:latest

Once the download is complete, you can run the "Agent" using the command below.

docker run -e "INTEGRA_ENV_USER=<email>" -e "INTEGRA_ENV_PASSWORD=<password>" -e "INTEGRA_ENV_ORGANIZATION_ID=<code?" -e "INTEGRA_ENV_AGENT_NAME=<agent name>" -e "INTEGRA_ENV_AGENT_LOCATION=<agent location>" integrasky/agent:latest -v /caminho/para/dados:/data/integraNa plataforma Skyone, você tem acesso ao comando acima já com o seu email e seu Organization ID inclusos.

On the Skyone platform, you have access to the above command with your email and Organization ID already included.

Check all the configuration options below in the Docker tab under Settings.

Find out more about the versions supported by the Agent.

You will need to reinstall the "Agent" if you need to move it to another workstation, add it to Skyone Studio again, or if you need to make hardware modifications.

Settings

Follow the instructions to configure your "Agent" according to your operating system:

Windows

When you click on the "Agent" in Windows, Settings is the first tab to appear in the window, as shown in the image below:

These include:

• Integration service status: it is possible to Start, Stop and Restart the integration service. When it is stopped, it is not possible to carry out operations on the platform involving accounts connected to the registered "Terminal".

• Internet connection test: identifies whether the "Agent" is connected to the internet.

• Server connection: identifies whether the "Agent" is connected to plataform's servers.

• Concurrency process limit: allows the capacity for parallel processing to be set between the range of 1 and 100. The default value is 50. The default value is 50. After making any changes, click "Apply". After that, confirm the restart of the "Agent" services by clicking "Yes", so that the new settings are activated.

• Allow untrusted SSL certificates in REST/SOAP requests: by activating this option, the "Agent" will allow communication between systems, even if the SSL certificate is not considered secure by conventional standards. By sliding the button, a window will appear for you to confirm the restart of the "Agent" services and the new settings will be activated.

When either of the two services (integration or server) is working, the colored icon will be green. If there is a problem with the connection, it will turn red. If the "Agent" is waiting to connect to one of the services, the icon will turn gray.

Once the "Agent" has been registered, it will soon appear in the "Terminals" tab.

If there is a problem with any of the services (integration or server), the status of the registered "Agent" will also appear in gray or red in the "Status" column.

It is possible to close the Agent window without compromising the use of Skyone Studio. However, the computer must be powered on for communication to take place.

Linux

To configure the "Agent" on Linux, access the Linux terminal after installation.

You can run the following commands:

• global_settings -view : allows you to view the Agent's global settings, such as server status, integration status, etc.

• global_settings -concurrency_limit (1..100) : sets the number of parallel processes that the agent can handle in the range 1 to 100. The default value is 50.

• global_settings -allow_unsafe_ssl_certificate true|false : enable/disable checking the destination's SSL certificate before making a REST/SOAP call.

After making any changes, you will need to restart the "Agent" for the new settings to be applied.

Docker

To configure the "Agent" in Docker, change the fields previously filled in during installation.

Where:

• INTEGRA_ENV_USER=<email> : the email used on the Skyone platform.

• INTEGRA_ENV_PASSWORD=<password> : the password used on the Skyone platform.

• INTEGRA_ENV_ORGANIZATION_ID=<organization_id> : your organization ID, available in the Docker Installation area on the Skyone platform.

• INTEGRA_ENV_AGENT_NAME=<agent_name> : name of the agent.

• INTEGRA_ENV_AGENT_LOCATION=<agent_location> : agent location

• INTEGRA_ENV_CONCURRENCY_LIMIT=<concurrency_limit> : sets the number of parallel processes the agent can handle between the range of 1 to 100. The default value is 50.

• INTEGRA_ENV_ALLOW_UNSAFE_SSL_CERTIFICATES=<allow_unsafe_ssl_certificates> : enable/disable verification of the destination's SSL certificate before making a REST/SOAP call.

Logs

Windows:

There is a read-only Logs tab, which shows all the Agent's logs. These logs will be updated as new events occur.

Linus e Docker

You can access the logs folder from the directory where the application is running.

Example: cat /logs/log20231206.txt

Agent Registration: Possible Errors

The following errors are possible in the return of the registration request:

Error Message	Description / Action
Agent already configured on host	The plataform has identified that there is an "Agent" previously configured on the workstation. You can either abort the installation or, if you are so authorized, you can enter the plataform panel and delete the "Terminal" associated with the old "Agent". Doing that allows you to retry the operation. If you do not have permission to delete the "Terminal", you might be trying to install the "Agent" in the wrong workspace. Note: the same "Agent" can be used by several Integrations; therefore, there is no need for multiple installations.
Agent name already exists	The plataform has identified that there is already an "Agent"with the same name available in the workspace. It is possible that this happened because you want to move the "Agent" from one workstation to another, without losing all the work already done in the Integrations that point to the Agent Terminal. In this case, you must install the Agent on the new station and use the same name to replace the previous one. Therefore, Skyone Data alerts you that the previous Agent with the same name will be deactivated and replaced by the new one and also asks for your confirmation to proceed with this change.
Control channel is not configured	It only appears while the "Agent" is being configured, before its data is entered, and it means that the "Agent" has not yet been configured. There no action required.