> Source: https://docs.cyberelements.io/bastion/4.6/Usage/AdminConsoleReference/Sites/

# Sites Management

The **Sites Management** module groups Edge Gateways and HTML5 Gateways under a logical unit that can then be referenced in an access contract. This page is intended for the administrator or integrator who wants to list, create, edit or delete sites, and to describe the status of each Edge Gateway within the site.

A site is required for a resource to be launched: it holds all the candidate Edge Gateways. Several active Edge Gateways within the same site perform load balancing; passive Edge Gateways act as backup Edge Gateways and are used only when all active Edge Gateways are unavailable.

> **Step-by-step tutorial**
>
> For a guided walkthrough of site creation, see [Create a site](https://docs.cyberelements.io/bastion/4.6/Usage/Configuration/AdminConsole/CreateSite/).

---

## Site list

The module opens on a paginated grid listing all sites of the organization.

| Column | Description |
|---|---|
| **Name** | Site name, preceded by a padlock icon. |
| **Description** | Free-text description entered on creation. |
| **Gateways** | Non-HTML5 gateways attached to the site, grouped under the **Active:** and **Passive:** headings. |
| **HTML5 Gateways** | Active HTML5 Gateways attached to the site. Column hidden when the **HTML5 Gateways** module is not visible in the navigation. |

Actions available in the toolbar:

| Action | Description |
|---|---|
| **+** | Opens the **Add Site** window (tooltip **New Site**). |
| **Properties** | Opens the **Edit Site** window for the selected site. Also triggered by double-clicking the row. Enabled only when exactly one site is selected. |
| **×** | Deletes the selected site(s) after confirmation. Multi-selection is supported. |
| **Search** | Filters the list by name substring. Filtering fires 700 ms after the last keystroke, or immediately with the `Enter` key. The cross icon clears the filter. |
| **Pagination** | Paging toolbar at the bottom of the grid. Page size can be set to 15, 25 or 50 rows. |

---

## Add a site

The **+** button opens a three-tab window. **Validate** saves the site; **Cancel** discards the entry.

**Settings**

> | Field | Description |
> |---|---|
> | **Name** | Mandatory. Identifies the site uniquely. A whitespace-only string is rejected. |
> | **Description:** | Free text documenting the purpose of the site. |

**Edge Gateways**

> List of the non-HTML5 gateways known to the organization, with their status regarding the site being edited.
>
> | Column | Description |
> |---|---|
> | **Name** | Edge Gateway name. |
> | **Status** | Status of the Edge Gateway for this site: **ACTIVE**, **PASSIVE** or **UNUSED**. |
>
> Three buttons change the status of the selected Edge Gateway:
>
> | Button | Effect |
> |---|---|
> | **Enable** | The Edge Gateway is used first for the site. Several active Edge Gateways perform load balancing. |
> | **Disable** | The Edge Gateway is no longer used by the site. |
> | **Switch to passive** | The Edge Gateway is used only when no active Edge Gateway of the site is available (backup Edge Gateway). |
>
> The buttons are greyed out according to the current status: **Enable** is disabled when the Edge Gateway is already active, for instance.

**HTML5 Gateways**

> List of the HTML5 Gateways known to the organization. Tab hidden when the **HTML5 Gateways** module is not visible in the navigation.
>
> | Column | Description |
> |---|---|
> | **Name** | HTML5 Gateway name. |
> | **Status** | Status of the HTML5 Gateway for this site: **ACTIVE** or **UNUSED**. |
>
> HTML5 Gateways only carry those two statuses — there is no passive mode, and only the **Enable** and **Disable** buttons are offered. Several active HTML5 Gateways perform load balancing.

> **Name uniqueness**
>
> When the name entered is already used by another site, saving is rejected with the message **This site already exists.**

---

## Edit a site

Select a site in the list then click the **Properties** icon (or double-click the row). The **Edit Site** window carries the three tabs described above, pre-filled with the current values.

One extra field then appears in the **Settings** tab, absent on creation:

| Field | Description |
|---|---|
| **Site properly disconnected:** | Checkbox flagging a site that is not expected to be reachable permanently. |

---

## Delete a site

Select one or several sites in the list then click the **×** button. A confirmation is requested before the actual deletion. Multi-selection is supported.

> **Site used by another module**
>
> Deletion is refused while the site is referenced elsewhere: the message **This site is being used by the following module(s), modify or delete this (these) module(s) before deleting this site.** appears, together with a window listing the sites concerned and, alongside, the **Usage:** column naming the modules that reference them. The **OK** button closes the window.
