4 4 3 Beefalo:SEP sesam Web UI

From SEPsesam
Revision as of 15:53, 17 December 2019 by Sta (talk | contribs) (Minor correction.)
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

Up to v. 4.4.3 Beefalo V2, SEP sesam allows you to handily check the state of SEP sesam Servers online by using its web dashboard. From 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 dashboard and the restore assistant. It enables you to handily check a status overview (data store status, client status, next events, etc.), access SEP sesam Dashboard, monitor SEP sesam operations (backups, restores, etc.), check logs and reports, and access the restore assistant. The Web UI supports recent versions of Chrome, Firefox, Edge, and Safari browsers.

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 configure that this page is not shown automatically: 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

New SEP sesam Web UI provides efficient menu on the left, which includes the following options, described in the sections below: Status, Dashboard, Monitoring, System logs, Reports, and Restore Assistant. You can also check the latest Release notes and new SEP CAPS solution. You can collapse or expand the menu by clicking on two arrows on the top.

Web UI menu.jpg

Notifications, help, language & account

In the upper right corner, the notifications, help, language, and account menus are available. This menu is always present and enables you to review notifications, access online help, choose or change the display language, and modify Web UI settings.

Web UI other menus.jpg

Notifications
SEP sesam Server sends different types of messages – notifications. They are intended to notify a user of important events and announcements, such as information on latest patches, license violations, non-configured interfaces, as well as announcements of a new release or alerts about issues and errors that are sent via RSS feeds.
Web UI notifications.jpg


A notification's status can be open or acknowledged. Notification remains open until being acknowledged through the notification center in the GUI. This means that you can check all messages displayed in the dashboard, but you cannot change their state. For this, you have to use SEP sesam GUI -> menu bar -> Window -> Show Notification Center. For details, see Notification Center.
Web UI notifications-details.jpg


Help
The menu Help provides shortcuts to different types of user assistance:
Web UI Help
  • Dashboard provides a description of all dashboard reports and functions.
  • Restore Assistant provides a description of online restore assistant functions.
  • Sesam REST API documentation is available to provide access to the SEP sesam functions and services as a third-party software.
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 recovery in specific environments.
  • SEP Support leads you to the SEP Support Portal, where you can select different support options.
Web UI help.jpg


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


Account
In the Account menu, you can log out from the Web UI and modify different 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

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, including days, weeks, months, and years. Your Web UI is updated every time you log in and reloads data every few seconds.

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

Web UI calendar.jpg

Common navigation options

Generally, the Web UI provides navigation through its reports with the following common items:

  • 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).
  • show/hide report (first button), refresh (second button), open help wiki (third button), collapse widget and show dashboard (fourth button): use the buttons to hide your reports, refresh them, open SEP sesam wiki documentation page, or collapse a widget and open Web UI dashboard.
  • Common options.jpg
  • automatic refresh: use the refresh button to refresh the window immediately or set time interval to refresh the window automatically (e.g., every 30 seconds).
  • Web UI automatic refresh.jpg

Status

The Status is now the default start page of the SEP sesam Web UI. The menu provides a status overview of your jobs, clients, data stores, etc. You can define time range for your reports and refresh your reports.

Clickable items in the tables open related Monitoring window, e.g., clicking Backups in the Job status table, opens Backups window under the Monitoring, where you can check the details of all performed backups, see Monitoring section. By clicking the info icon (i), you can check the next events details (start, priority, etc.), or SEP sesam Server details (license details, available service packs, etc).

Status overview consists of the following reports:

  • Job status: Displays the status of all jobs (backups, restores, migrations, and replications). You can also check only active jobs.
  • Web UI job status.jpg
  • Data stores: Displays the status of your data stores and the data stores with highest utilization ratio.
  • Web UI data stores.jpg
  • Next events: Displays the details about the next events, e.g., start, event type, priority, schedule, etc.
  • Web UI next events.jpg
  • Clients: Displays a number of all, updateable, inaccessible, and disabled clients.
  • Web UI clients.jpg
  • Server: Displays the details about SEP sesam Server. By clicking the info icon shows its properties, configuration file sm_ini, process log, license details, and available updates.
  • Web UI server details.jpg

Dashboard

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

The dashboard contains the following reports:

Application based backup state

Application-based report provides an overview of all backups sorted by applications which were backed up during a given time period. Each bar represents the results of one sesam backup day, depending on the newday event. The information includes: the number of successful application backups, the number of failed application backups (error), the number of application backups that completed with warning and the number of cancelled application 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 also 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, the number of failed backups (error), the number of backups that completed with warning and the number of 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's state, click the state(s) which you want to exclude from 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 also 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 has been 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 every client's contribution to the capacity usage.

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 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 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 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, the number of failed restores (error), the number of restores that completed with warning and the number of cancelled 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's state, click the state(s) 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 has been restored during a given time period in the form of a line chart. To filter the results by client or by tasks on 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 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 unwanted tasks in the list/legend below the graph.
Dashboard total data size rst client tasks Beefalo V2.jpg

Monitoring

With v. 4.4.3 Beefalo V2, SEP sesam introduces improved monitoring, which is 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 check 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 clients, states (active, successful, with warning, etc.), backup levels (FULL, INCR, DIFF, COPY), and tasks (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 popup with more details.

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 offers 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 which enables you to restore savesets online is now also available from SEP sesam Web UI. It gives you ability to restore and recover files, virtual machines and Kopano emails online, if you have been granted appropriate permissions. Note that Restore Assistant options differs depending on the selected UI mode (Basic or Advanced). For details, see Restore Assistant.