Manage Agents and Agent Pools

Discover the different types of Grapes agents and how they work

To perform operations such as export, import, etc., on databases, you need to have at least one agent.

Each time you execute an operation, Grapes starts one or more agents. An agent is a computer infrastructure with agent software installed, which executes jobs one by one.

Two types of agents are available:

TypeDescription
Grapes Hosted AgentsAgents hosted and managed by Grapes teams
Self-Hosted AgentsAgents that you configure and manage, hosted on your VMs and/or containers

Grapes Hosted Agents

If your security rules allow external connections and databases are accessible from outside, then you can use agents provided and managed by Grapes.

Grapes provides a predefined agent pool called Grapes Hosted Agent Pool with agents hosted by Grapes.

This is the simplest and most direct way to perform operations on databases. You can try this method as long as agents can access your databases.

Self-Hosted Agents

A self-hosted agent is an agent that you configure and manage yourself to execute operations. Self-hosted agents give you more control as they are installed in your infrastructure and can securely access your databases.

The agent installation must be performed by an administrator.

You can install an agent on Linux, macOS, or Windows machines. You can also install an agent on a Linux Docker container. For more information on installing a self-hosted agent, see:

  • Windows Agent
  • Linux Agent
  • Windows Agent
  • Docker Agent

Parallel Jobs

Parallel jobs represent the number of jobs you can run simultaneously in your organization. If your organization has only one parallel job, you can run only one job at a time in your organization. Additional simultaneous jobs are then queued until the first job finishes. To run two jobs simultaneously, you need two parallel jobs. In Grapes, you can run parallel jobs on infrastructure hosted by Grapes or on your own (self-hosted) infrastructure.

Grapes provides a default free service level in each organization with at least one parallel job. Depending on the number of simultaneous operations to be executed, you may need additional parallel jobs to use multiple agents hosted by Grapes or self-hosted simultaneously. For more information on parallel jobs and the different free service levels, see Parallel Jobs in Grapes [TODO].


Create and Manage Agent Pools

Learn how to create and manage Grapes agent pools

Self-Hosted Windows Agents

Learn how to install a self-hosted Grapes Agent on Windows and what software and hardware prerequisites are needed

Self-Hosted Linux Agents

Learn how to install a self-hosted Grapes Agent on Linux and what software and hardware prerequisites are needed

Self-Hosted macOS Agents

Learn how to install a self-hosted Grapes Agent on macOS and what software and hardware prerequisites are needed

Self-Hosted Docker Agents

Learn how to install a self-hosted Grapes Agent in a Docker container and what software and hardware prerequisites are needed

Configure a Self-Hosted Agent

Configure a Self-Hosted Agent