> For the complete documentation index, see [llms.txt](https://docs.novacura.com/flow-connect/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.novacura.com/flow-connect/working-with-connect/connect-to-systems/connector-agents/manage-agent.md).
# Manage agent
You can manage the agents from the Agent Manager
## Start/stop agent
1. In the **Agent Manager** choose a agent you want start/stop.
2. Select **Stop** if the agent is running but you want to stop the agent.
3. Select **Start** if the agent is stopped but you want to start the agent.
## Export encryption keys
Once you install a agent its important that you export the the encryption keys and store them securely. To export the encryption keys,
1. In the **Agent Manager** select an Agent and select **Details**.
2. Click **Export Keys**.
3. Agent Manager will ask you to set a **password** (at least 12 characters) to encrypt the exported keys.
4. Store exported file and password securely.
## Uninstall agent
1. In the **Agent Manager** select the agent you want to uninstall and select **Details**.
2. Select **Uninstall**.
3. Generate a new token in the Hub and paste it into the uninstaller. Make sure to select the correct agent group when generating the token. Generated tokens are valid for one week.
4. Select **Uninstall** to confirm.
## Upgrade agent
### Upgrade via Connect Hub
The Flow Connect Hub notifies you when a new version of the Connector Agent is available. A blue dot in the **Agent** menu indicates that an update is available.
1. Select the **Agent Group** containing the Agent(s) with available updates.
2. Click **Update** to update the Agent.
{% hint style="warning" %}
The Connector Agent will be unavailable during installation.
**Tip:** To avoid downtime, configure at least two Connector Agents in the same group and update them one at a time. While one Agent is unavailable, the other Agent can continue processing the workload, ensuring uninterrupted operation.
{% endhint %}
### Upgrade using Agent Manager
1. In the **Agent Manager** select the agent you want to upgrade and select **Details**.
2. Select **Upgrade**.
3. Generate a new token in the Hub and paste it into the installer. Make sure to select the agent group that the agent belongs to when generating the token.
4. Select **Upgrade** to confirm.
{% hint style="warning" %}
If you encounter following error during the upgrade, retry the update operation once again.
{% endhint %}
## Access agent logs
1. In the **Agent Manager** select an agent and select **Details**.
2. Select **Open Folder.** This is will open the local file folder where the agent is installed.
3. In the local installation folder you can find sub folder named logs.
## Configure agent logs
By default agent logs are kept for 7 days where a log file is created for each day. You can configure how long the agent logs are kept. *Note that the log configuration is reset every time the agent is upgraded.*
1. In the **Agent Manager** select an agent and select **Details**.
2. **Stop** the agent if its in running state.
3. Select **Open Folder.** This is will open the local file folder where the agent is installed.
4. In the local installation folder find the file named `appSettings.json` file and open it in you favorite text editor.
5. Modify the parameter *RetainedFileCountLimit.* This number is usually in days. Save the file.
6. **Start** the agent again.
## Configure MaxConcurrentExecutions for a agent
By default, agents are configured to allow up to 50 concurrent sessions. You can override this setting by modifying the `appSettings.json` file. Keep in mind that increasing the **`MaxConcurrentExecutions`** value depends on the hardware capabilities of the machine or server where the agent is installed.
1. In the **Agent Manager** select an agent and select **Details**.
2. **Stop** the agent if its in running state.
3. Select **Open Folder.** This is will open the local file folder where the agent is installed.
4. In the local installation folder find the file named `appSettings.json` file and open it in you favorite text editor.
5. Modify the MachineStepQueueSettings section to include the **`MaxConcurrentExecutions`** parameter.
```json
"MachineStepQueueSettings": {
"ConnectionString": "",
"QueueName": "",
"MaxConcurrentExecutions": 100
}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.novacura.com/flow-connect/working-with-connect/connect-to-systems/connector-agents/manage-agent.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
{% endhint %}
## Access agent logs
1. In the **Agent Manager** select an agent and select **Details**.
2. Select **Open Folder.** This is will open the local file folder where the agent is installed.
