# Interface Overview: Management Application

Macula Console is a straightforward graphics user interface tool with access to all possible server settings. To ensure comfortable and easy navigation, it is important that you become acquainted with its structure before starting to use it.

Note that Macula Console appearance slightly depends on your software package and license limitations. Nevertheless, its logic always remains the same. Those sections, which are unavailable due to license restrictions, will be grayed out but still listed to get you acquainted with all available features. You can hide those features via Macula Console settings or upgrade your Macula server to a superior version.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2F2qD4u9JKEQtG4Vptunql%2Fimage.png?alt=media&#x26;token=3818e7cb-9828-49e0-afab-230ad9d2baba" alt=""><figcaption></figcaption></figure>

#### Navigation Panel

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FywCYEeCw2Ft9GjRlzBcC%2Fimage.png?alt=media&#x26;token=afb9347b-376d-40e5-8c3d-be1c902e676f" alt=""><figcaption></figcaption></figure>

The blue panel on top serves as navigation bar and its usage is similar to that of Windows Explorer. Here are its main components (from left to right):

* *Left* and *Right* arrows enable navigation through your browsing history and allow you to switch between previous and next locations; you can also use Backspace on your keyboard to go back
* Your current location is displayed right next to these arrows
* Currently logged in User account button with options to view user profile, switch servers\*, or to log out
* *Refresh* button - reloads current item list
* *Search* field - only items matching the search criteria will be displayed in the list

\*The option to switch servers is hidden by default and can be enabled via application menu.

#### Application Menu

<div align="left"><figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FLsmTzkAvYkAQrBDQTvOl%2Fimage.png?alt=media&#x26;token=62c2ccb5-a45f-4c1f-9bc9-21c6f87bef10" alt=""><figcaption></figcaption></figure></div>

* Application menu button in the upper-right-hand corner gives you the following launches the options:
* launch the Setup Wizard
* import the configuration from an XML file
* import the configuration from another GSF Macula server database
* change Macula Console settings
* enable cybersecurity checks
* set up automatic configuration backup
* remotely upgrade system components
* open the software documentation
* open the About section

#### User Menu

This menu offers the following options:

* View current user profile and adjust their settings, if necessary
* Quickly change the password for the current user (will not open the user profile dialog)
* Switch server: if enabled in the application menu, this option allows quick switching between different servers with the same user account
* Log off and return to the initial Macula Console login interface

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FAwGf33mNqwz1S7yUXVJD%2Fimage.png?alt=media&#x26;token=142bad25-787d-404b-8e46-fd04d725ea1a" alt=""><figcaption></figcaption></figure>

The server switching option allows you to pre-configure a list of servers and then switch between them with a single click. This feature is useful for engineers who maintain multiple locations/customers, and for Macula Enterprise system engineers to quickly switch between Macula Enterprise and servers.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2Fkvf38DHlvu730IcJHO11%2Fimage.png?alt=media&#x26;token=f9baf011-676a-4e5c-9c76-64422d27ed24" alt=""><figcaption></figcaption></figure>

#### Sections

<div align="left"><figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FOzpMmg8rwUv84cVSbYaq%2Fimage.png?alt=media&#x26;token=34219249-9db1-41d6-ab69-39360f88abe1" alt=""><figcaption></figcaption></figure></div>

The bottom left panel allows you to switch between the four main Macula Console sections: Configuration, Events & Actions, Monitoring and Audit. The contents of the components panel on the left will change depending on the selected section. If the Macula Console windows is resized, the sections will be reduced to icons.

#### Components

The panel on the left will display the list of all available configuration components based on the selected section. As a result of license limitations, some of the items may be grayed out or unavailable. The list below shows maximum available items by category:

* Configuration: setup for the server components
  * Servers, Networks, External services, Failover clusters, Users, Devices, Channels, Recording, Maps, Layout templates, Layouts, Video walls, User buttons, Visual groups, Webpages, Live podcasts, Data sources, Data channels, Mail servers, GSM modems, MQTT clients, Reports, Access control, Quick access, Schedules, Organizations
* Events & Actions: configuration of automated scenarios
  * Rules, Events, Actions, Global events, Conditions, Counters, OPC, Indicators, Variables, Tags, Subjects
* Monitoring: live component status
  * Servers, Devices, Channels, Streams, Archive statistics, Storages, User sessions, Video walls, External services, Reports, Access control, OPC, Indicators
* Audit: log of server events and user actions
  * Servers, Users, and Problems

This document further describes the purpose and usage of each category in details.

<div align="left"><figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FltS3jBcJE3YKBL2j9Rhb%2Fimage.png?alt=media&#x26;token=3c4be7ff-82cf-47cb-8553-89ed30e28b81" alt=""><figcaption></figcaption></figure></div>

#### Item List

The main part of the Macula Console window displays items in the selected category depending on the search and/or item filters. You can select one or more items at once using the *Shift* or *CTRL* button.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FKD7So3N0ql4APZqjWUtg%2Fimage.png?alt=media&#x26;token=fd86762b-b111-404d-8da9-d0e0d55ba573" alt=""><figcaption></figcaption></figure>

Click any column title to use is as a sorting basis for the whole item list; the little arrow near the column title indicates that it is currently being used for arrangement - either ![](https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FELLGpCzK5QoDo1CvZPmi%2Fimage.png?alt=media\&token=2c8ad06e-1218-4906-982b-810902215038) ascending or ![](https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FUCBET7RDpi8LffD5UWZC%2Fimage.png?alt=media\&token=20b4f7f1-5ab8-40c5-9155-cdb97f55130d) descending. Right-click item list header for sorting options and column fit settings. The Best fit option will assign automatic size to all columns based on their name width. You can change column width simply by dragging their boundaries in the header row: these adjustments will be remembered and restored after you go to other sections, or close and re-open the Macula Console application.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FMmYxG98WW5nIKzkfiIlI%2Fimage.png?alt=media&#x26;token=db3f7805-3958-43de-9158-b104613ec4fa" alt=""><figcaption></figcaption></figure>

For each category, it is possible to **define the set of columns** to be displayed, and **freeze** one or several leftmost columns for convenient horizontal scrolling. To do this, click the grid icon ![](https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FvWQ1wXuCBYJVmvgFqfRT%2Fimage.png?alt=media\&token=5f035a12-8aa5-41e6-bc64-ec9332903931) in the upper right corner just below the application menu (the rightmost button in the upper panel). An additional window will pop up, allowing you to define the column layout.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FGa8uIU8v1j91YDm8qGt4%2Fimage.png?alt=media&#x26;token=af631ec0-f09c-4078-b821-5018af6c0f87" alt=""><figcaption></figcaption></figure>

One the left, you will see the currently displayed details. On the right, there will be all available columns.

* Use the *Add* and *Remove* buttons, or simply **double-click** items to move them from left to right and vice versa to select and deselect them.
* Use the *Up* and *Down* arrows to sort your selected columns on the left side.
* The grid button next to these arrows allows you to **freeze/unfreeze** the leftmost columns (i.e., those on top of the list). These will stick to the left window side as you scroll the table horizontally. You can freeze as many columns as you like, but only the ones on the far left side. For the columns in the middle of the list, this button will be grayed out (inactive).
* To discard all changes and **restore** the default (application original) list of columns, click the Reset button.

When done adjusting the table layout, click *OK*. Your new column configuration will appear: adjust the width of the newly appeared details, as desired.

#### Item Actions

<div align="left"><figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FB7X5CQWBVI9T5e8karkS%2Fimage.png?alt=media&#x26;token=bc870d40-7173-428a-95b0-2f0df8298471" alt="" width="362"><figcaption></figcaption></figure></div>

The panel above the item list displays the available actions, if applicable. Usually, the buttons here will allow you to create a new item, edit or delete existing ones, create or edit contiguous items, etc.

#### Item Filters

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FusCwWtAc5TNXusviBH4F%2Fimage.png?alt=media&#x26;token=4850e6c0-ddb0-415d-b36e-fbd5ae94bb2c" alt=""><figcaption></figcaption></figure>

The bottom panel contains miscellaneous item filters, such as: recently added and updated, corresponding groups etc. Click any of the filters to apply them; use the *X* button to reset and display the full item list.

#### Application Settings

To change Macula Console application settings, go to the main application menu in the upper-right-hand corner and choose *Settings*. The preferences here only affect the current Macula Console instance, no matter to which server it connects. The interface language setting also affects the Macula Monitor application installed on the same machine.

For your convenience, the settings have been grouped into several tabs.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FfnF7Ofb7QEImj5FlHF64%2Fimage.png?alt=media&#x26;token=14accc14-7c6c-4e82-8028-78f237993c45" alt=""><figcaption></figcaption></figure>

Here, it is possible to:

* change application **language** (by default, the language chosen during installation is used)
* show or hide software features restricted by license
* show or hide **object identifiers** (internal object IDs mostly necessary for addressing GSF Macula entities via HTTP API)
* show or hide Organizations
* enable quick server switching
* reset all *Don't show this again* checkboxes, which have been set so far

#### Monitoring This section contains settings related to the *Monitoring* section of Macula Console, namely:

* auto refresh interval in seconds for the *Monitoring* section dashboards (set 0 to disable autorefresh)
* show or hide monitoring warnings (critical errors will always be showed, only warning level info can be turned off)
* reset monitoring section warnings, which have been cancelled (set to be ignored) so far

See the Monitoring section documentation for more information about warnings.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FYwFkitMaNWrVI4Y0vxhf%2Fimage.png?alt=media&#x26;token=6142f380-2c34-41fc-8efe-932d12f0eea5" alt=""><figcaption></figcaption></figure>

#### Cybersecurity

The following setting is related to cybersecurity:

* show cybersecurity warnings

Cybersecurity warnings are different from those in the *Monitoring* section. Security warnings are displayed as shields  in the server and channel settings, indicating that the related setting does not match the defined security level. See below for more information about warnings.

#### Errors and Warnings

The Macula Console application will sometimes warn you about certain misconfigurations. For example, when the entered setting value is out of range, invalid, or incoherent with the system settings in some way, you will see a corresponding mark next to the preference.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2Frxpj8OR8cwFdhaDx0ZWR%2Fimage.png?alt=media&#x26;token=77454f5f-58a7-4115-94c6-3ab41169957a" alt=""><figcaption></figcaption></figure>

The following marks are used:

* security shield ![](https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2Fc1GHOHgemhKzQQfUuNvg%2Fimage.png?alt=media\&token=2ce1a7c0-4a61-458d-be95-5cf590e0613e) indicates that the setting value does not meet the current cybersecurity level preference
* number of issues ![](https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FCz3H2umyp0vInfz3atyT%2Fimage.png?alt=media\&token=c73dcf76-37b9-4a41-b53c-41221c494fe0) shows how many warnings (orange) or errors (red) are in the current category
* an X icon ![](https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FwgCZGeytxx0n2LKt7qv9%2Fimage.png?alt=media\&token=d0a1725b-a066-4e5f-94a9-b08b90aca910) is used to mark a completely invalid value (e.g., the field cannot be empty)
* other kinds of red or orange marks on top of the item icons, or text color

<div align="left"><figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FFSaY9VB3mq4t1VVAY8jw%2Fimage.png?alt=media&#x26;token=aad2cd1b-eb2f-4609-962b-017065b31f3a" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FxJriD4Pj8eJHqcOorM9F%2Fimage.png?alt=media&#x26;token=83a1ac36-864a-4dfa-a238-11ebb47d32b4" alt=""><figcaption></figcaption></figure>
