> 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-xsiam/configure-cortex-xsiam/data-management/broker-vm/manage-broker-vm/open-live-terminal.md).

# Open Live Terminal

Access a live terminal for a Cortex XSIAM Broker VM.

Learn more about remotely connecting to a Cortex XSIAM Broker VM.

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

1. In Cortex XSIAM, 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 XSIAM 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 19. 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.

#### Applet Names

* 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`

#### Services

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

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`     | Invoke a restart of the routing service after updating your static network route configuration file, `/etc/network/routes`. The `/etc/network/routes` 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. | `sudo ./sbin/restart_routes`              |
| `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` | Change the password of the Broker VM Web UI. Run the command, enter the new password followed by Ctrl+D.                                                                                                                                                                                                                                                                 | `sudo ./sbin/set_ui_password.sh`          |
| `squid_tail`         | Display the Proxy applet Squid log file in real-time.                                                                                                                                                                                                                                                                                                                    | `sudo ./sbin/squid_tail`                  |

{% hint style="info" %}

#### Note

You can either `restart_routes` or reboot the Broker VM for the changes in the `/etc/network/routes` file to take affect.
{% endhint %}


---

# 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://cortex-docs.paloaltonetworks.com/cortex-xsiam/configure-cortex-xsiam/data-management/broker-vm/manage-broker-vm/open-live-terminal.md?ask=<question>&goal=<user_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.
