> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-xdr-3.x/cortex-xdr-3.x-documentation/data-management/broker-vm/manage-broker-vm/open-live-terminal.md).

# Open Live Terminal

Cortex XDR enables you to connect remotely to a Broker VM directly from Cortex XDR.

1. In Cortex XDR, select Settings → Configurations → Data Broker → **Broker VMs** table.
2. Locate the Broker VM you want to connect to, right-click and select **Open Live Terminal**.

   Cortex XDR opens a CLI window where you can perform the following commands:

### Logs

Broker VM logs are located in `/data/logs/folder` and contain the applet name in the file name.

Example 63.&#x20;

Folder `/data/logs/[applet name]`, containing `container_ctrl_[applet name].log`

### Administration commands

Broker VM supports the commands listed in the following table. All the commands are located in the `/home/admin/sbin` folder.

Cortex XDR requires you use the following values when running commands:

{% hint style="info" %}

#### Notice

The only applet that is available with a Cortex XDR Prevent license is the Local Agent Settings. The rest of the applets are only available with a Cortex XDR Pro license.
{% endhint %}

<details>

<summary>Applet Names</summary>

* CSV Collector: `file_collector`
* Database Collector: `db_collector`
* Files and Folders Collector: `log_collector`
* FTP Collector: `ftp_collector`
* Kafka Collector: `kafka_collector`
* Local Agent Settings: `tms_proxy`
* NetFlow Collector: `netflow_collector`
* Network Mapper: `network_mapper`
* Syslog Collector: `anubis`
* Windows Event Collector: `wec`

</details>

<details>

<summary>Services</summary>

* Upgrade: `zenith_upgrade`
* Frontend service: `webui`
* Sync with Cortex XDR: `cloud_sync`
* Internal messaging service (RabbitMQ): `rabbitmq-server`
* Upload metrics to Cortex XDR: `metrics_uploader`
* Prometheus node exporter: `node_exporter`
* Backend service: `backend`

</details>

The following table displays the available commands in alphabetical order:

| Command              | Description                                                                                                                                                                                                                                                                                                                                                                                                 | Example                                                                                                                                                                                                                                                                                                                |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `applets_restart`    | Restarts one or more applets.                                                                                                                                                                                                                                                                                                                                                                               | `sudo ./sbin/applets_restart wec`                                                                                                                                                                                                                                                                                      |
| `applets_start`      | Start one or more applets.                                                                                                                                                                                                                                                                                                                                                                                  | `sudo ./sbin/applets_start wec`                                                                                                                                                                                                                                                                                        |
| `applets_status`     | Check the status of one or more applets.                                                                                                                                                                                                                                                                                                                                                                    | `sudo ./sbin/applets_status wec`                                                                                                                                                                                                                                                                                       |
| `applets_stop`       | Stop one or more applets.                                                                                                                                                                                                                                                                                                                                                                                   | `sudo ./sbin/applets_stop wec`                                                                                                                                                                                                                                                                                         |
| `restart_routes`     | <p>Invoke a restart of the routing service after updating your static network route configuration file, <code>/etc/network/routes</code>.</p><p>The <code>/etc/network/routes</code> configuration file is a standard routes configuration file and can be edited directly. The admin user that you logged in with, when using the remote terminal or via SSH, has read/write permissions to this file.</p> | <p><code>sudo ./restart\_routes</code></p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note</strong></p><p>You can either <code>restart\_routes</code> or reboot the Broker VM for the changes in the <code>/etc/network/routes</code> file to take affect.</p></div> |
| `services_restart`   | Restarts one or more services. OS services are not supported.                                                                                                                                                                                                                                                                                                                                               | `sudo ./sbin/services_restart cloud_sync`                                                                                                                                                                                                                                                                              |
| `services_start`     | Start one or more services.                                                                                                                                                                                                                                                                                                                                                                                 | `sudo ./sbin/services_start cloud_sync`                                                                                                                                                                                                                                                                                |
| `services_status`    | Check the status of one or more services.                                                                                                                                                                                                                                                                                                                                                                   | `sudo ./sbin/services_status cloud_sync`                                                                                                                                                                                                                                                                               |
| `services_stop`      | Stop one or more services.                                                                                                                                                                                                                                                                                                                                                                                  | `sudo ./sbin/services_restart cloud_sync`                                                                                                                                                                                                                                                                              |
| `set_ui_password.sh` | <p>Change the password of the Broker VM Web UI.</p><p>Run the command, enter the new password followed by Ctrl+D.</p>                                                                                                                                                                                                                                                                                       | `sudo ./sbin/set_ui_password.sh`                                                                                                                                                                                                                                                                                       |
| `squid_tail`         | Display the Proxy applet Squid log file in real-time.                                                                                                                                                                                                                                                                                                                                                       | `sudo ./sbin/squid_tail`                                                                                                                                                                                                                                                                                               |


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cortex-docs.paloaltonetworks.com/cortex-xdr-3.x/cortex-xdr-3.x-documentation/data-management/broker-vm/manage-broker-vm/open-live-terminal.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
