4 4 3 Beefalo:SEP sesam Web UI

From SEPsesam
Revision as of 17:23, 18 December 2019 by Sta (talk | contribs) (Corrected screenshots.)
Draft.png WORK IN PROGRESS
This is a draft document for the SEP sesam upcoming 4.4.3 Beefalo V2 release. Note that the article is in the initial stage and may be updated, replaced or deleted at any time. It is inappropriate to use this document as reference material as it is a work in progress and should be treated as such.
Other languages:

Template:Copyright SEP AG en

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3 Beefalo V2. For previous documentation version(s), check Documentation archive.


Overview

As of 4.4.3 Beefalo V2, SEP sesam web Dashboard has been completely redesigned to provide a more detailed overview and improved monitoring of the SEP sesam environment.

New SEP sesam web UI is a modern web client with several components, including the web dashboard and the restore assistant. It enables you to handily check status (for data store, client, next events, etc.), monitor SEP sesam operations (backups, restores, etc.), access check logs and reports, and perform online restores by using the restore assistant. The web UI supports recent versions of the major web browsers: Google Chrome, Firefox, Edge, and Safari.

Web UI (dashboard) access

You can access the web UI by typing the following information in the browser address bar:
http://[servername]:11401/sep/ui
or
https://[servername]:11401/sep/ui.

Example: On the SEP sesam Server the following 'localhost' link will open the web UI: http://localhost:11401/sep/ui

Information sign.png Note
If you cannot access the dashboard, check the authentication settings. For details, see About Authentication and Authorization.

The dashboard (web UI) is also available in the GUI from menu bar -> Activities -> Dashboard, from Main Selection -> Monitoring -> Dashboard, or by clicking the dashboard icon in the toolbar.

SEP Tip.png Tip
When running the SEP sesam GUI as an administrator, the new SEP sesam web UI landing page opens by default (with access to the web UI, links to documentation, etc). You can prevent it from automatically opening when you start the web UI: in the SEP sesam GUI -> menu bar -> Configuration -> Defaults -> General tab, deselect the checkbox Show SEP sesam web client landing page on startup.

Navigating web UI

The new SEP sesam web UI menu allows you to navigate directly to a specific view: Status, Dashboard, Monitoring, System logs, Reports, and Restore Assistant. You can easily check the latest Release notes and get information on SEP CAPS solution. You can collapse or expand the navigation menu by clicking two arrows at the top.

Web UI menu.jpg

Notifications, help, language & account

There are a few icons located in the upper right corner: Notifications, Help, Language, and Account. These icons are always present and enable you to quickly review notifications, access online help, choose or change the display language, and modify web UI settings (located under Account).

Web UI other menus.jpg

Notifications
SEP sesam Server sends different types of messages – notifications. They are intended to notify users when there are important messages they should know about, such as information on the latest available issues and patches (sent via RSS feeds), information about license violations and non-configured interfaces, new release announcements, etc.
Web UI notifications.jpg


The notification status can be open or acknowledged. The notification remains open until being acknowledged throught the notification center in GUI. You can check all listed messages, but you cannot change their state in the web UI. (To change their state, use SEP sesam GUI -> menu bar -> Window -> Show Notification Center. For details, see Notification Center).
Web UI notifications-details.jpg


Help
A Help icon provides access to different types of user assistance:
Web UI help
  • The Dashboard link leads to description of all dashboard reports and functions.
  • The Restore Assistant link provides a description of online restore assistant functions.
  • The Sesam REST API reference guide provides information on SEP sesam functions and services.
SEP sesam Help
  • SEP sesam Wiki (you are currently using it) is a set of wiki topics documenting SEP sesam concepts, procedures and tasks.
  • SEP sesam Forum is a place where you can find helpful solutions and workarounds from the SEP sesam users.
  • Video tutorials provide step-by-step tutorials and screencasts covering a wide range of topics, from basic configuration to setting up backup and performing recovery in different environments.
  • SEP Support leads you to the SEP Support Portal where several different support options are available.
Web UI help.jpg


Language
Enables switching between English and German language.
Web UI language.jpg


Account
Use the Account menu to log out from the web UI and modify various settings; you can enable text wrapping, select data prefix (binary or decimal), change date and time format, enable dashboard automatic refresh, and set visibility of the dashboard widgets. You can reset your settings to default at any time by clicking Reset to defaults button.
Web UI account.jpg


Time range selector

The time range selector allows you to specify the time span of the report. By selecting start and enddates from the calendar you can specify a custom date range. You are able to view reports for any time period specified (days, weeks, months, and years). SEP sesam web UI is updated every time you log in and reloads data every few seconds.

Note that the days are defined by sesam backup day which depends on the newday event.

Web UI calendar.jpg

Common buttons and menus

SEP sesam web UI features have the following buttons and menus available:

  • setting date range: Use the time range picker to display a report for a predefined time period, such as today (default), 2 days (2D), 3 days (3D) or 1 week (1W), or define your custom time range for the reports (see Time range selector).
  • toggle report (the first button), refresh (the second button), open help wiki (the third button), expand/collapse widget (the fourth button): Use these buttons to expand or collapse the reports, hide your reports, refresh them, open SEP sesam wiki documentation, or expand widget to view the item in a new window.
  • Common options.jpg
  • automatic refresh: use the refresh button to refresh the window immediately or set the time interval for automatic refresh (e.g., every 30 seconds).
  • Web UI automatic refresh.jpg

Status

Status is the default start page of the SEP sesam web UI. It provides a status overview of your jobs, data stores, events, clients, etc. You can define the time range for the status overview and set the refresh option for your status window.

Clickable links in the tables open the related item status in a new window, e.g., clicking Backups in the Job status table opens the Backups window, where you can check the details of all performed backups; for more information, see the Monitoring section.

Each table features a variety of clickable details, for example, the Job status table shows the number of failed, successful and total number of backups, migrations, replications, and restores for a given time range; clicking the displayed numbers opens a new window with the related details.

By clicking the info icon (i), you can check the next events details (start, priority, etc.) and the SEP sesam Server details (license, available software updates, etc).

Status overview consists of the following reports:

  • Job status: Displays the status of all jobs (backups, restores, migrations, and replications). Next to it is the Active jobs table that shows the number of currently running jobs.
  • Web UI job status corr.jpg
  • Data stores: The first table displays the status of your data stores and the second shows data stores with the highest utilization ratio.
  • Web UI data stores.jpg
  • Next events: Displays the details about the next events, such as the event start time, event type, related task and schedule, etc.
  • Web UI next events.jpg
  • Clients: Displays the total number of clients, followed by the numbers of updateable, inaccessible, and disabled clients.
  • Web UI clients.jpg
  • Server: Displays the details about SEP sesam Server (status, license, release, package and details about software update). Clicking the info icon shows its properties; you can examine and download the configuration file sm_ini and process log.
  • Web UI server details.jpg

Dashboard

SEP sesam web dashboard enables you to check if all your backups and restores have completed successfully and review statistics on the total size of backed up and restored data. You can define the time range for your reports and set the time interval for automatic refresh of the dashboard reports. You can also generate reports by clicking the Report button.

The dashboard contains the following reports:

Application based backup state

The application-based backup report provides an overview of all backups according to the application type that were performed during a given time period. The information includes: the number of successful backups, the number of failed backups (error), the number of backups that completed with warning, and the number of canceled backups. You can filter the results by time.

Dashboard applic bck status Beefalo.jpg

To filter the results by application, click the link View backup state by application over time (or click on table row). A report with backup graphs for each individual application is displayed. If you want to check the details only for a specific application, enter its name in the Application name field. Use the legend buttons above the graph – successful, with warning, cancelled, error, or use the Sort drop-down list to filter information that you want to be displayed in a graph. You can remove all filters by clicking the Remove filters button.

Dashboard applic bck status-by client Beefalo.jpg

Backup state over time

This report provides an overview of all backups that occurred during a given time period in the form of a bar graph. Each bar represents the results of one sesam backup day (depending on the newday event). The information includes: the number of successful backups, failed backups (error), backups that completed with warning and cancelled backups. Hovering over the report displays additional details.

Dashboard bck status Beefalo.jpg

You can filter the results by time, by state or by client.

  • To filter the results by job state, click the status which you want to exclude from the report.
  • Dashboard bck status filtered Beefalo.jpg
  • To filter the results by client, click the link View backup state by client. A report with backup graphs for each individual client is displayed. If you want to check the details only for a specific client, enter its name in the Filter by client name field.
    Use the legend buttons above the graph – successful, warning, cancelled, error, or use the Sort drop-down list to filter information that you want to be displayed in a graph. You can remove all filters by clicking the Remove filters button.
  • Dashboard bck status-by client Beefalo.jpg

Total backup data size over time

This report provides information on total and average data size that was backed up during a given time period, in the form of a line chart for all clients and tasks. The size chart can help administrators to analyze and predict growth trends for the SEP sesam environment. This report can also be useful for estimating the amount of data to be restored.

To filter the results by client or by tasks on the particular client, click the link View backup data size by client.

Dashboard total data size bck Beefalo V2.jpg

Clients

This graph shows the data size of backup jobs for all clients. You can filter the results by time by using the time range picker or selector, or by client. You can deselect a client from being displayed in the graph by clicking its name in the list/legend below the graph. Further breakdown by a specific client shows the backup data size for each backup day and enables the administrator to check contribution to the capacity usage for each client.

If you want to check the details only for a specific client, enter its name under Clients or use the client icon under the chart to select it. Note that each client is identified by a different color. By selecting a particular client, the tasks graph will show backup data size for each task for the selected client.
If you want to compare specific clients, click the Compare button and select the clients you want to compare. You can compare any number of clients by selecting them one by one from the Clients drop-down list. Alternatively, you can select the clients you want to compare by deselecting the unwanted clients in the list/legend below the graph.

Dashboard total data size bck client Beefalo V2.jpg

Tasks

This graph shows the backup level and size of backup jobs for the selected client. You can search the backup tasks, compare them and/or filter by backup event levels.

Regardless of your previous client selection, you can compare backup tasks of different clients by selecting Compare and then selecting the tasks from the Search tasks drop-down list one by one. When a task is selected, it is immediately shown in the graph. You can select any number of tasks to be compared by repeating the selection procedure. All selected tasks that match the specified filters (time range and optionally backup level) are shown in the Tasks graph. Alternatively, you can select the tasks you want to compare by deselecting the unwanted tasks in the list/legend below the graph.
Dashboard total data size bck client tasks Beefalo V2.jpg

Restore state over time

This report provides an overview of all restores that occurred during a given time period in the form of a bar graph. Each bar represents the results of one sesam backup day (depending on the newday event). The information includes: the number of successful restores, failed restores (error), restores that completed with warning canceled restores. Hovering over the report displays additional details.

You can filter the results by time, by state or by client.

  • To filter the results by job state, click the status which you want to exclude from report.
  • Dashboard rst status Beefalo.jpg
  • To filter the results by client, click the link View restore state by client. A report with restore graphs for each individual client is displayed. If you want to check the details only for a specific client, enter its name in the Client name field.
    Use the legend buttons above the graph – successful, warning, cancelled, error, or use the Sort by drop-down list to filter information that you want to be displayed in a graph.
  • Dashboard rst status-by client Beefalo.jpg

Total restore data size over time

This report provides information on total and average data size that was restored during a given time period in the form of a line chart. To filter the results by client or by tasks for the particular client, click the link View restore data size by client .

Dashboard total data size rst Beefalo V2.jpg

Clients

This graph displays the restore data size details for all clients. You can filter the results by time by using the time range picker or selector, or by client. You can deselect a client from being displayed in the graph by clicking its name in the list/legend below the graph.

If you want to check the details only for a specific client, enter its name under Clients or use the client icon under the chart to select it. Note that each client is identified by a different color. By selecting a particular client, the tasks graph will show restore data size for each task on the selected client.
If you want to compare specific clients, click the Compare button and select the clients you want to compare. You can compare any number of clients by selecting them one by one from the Clients drop-down list. Alternatively, you can select the clients you want to compare by deselecting the unwanted clients in the list/legend below the graph.
Dashboard total data size rst client Beefalo V2.jpg

Tasks

This graph shows the restore type and size of all restore jobs for the selected client. You can search the restore tasks, compare them and/or filter by restore event types (full or selective restore).

Regardless of your previous client selection, you can compare restore tasks of different clients by selecting Compare and then selecting the tasks from the Search tasks drop-down list one by one. When a task is selected, it is immediately shown in the graph. You can select any number of tasks to be compared by repeating the selection procedure. All selected tasks that match the specified filters (time range and optionally restore type) are shown in the Tasks graph. Alternatively, you can select the tasks you want to compare by deselecting the unwanted tasks in the list/legend below the graph.
Dashboard total data size rst client tasks Beefalo V2.jpg

Monitoring

With 4.4.3 Beefalo V2, SEP sesam introduces improved monitoring as part of the SEP sesam web UI. Now you can not only check the details of all events and the last backup state, but also get an overview of all active jobs, next events, and different states, e.g., data store status, backups, migrations, etc.

You can filter the results by client, state (active, successful, with warning, etc.), backup level (FULL, INCR, DIFF, COPY), and task (backups without active tasks, tasks without backups, etc.).

If you want more details on the tasks or events, click the message in the Message column to open a pop-up information window.

Web UI monitoring menu.jpg

Last backup state

This report shows the last run of each backup task that is configured on the server. The backup jobs are displayed in a table format with each row representing a specific backup task and its information: backup task name, last run status, start time of the last backup, start time of the last successful run, backup event level, start time of the last full backup, client name, interface, and SEP sesam message about the backup.

Clicking the arrow next to the backup task name displays task-related history: the status of all previous jobs for the selected task (in queue, active, successful, with warning, cancelled, error, without backups), backup level (COPY, FULL, DIFF, INCR), start and stop time, and data size. You can filter the results by tasks, by clients, by states and by backup levels. Filtering by tasks enables you to check selected backups with configured tasks or backups without configured tasks. You can also check which tasks have never been backed up by selecting tasks without backups.

Web UI last bck state Beefalo V2.jpg

Active jobs

This report shows all active jobs (backups, media events, migrations, etc.) on the server. The jobs are displayed in a table format with each row representing a specific job/event and its information: event type, object, start time of the active job, duration, task and client name, and SEP sesam message about the backup.

You can filter the results by tasks, by clients, by states, by event types and/or backup levels. You can also reset filters.

Monitoring active jobs.jpg

Next events

This report shows an overview of all scheduled events (backups, restores, migrations etc.) for the next couple of days, sorted by date & time in ascending order. The up-coming scheduled events are displayed in a table format with each row representing a specific event.

Clicking the arrow next to the event start time displays the event details. You can display only a specific events by enter its task name or event type in the search filed. You can also filter up-coming events by event types, or use individual filters in the column headers to filter the results by start time, task name, media pool, etc.

Monitoring next events.jpg

Data store status

The data store status provides information on configured data stores (path, Si3, HPE StoreOnce, HPE Cloud Bank, and NetApp snap stores) and their status, utilization, capacity, size of actual used (filled) space, free space, etc.

If the size of the actual used (filled) space is larger than the configured capacity on the data store (overflow of data store size), the utilization color is changed to red.

Clicking the arrow next to the data store name displays the data store details. You can use individual filters in the column headers to filter the results by data store name, type, capacity, etc.

Monitoring data store.jpg

To check utilization for each individual data store, click the link Show utilization by data store over time at the bottom right corner. A report with utilization for each individual data store is displayed.

You can use the time range picker to display a report for a predefined time period, e.g., 1 week (1W), or define your custom time range for the reports. You can filter the data stores by name or type.

The graph provides information on when the data store capacity, HWM and LWM (if relevant) values have changed, when (if) the data store ran out of space and if the purge was able to fix this problem. If the filled (blue) line is above the capacity (light blue)) line, you have to either change the EOL of some savesets in the data store and execute a purge, or you have to adjust the capacity. For details, see Data Store.

  • Use the time sliders (round icons on each side of the graph) to shorten or extend the time range of your timeline.
  • Use the legend buttons below the graph – filled, LWM, HWM, capacity to exclude the selected criteria to be displayed in a graph.

Monitoring data store individual.jpg

Job status reports

Under the Monitoring, you can now check the details of all jobs (All results), or specific jobs (Backups, Migrations, Replications, Restores, and Media actions). You can check a job event type, status, start time, duration, task name, etc.

You can filter the results by time by using the time range picker or selector. You can also filter the results by clients, by state, by event types and/or backup levels.

If you want more details on the job, click on the message in the Message column to open a popup with more details.

The following example shows the migrations details.

Monitoring migrations.jpg

System logs

SEP sesam creates different protocols or log files for each backup day. Now you can check different system logs in the SEP sesam web UI, i.e., state log, day log, error log, interface logs (alarm, disaster, notify), and message log. It is recommended to use the SEP sesam log files to detect operations that caused errors or malfunctions, for example, in case of a failed backup.

The System logs contains the following reports:

  • State log: Shows the status for each backup in chronological order, e.g., Backup completed successfully.
  • Day log: Shows a protocol for each backup day. Day log protocols are the first and most important starting point for problem analysis.
  • Error log: Shows critical errors that occurred during the backup day. It is the subset of the entire day log, but only error messages are recorded.
  • Alarm log: Shows different alarm messages for start, backup, etc., modules, e.g., Connection refused.
  • Disaster log: Shows the recovery procedure in the event of a disaster.
  • Notify log: Shows finished events, such as backup, restore, migration, etc.
  • Message log: Shows the details of the processes on the drives, e.g., Media has been dismounted.

You can download, wrap and refresh your logs.

The following example shows the message log.

Web UI logs.jpg

Reports

SEP sesam web UI provides various reports, e.g., jobs overview, backup storage, clients, etc. They can help you identify issues in your backup environment so they can be addressed before they could cause data loss or in any other way negatively impact business operations.

You can simply select the relevant report from the drop-down list at the top left corner.

Web UI reporting.jpg

You can filter the reports by time by using the time range picker or selector, or by date (sesam_date, start_time, or stop_time). You can also select between English or German language for your reports.

Jobs overview report

The job overview report is opened by default. It shows the status of your jobs, i.e., backup tasks, task groups, migrations, and replications.

Reporting jobs overview.jpg

Media-related reports

You can review the reports of available media, used media and media readability check. Reports show information of the media pool, media label, media status, barcode, library ID, etc.

Reporting media.jpg

Backup storage report

Shows the details of your backup storage, e.g., backup task, backup, status, saveset, pools, etc.

Reporting bck storage.jpg

Clients report

Shows the details of the client backup tasks, media pools and data size. Beside other filtering options, you can also filter the reports by clients or by locations.

Reporting clients.jpg

Failed jobs report

Shows an overview of failed jobs (backups, migrations, etc.) and other erroneous jobs. Clicking on the task or task group opens a new window with related main log. You can download, wrap and refresh your main log report.

Reporting failed job.jpg

License reports

You can check license reports for MSP Unit License and Volume FrontSide License. The MSP Unit License report shows an amount of clients within the location with the individual MSP Unit License (Standard, Enterprise and Enterprise Plus). The Volume FrontSide License shows the details on front side data volume size. Beside other filtering options, you can also filter license reports by locations.

Reporting license.jpg

Restore Assistant

The Restore Assistant enables you to restore and recover files, virtual machines, and Kopano emails online, if you have been granted appropriate permissions. The Restore Assistant options differ depending on the selected UI mode (Basic or Advanced). For details, see Restore Assistant.