# On-prem command-line scripts
Enterprises often have on-prem applications and databases that are deployed within their corporate data center.
Workato's On-prem command-line scripts
connector allows you to run command line scripts in the allowlist in your private network. The command is executed by the on-prem agent. You can allowlist any command that can be run on the machine with the on-prem agent.
WARNING
Ensure proper access control for the agent process to avoid executing unauthorized commands.
Additionally, you can restrict access to this on-prem connection using dedicated privileges (opens new window).
# Setup and connection directly in Workato using cloud profile
First, follow the instructions to setup an on-prem group for cloud profile.
Next setup an on-prem agent.
Run the on-prem agent. Then check your on-prem agent management page (opens new window) and make sure your agent is
Active
.After the agent is active, you will be able to setup Workato's
On-prem files
connector. Select on-prem group that you created in step 1.You can type the script directly in Workato. It will be executed by your on-prem agent(s).
# Setup and connection using config file
First, follow the instructions to setup an on-prem agent.
Next, find the agent's
config.yml
file and setup a connection profile forOn-prem command-line scripts
. Following the example provided in the documentation provided, we have created a profile calledworkday_reports
.Run the on-prem agent. Then check your on-prem agent management page (opens new window) and make sure your agent is
Active
.
- After the agent is active, you will be able to setup Workato's
On-prem files
connector. Input the connection profile name and select an On-prem agent, in this case,workday_reports
andOn-prem command-line scripts
.
- Select
Link your account
. If everything is setup correctly, you will see aConnection success
message.
# Execute command-line script action
# Command
The commands listed in the on-prem agent's config.yml
file are the only ones that can be invoked with this connector. The commands are added to the allowlist when you include them in this file. View how to setup a connection profile here.
# Input parameters
The input parameters should be specified when creating your profile in the on-prem agent's config.yml
file. In the example below, two parameters, target_directory
and source_file
were specified. View how to setup a connection profile here.
Input parameters in the agent's config.yml file
Correspondingly, after selecting the command-line script 'Append file to another' in your recipe, the 2 parameters appear in the script input as required values as shown below:
Input parameters in the recipe
In the fields, you should provide data pills or static data that you wish to use in your command-line script.
# Other parameters
Timeout
From on-prem agent version 2.10.0 thetimeout
parameter can be specified directly in the action. This property is the maximum duration (in minutes) for each script execution. The value of the timeout parameter defaults to 2 minutes when not provided. The maximum supported value is 1440 minutes (24 hours).Concurrency limit
Theconcurrency_limit
parameter is specified in theconfig.yml
file. This value states the maximum number of concurrently executed scripts and defaults to 10 when not provided. After reaching the limit, requests will be queued until prior scripts are executed.
# Escaping parameter values
To escape parameter values, use an escape character when defining a profile in the on-prem agent's config.yml
file. The escape_char property value is set to \
on Unix and ""
on Windows.
Using an escape character
In the example shown in the image above, values in the target_file
name can be escaped with a backslash.
# Invocation styles (Synchronous/asynchronous)
To invoke the command asynchronously, scroll to the 'Remove optional fields' drop-down and select the field 'Run script in background?'. Running the command in the background allows the rest of the recipe steps to continue without waiting for the command to complete (asynchronous).
Leave the option blank or select 'No' and the command will run in the foreground (synchronous). The recipe will wait for the command to complete its run before proceeding to the subsequent steps.
# Output data
The output of the execute command-line script includes:
Process ID
An ID that is unique to the command-line script that was run.Exit code
Every command returns an exit code. A successful command returns a 0, while an unsuccessful one returns a non-zero value that is the error code.System out
System out shows the message that is returned after the command-line script has run. The message is restricted by a 50k character limit.
Last updated: 12/20/2024, 6:06:00 PM