> ## Documentation Index
> Fetch the complete documentation index at: https://syteca.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the Syteca Master Panel

> Install the Syteca Master Panel, a component that aggregates Client sessions from every Application Server across your organization into a single interface for centralized session review.

## One interface for sessions across every facility

Distributed organizations run into a common problem with session monitoring. Each location (a branch office, a regional data center, a satellite site) needs its own Application Server for latency and network-locality reasons. Investigators and compliance officers, though, need to see every session from every location together. Without central aggregation, they end up logging in to five or ten different Management Tools and manually reconciling what they find.

The Syteca Master Panel solves that. It's a component installed on a dedicated Windows Server machine that reads session data from every Application Server in the organization and presents it in a single web interface. Sessions, filtering, risk levels, and alerts all appear consolidated. No copying data, no separate database, no relogins.

<Info>
  **Use the Master Panel when your deployment has any of the following characteristics:**

  1. Facilities in multiple locations, each with its own Application Server and Management Tool.
  2. A need for centralized visibility of session risk levels and triggered alerts across the whole organization.
  3. Compliance requirements that ask for a single consolidated audit view instead of per-site logs.
  4. Investigators or SOC analysts who need to search or filter sessions without knowing in advance which Application Server holds the relevant recording.

  For smaller deployments with a single Application Server, the Master Panel is not needed. The Management Tool covers everything at that scale.
</Info>

<Warning>
  **NOT AVAILABLE IN SAAS.** The Master Panel is an on-premises component and does not run in Syteca SaaS deployments.
</Warning>

## What the Master Panel provides

The Master Panel combines data from multiple isolated Syteca Application Servers or deployments into a single user interface. From that interface, an investigator can:

1. View the full list of sessions across every connected Application Server.
2. Filter, search, and sort sessions using the same criteria available in the per-Application-Server Management Tool.
3. Open any session and view its details, including the recorded activity.
4. See risk levels calculated for each session and the alerts triggered within them.

<Frame caption="The Master Panel consolidated session list showing sessions from multiple Application Servers side by side.">
  <img src="https://mintcdn.com/syteca/0FlD-vkHsBA1azVX/images/administration/deployment/master-panel-session-list.png?fit=max&auto=format&n=0FlD-vkHsBA1azVX&q=85&s=6e5edbf5484c4b0d09e5fc07a5561024" alt="Master Panel showing a unified session list drawn from multiple Application Servers" width="1435" height="799" data-path="images/administration/deployment/master-panel-session-list.png" />
</Frame>

## System requirements

The machine hosting the Master Panel must meet the following requirements:

| Requirement            | Value                                                                                                                                                                                |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **CPU**                | 4 to 8 cores                                                                                                                                                                         |
| **RAM**                | 4 GB                                                                                                                                                                                 |
| **Network**            | 1 Gbps Ethernet adapter                                                                                                                                                              |
| **Operating system**   | Windows Server 2022, Windows Server 2019 (Recommended), Windows Server 2019 Core, Windows Server 2016, Windows Server 2012, or Windows 10. Both x86 and x64 platforms are supported. |
| **IIS**                | Internet Information Services 7.5 or higher                                                                                                                                          |
| **.NET runtime**       | ASP.NET Core 7.0 Runtime (Windows Hosting Bundle) or higher                                                                                                                          |
| **Browser for access** | Google Chrome, Microsoft Edge, or Safari (latest released version)                                                                                                                   |

<Note>
  The Master Panel can be opened in other browsers, but compatibility is not guaranteed. If your organization standardizes on a different browser, test it against a non-production Master Panel first.
</Note>

## Install the Master Panel

The installation procedure depends on the operating system on the target machine. Windows Server 2019 Core is a headless (no GUI) variant, so it uses PowerShell commands throughout. All other supported operating systems use the graphical Master Panel Setup wizard.

### Download the installation package

The Master Panel installation package (latest released version) is available at:

```text theme={"system"}
https://download.syteca.com/Syteca_MasterPanel-en.zip
```

Download it once, then transfer the extracted MSI (`SytecaMasterPanel.msi`) to each machine where the Master Panel will be installed.

<Tabs>
  <Tab title="Windows Server 2022 / 2019 / 2016 / 2012 or Windows 10">
    On a Windows Server or Windows 10 machine with the desktop experience, use the graphical Master Panel Setup wizard.

    1. Download the latest **MSI** installation file for the Master Panel from your Syteca distribution package.

    2. Run the **MSI** installation file to open the **Master Panel Setup** wizard.

    3. On the **Welcome to the Master Panel Setup Wizard** page, click **Next**.

    4. On the **End-User License Agreement** page, select the **I accept the terms in the License Agreement** checkbox, then click **Next**.

    5. On the **Requirements** page, the wizard checks whether IIS and ASP.NET Core Runtime are installed. If a required component is missing, a yellow warning triangle appears next to it.

           <Frame caption="The Requirements page shows which system components are already installed and which need attention before installation can continue.">
             <img src="https://mintcdn.com/syteca/0FlD-vkHsBA1azVX/images/administration/deployment/master-panel-requirements-page.png?fit=max&auto=format&n=0FlD-vkHsBA1azVX&q=85&s=95adfaf315a6d3e31ad93df5cc1eec6d" alt="Master Panel Setup wizard Requirements page showing prerequisite check results" width="488" height="379" data-path="images/administration/deployment/master-panel-requirements-page.png" />
           </Frame>

       If IIS needs to be installed or configured, see the [Quick Start Deployment Guide](/docs/get-started/checklist) for the IIS turn-on and configuration procedure.

       If **ASP.NET Core 7.0 Runtime (v7.0.0) Windows Hosting Bundle** needs to be installed, click the link next to the warning triangle to download it from Microsoft. Any version later than 7.0.0 can also be used.

    6. After installing any missing components, click **Refresh** (in the bottom left of the Requirements page) so the wizard rechecks the system.

    7. Once every requirement is satisfied, click **Next**.

    8. On the **Destination Folder** page, select the folder where the Master Panel will be installed, then click **Next**.

    9. On the **Ready to install Master Panel** page, click **Install** to start the installation.

    10. Wait for installation to complete on the **Installing Master Panel** page.

    11. On the **Complete the Master Panel Setup Wizard** page, click **Finish** to close the wizard.

    The Master Panel is now installed and ready to be configured.
  </Tab>

  <Tab title="Windows Server 2019 Core">
    Windows Server 2019 Core is a headless installation without a graphical desktop. The Master Panel install runs from a PowerShell admin prompt using MSI silent mode.

    <Warning>
      Windows Server 2019 Core does not include the GUI installer for prerequisites. Both IIS and the ASP.NET Core Runtime must be installed manually before the Master Panel MSI can run.
    </Warning>

    Open a PowerShell admin prompt on the target Windows Server 2019 Core machine, then run the following commands in sequence.

    1. Install Internet Information Services (IIS):

       ```powershell theme={"system"}
       Install-WindowsFeature -name Web-Server -IncludeManagementTools
       ```

    2. Download the ASP.NET Core 7.0 Runtime Windows Hosting Bundle installer:

       ```powershell theme={"system"}
       wget "https://download.visualstudio.microsoft.com/download/pr/19927e80-7df2-4906-badd-439502008177/cb55d49c06a3691965b4bcf934ead822/dotnet-hosting-7.0.5-win.exe" -OutFile dotnet-hosting-7.0.5-win.exe -UseBasicParser
       ```

           <Note>
             The direct download URL above is from the original source documentation and points to a specific patch level (7.0.5). Later Runtime versions are also acceptable. If the URL becomes stale, download from the [Microsoft .NET download page](https://dotnet.microsoft.com/en-us/download/dotnet/7.0) instead.
           </Note>

    3. Run the ASP.NET Core Runtime installer:

       ```powershell theme={"system"}
       .\dotnet-hosting-7.0.5-win.exe
       ```

    4. Run the Master Panel MSI installer:

       ```powershell theme={"system"}
       msiexec /i SytecaMasterPanel.msi
       ```

    <Warning>
      The MSI filename `SytecaMasterPanel.msi` is a literal Syteca distribution artifact name. If your distribution package contains a different filename (older packages may still use `EkranMasterPanel.msi`), substitute accordingly.
    </Warning>

    The Master Panel is now installed and ready to be configured.
  </Tab>
</Tabs>

## Configure the Master Panel and connect it to Management Tools

After the Master Panel is installed, the Configuration Wizard runs on first launch. Set the local admin password, then connect the Master Panel to every Management Tool that will feed sessions into it.

### Open the Master Panel

Open the Master Panel by entering its URL in a browser address bar:

```text theme={"system"}
https://localhost/esmp/#/
```

<Note>
  To open the Master Panel from a different computer, replace `localhost` with the IP address or hostname of the computer where the Master Panel is installed.
</Note>

<Note>
  For a secure HTTPS connection when accessing the Master Panel from other computers, set up an HTTPS binding for the default website. See the [Quick Start Deployment Guide](/docs/get-started/checklist) for the HTTPS binding procedure.
</Note>

### Set the Master Panel admin password

On the first startup of the Master Panel, the **Configuration Wizard** opens.

1. Enter a password for the `admin` user in both the **Password** and **Password Confirmation** fields.
2. Click **OK**.

<Frame caption="Master Panel Configuration Wizard. Set the local admin password on first launch.">
  <img src="https://mintcdn.com/syteca/0FlD-vkHsBA1azVX/images/administration/deployment/master-panel-admin-password.png?fit=max&auto=format&n=0FlD-vkHsBA1azVX&q=85&s=0b0856226cf4ce07e6f0a61654588050" alt="Master Panel Configuration Wizard admin password step" width="1180" height="596" data-path="images/administration/deployment/master-panel-admin-password.png" />
</Frame>

### Get the Master Panel Access Key

The Configuration Wizard displays the **Master Panel Access Key**. This key authorizes each Management Tool to be added to the Master Panel.

Click the **Copy** button to the right of the Access Key to copy it to the clipboard.

<Frame caption="The Master Panel Access Key. Copy it now for the next step in each Management Tool.">
  <img src="https://mintcdn.com/syteca/0FlD-vkHsBA1azVX/images/administration/deployment/master-panel-access-key.png?fit=max&auto=format&n=0FlD-vkHsBA1azVX&q=85&s=88fd1083c044a5f3e0391189fff0a662" alt="Master Panel Access Key display with Copy button" width="1181" height="430" data-path="images/administration/deployment/master-panel-access-key.png" />
</Frame>

### Add the Access Key in each Management Tool

For every Management Tool the Master Panel will connect to, log in to that Management Tool and add the Access Key.

<Note>
  The user performing this step in each Management Tool needs the following [administrative permissions](/docs/administration/users/administrative-permissions):

  1. **Tenant Management and System Configuration**
  2. **Management Tool Access**
</Note>

<Steps>
  <Step title="Open Configuration">
    In the Management Tool, click the **Configuration** button at the top of the interface.
  </Step>

  <Step title="Open the Master Panel Access tab">
    On the **Configuration** page, select the **Master Panel Access** tab.
  </Step>

  <Step title="Paste the Access Key">
    Paste the Access Key that you copied from the Master Panel into the empty field, then click **Add** to the right of the field.
  </Step>

  <Step title="Verify the Access Key was added">
    The Access Key appears at the bottom of the **Access Key** list. It can be removed later by clicking the remove icon on the right of it.
  </Step>
</Steps>

Repeat this procedure for every Management Tool the Master Panel will connect to.

### Add each Management Tool to the Master Panel

Switch back to the Master Panel Configuration Wizard, then add each Management Tool.

<Steps>
  <Step title="Add a new server row">
    Click the **+** button on the left of the **URL** column header. A new empty row appears.
  </Step>

  <Step title="Enter the URL and server name">
    In the new row:

    1. Enter the URL of the Management Tool in the **URL** field. Format: `https://<hostname>/<Path_to_the_Management_Tool>` (for example, `https://terminal/Syteca`). The hostname is the computer where the Management Tool is installed.
    2. Enter a unique name for the server in the **Server** field.
    3. Click the check mark on the right of the row to save.
  </Step>

  <Step title="Confirm the Management Tool was added">
    The Management Tool now appears in the list of Management Tools connected to the Master Panel.
  </Step>
</Steps>

Repeat for every Management Tool. When all required Management Tools are connected, click **Next** at the bottom right of the Configuration Wizard.

### Skip or configure SSO

On the SSO configuration step, either configure single-sign-on now or click **Skip** to finish setup.

<Note>
  SSO configuration can be done later at any time. Master Panel SSO uses the same mechanism as [Management Tool SSO](/docs/administration/integrations/sso), and must be configured in both the Master Panel and every connected Management Tool.
</Note>

The Master Panel is now configured and ready to be used.

### Modify configuration later

To modify the Master Panel configuration or connect it to additional Management Tools, log in to the Master Panel as the `admin` user and repeat the steps above as needed.

The user drop-down menu in the top right of the Master Panel page includes:

| Option            | Purpose                                                      |
| ----------------- | ------------------------------------------------------------ |
| **Log out**       | End the current admin session.                               |
| **Download logs** | Download the Master Panel logs for troubleshooting.          |
| **Settings**      | Change the `admin` password or configure SSO authentication. |

### Health monitoring and diagnostics

The **Servers** grid at the top of the page controls the connected Management Tools:

| Button        | Purpose                                         |
| ------------- | ----------------------------------------------- |
| **Refresh**   | Refresh the list of Management Tools.           |
| **Pencil**    | Edit the name or URL of a Management Tool.      |
| **Trash can** | Remove a Management Tool from the Master Panel. |

The **Health Monitoring** grid at the bottom shows issues with any Management Tool or its associated Application Server:

| Message in Details column             | Meaning                                                                                                                   |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `Login failed. Server is unavailable` | The Application Server is stopped, or the connection to it or to the Management Tool has been lost.                       |
| `Login failed. Unable to sign in`     | The Master Panel user does not have the required permissions in that Management Tool, or the user account does not exist. |

## Use the Master Panel

Once configuration is complete, users log in to the Master Panel to view sessions from every connected Management Tool in a single interface.

### Log in to the Master Panel

To view all sessions from all Management Tools, log in to the Master Panel using the credentials of an Active Directory user.

<Note>
  **The logged-in user will only see sessions from Management Tools where they hold the following administrative permissions:**

  1. **Management Tool Access** permission.
  2. **Viewing Monitoring Results** permission.

  Sessions from Management Tools where the user lacks these permissions will not appear in the Master Panel grids for that user.
</Note>

### The three grids on the Master Panel page

After logging in, the Master Panel displays three grids:

**Sessions grid (top).** All active and completed Client sessions from all connected Management Tools. Filtering, searching, and sorting work the same way as in each Management Tool. Click a session to open it in the Session Player.

<Frame caption="The Sessions grid consolidates Client sessions from every connected Management Tool.">
  <img src="https://mintcdn.com/syteca/0FlD-vkHsBA1azVX/images/administration/deployment/master-panel-session-list.png?fit=max&auto=format&n=0FlD-vkHsBA1azVX&q=85&s=6e5edbf5484c4b0d09e5fc07a5561024" alt="Master Panel Sessions grid" width="1435" height="799" data-path="images/administration/deployment/master-panel-session-list.png" />
</Frame>

**Archived Sessions grid (middle).** All Client sessions that have been archived from any connected Management Tool. Uses the same filtering interface as the top grid.

**Diagnostics grid (bottom).** The list of Management Tools currently available, and per-Management-Tool status:

| Status column value                                                                       | Meaning                                                                                                                                                                                            |
| ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Available                                                                                 | The Management Tool and its Application Server are reachable and returning session data.                                                                                                           |
| `You do not have permission to view the monitoring results. please contact administrator` | The logged-in user lacks required permissions for this Management Tool. Sessions from this Management Tool are excluded from the Sessions and Archived Sessions grids.                             |
| `Login failed. Please check servers availability or user permissions`                     | One or more Management Tools are unavailable. The number appears in an extra row at the bottom of the grid. Details are visible to the `admin` user in the Health Monitoring grid described above. |

## Related

<CardGroup cols={2}>
  <Card title="System requirements" icon="server" href="/docs/get-started/system-requirements">
    General Syteca System Requirements for Application Servers and Clients.
  </Card>

  <Card title="Application Server deployment" icon="server-cog" href="/docs/administration/deployment/install-application-server">
    Install and configure the Application Servers that the Master Panel will aggregate data from.
  </Card>

  <Card title="Deployment architecture" icon="network" href="/docs/administration/deployment/architecture">
    How Application Servers, Clients, and the Master Panel fit into a distributed deployment.
  </Card>

  <Card title="High availability" icon="shield-check" href="/docs/administration/deployment/high-availability">
    High-availability options for the Application Servers behind the Master Panel.
  </Card>
</CardGroup>