Classic Global System Updates

The System Updates page allows you to update the software on your classic Global Manager system and "push" system updates to the stacks that are managed by the Global Manager system.

You must first download the update file to the local computer where you are running the browser. You can then upload the software update to the Global Manager system system through the user interface.

This section applies only to the classic Global Manager.

Use the following menu options to navigate the SL1 user interface:

To view a pop-out list of menu options, click the menu icon ().
To view a page containing all of the menu options, click the Advanced menu icon ().

Viewing the List of Updates

The System Updates page (System > Tools > Updates) displays the following about each update:

EM7 Version. Name and version number for the SL1 software update. EM7 was the previous name of the SL1 software.
OS Version. Name and number of the platform OS update.
Update Signature. Name of the entity that released the update and type of update. Usually "ScienceLogic Official Release".
Imported On. Date and time the software update was loaded onto the .
Imported By. Name of the ScienceLogic user who loaded the software update onto the .
Import Status. Status of the import process. Clicking the log icon () displays the log file associated with importing the selected software. Possible values are:

In Progress. Software is currently being imported by the .
Complete. Software has been imported successfully.
Failed. Software import has failed due to an unexpected condition. Contact ScienceLogic Support for assistance.
Missing Base. The cannot import this software until another software package has been imported. The dependency is for compression purposes. Check the log for a message stating which software package needs to be imported.

Staging Status. Status of the staging process. Clicking the log icon () displays the log file associated with staging the selected software. Possible values are:

--. No staging request is active and software has not been staged on any SL1 appliances.
Scheduled. The is aware of the staging request and is preparing for staging.
In Progress. Staging is in progress but has not completed.
Complete. Staging has completed, and all appliances are ready to deploy the software.
Incomplete. Staging has completed, and one or more appliances are ready to deploy the software.
Canceled. User manually canceled the staging process.
Outdated. The current update is not the latest or has already been installed.
Failed. An unexpected error occurred in the staging process. Contact ScienceLogic Support.

NOTE: If you did not select Auto Stage during import, the Staging Status column will include an asterisk (*) until you manually stage the update.

Preupgrade Status. You can run the pre-upgrade check after importing and staging an update but before deploying the update. The pre-upgrade check will ensure that all criteria are met before deploying.

If you want to run the pre-upgrade check, select the purple checkmark for the selected row.
The possible values in this field are In Progress or Complete.
Clicking on the magnifying-glass icon () in this column displays the output of the pre-upgrade check.
If a pre-upgrade criterion fails, the Deploy button will be disabled for the selected row.
If an appliance fails the pre-upgrade criteria, you can view the output from the system status script for each failed appliance. Go to the Appliance Manager page (System > Settings > Appliances), find the appliance that failed, and click on the magnifying-glass icon ().
For details see the section on the Pre-Upgrade Check .

Deployment Status. Specifies the current deployment state. Clicking the log icon () displays the log file associated with deployment. Possible values are:

--. No deployment request is active, and software has not been deployed on any SL1 appliances.
Scheduled. The is aware of the deployment request and is preparing for deployment.
In Progress. Deployment is in progress but has not completed.
Complete. Deployment has completed, and all appliances are updated.
Incomplete. Deployment has completed, and one or more appliances are updated.
Canceled. User manually canceled the deployment.
Outdated. The current update is not the latest or has already been installed.
Failed. An unexpected error occurred in the deployment process. Contact ScienceLogic Support.

Deployment Status Date. Specifies the date and time the software update was last deployed.

TIP: To sort the list of update files, click on a column heading. The list will be sorted by the column value, in ascending order. To sort by descending order, click the column heading again. The Deployed Status Date column sorts by descending order on the first click; to sort by ascending order, click the column heading again.

Staging Status.This field does not apply to Global Manager systems. On Global Manager systems, the action performed in the System Updates page affect the Global Manager system only. You must manually push updates to the stacks.

Deployment. Specifies the current deployment state. Possible values are:

Full. Software was fully deployed to all ScienceLogic appliances.

Partial. Software was deployed to some but not all ScienceLogic appliances.
Outdated. Software is not the latest version. A later version has been deployed.
--. Software has not been deployed on any ScienceLogic appliances.

Deployment Status. Most recent activity during deployment of this software. Clicking on the log icon displays the log file associated with deploying the selected software. Possible values are:

Deployed. Software has been successfully deployed to .

NOTE: If you have added one or more new to your system since last deployment, you could see the status "Deployed" even though you have not yet deployed the software to the new ScienceLogic appliances.

New/Unscheduled. Software has not yet been deployed to via the System Updates page. However, if the software in question is the base installation, this status is displayed.
Scheduled. The update is scheduled for future deployment.
Deploy Failed. The most recent attempt to deploy software has failed.
Validation Failed. The most recent time that the software has failed pre-deployment validation. This is usually because the Database Server and the other ScienceLogic appliances are momentarily out-of-synch. Try waiting a few minutes and attempt the deployment again.
Preparing, In Progress, Validating, Deploying. Deployment is active. The status specifies the current phase of deployment.

Deployment Status Date. Specifies the date and time the software update was last deployed.

Downloading Patches and Updates

Before you can load a patch or update onto your instance of the , you must first download the patch or update to your local computer.

The following steps do not affect the performance of the SL1 system. ScienceLogic recommends that you perform these steps at least three days before upgrading.

To download the patch or update:

Log in to https://support.sciencelogic.com. Use your ScienceLogic customer account and password to access this site.
From the Product Downloads menu, select Platform. The Platform Downloads page appears.
Find the release you are interested in and click its name. The Release Version page appears.
Click the specific link for a release, if needed.
Click the link for the release image or release patch you want to download, and click the Download File button. The file is then downloaded to your local computer.

Loading Updates on to the Global Manager System

To import a product update on to your :

In the , go to the System Updates page (System > Tools > Updates).
In the System Updates page, click the Import button.
In the Import a new update modal page, browse to the product update file and select it.

If you select the Auto Stage button, the will begin staging as soon as the import is completed.
If you do not select the Auto Stage button, you must click the staging button() after import is completed. You can do so at any time after import has completed.
For more information on automatic staging and manual staging, see the section on Staging.

Click the Import button.
In the System Updates page, the Import Status column can have one of the following statuses:

In Progress. Software is currently being imported by the .
Complete. Software has been imported successfully.
Failed. Software import has failed due to an unexpected condition. Contact ScienceLogic Support for assistance.
Missing Base. The cannot import this software until another software package has been imported. The dependency is for compression purposes. Check the log for a message stating which software package needs to be imported.

The update file or patch file is imported to and appears in the System Updates page.

NOTE: For details on the import process, go to the System Updates page, find the entry for the software you are interested in, go to its Import Status column, and click the log icon ().

Selecting the Installation Mode

The Installation mode menu in the upper right determines the updates and options that appear in the EM7 Releases pane and the ScienceLogic OS panel. The choices are:

Upgrade Only. When you select this option, the Deploy Patch Now icon () and the Schedule Patch Deployment icon () appear only for the latest patches and only if the latest patch has not yet been deployed.
Upgrade or downgrade. When you select this option, the Deploy Patch Now icon () and the Schedule Patch Deployment icon () appear for all patches except the latest patch that has been deployed.
Upgrade, downgrade, or reinstall. When you select this option, the Deploy Patch Now icon () and the Schedule Patch Deployment icon () appear for all patches.

will allow you to install a previous update. Although allowed, be forewarned that reverting to an older version of SL1 can make irreversible changes to internal data structures and introduce instability and problems that are difficult to diagnose. You should apply previous updates only with the explicit advice of ScienceLogic Support.

Installing Updates on the Global Manager System

When you deploy an update, the update is installed on all nodes or appliances that have already been staged.

When you deploy an update, checks to ensure that you have already deployed all required updates. If you have not, will generate an error message specifying the updates you must deploy before continuing with the current update.

During deployment, the Deployment Status column on the System Updates page can have one of the following statuses:

--. No deployment request is active, and software has not been deployed on any SL1 appliances.
Scheduled. The is aware of the deployment request and is preparing for deployment.
In Progress. Deployment is in progress but has not completed.
Complete. Deployment has completed, and all appliances are updated.
Incomplete. Deployment has completed, and one or more, but not all, appliances are updated.
Canceled. User manually canceled the deployment.
Outdated. The current update is not the latest or has already been installed.
Failed. An unexpected error occurred in the deployment process. Contact ScienceLogic Support.

To deploy a software update on your nodes or appliances:

Make sure that you have imported and staged the update file.
Go to the System Updates page (System > Tools > Updates).
In the System Updates page, find the software update you want to deploy. Click the lightning bolt icon () to deploy the software. If is still staging the patch when you click the lightning-bolt icon (), SL1 will wait until staging has completed before deploying the updates to each ScienceLogic appliance.
The software update will be deployed to all appliances in your SL1 system that have already been staged. If one or more appliances in your SL1 system have been successfully staged, will deploy the update to those appliances.

For details on the deployment process, go to the System Updates page, find the entry for the software you are interested in, go to its Deployment Status column, and click the log icon ().

Scheduling Updates

After you have loaded an update or patch on to the , you can either immediately install the patch or schedule it to be installed. From the System Updates page, you can schedule a software update to be installed on your appliance.

You can also view and manage all scheduled processes from the Schedule Manager page (Registry > Schedules > Schedule Manager). For more information, see the section on Managing Scheduled Tasks.

To schedule a software update to be installed on your SL1 system:

Make sure that you have imported the updated software file.
Go to the System Updates page (System > Tools > Updates).

In the System Updates page, find the software update you want to install. Click its calendar icon (). The System Patch Schedule modal page appears:

In the System Patch Schedule modal page, enter the date and time at which you want SL1 to automatically install the software update and then click the Schedule button.

Viewing the Log Files for Updates

From the System Updates page, you can view a log file that displays the history of the software update. To view this log file:

Go to the System Updates page (System > Tools > Updates).
In the System Updates page, find the software update for which you want to view the log files. Go to its Import Status column, Staging Status column, or Deployment Status column and click the log icon ().
The appropriate log page appears. In this modal page, each log entry displays:

Information about the status of the software update and its related actions.
For each action, the name and IP address of the appliance where the action occurred
The date and time each action occurred.

Configuring Update Timeouts in Distributed Systems

In a distributed system, two timeout settings apply to the update process:

The Time Factor setting for the EM7 Core: System Updater process, displayed in the Process Manager page (System > Settings > Admin Processes), defines the timeout for the process that applies the update to each appliance.
In the silo.conf file, the patcher_wait_timeout setting defines how long the Database Server will wait for all other appliances to complete the update process. If the patcher_wait_timeout setting is not defined in silo.conf, the default value is 300 seconds (5 minutes).

NOTE: For help configuring these settings, please contact ScienceLogic Support.

Installing Updates on Stacks

You can use the Global Manager system to install updates on one or more stacks. To do this:

Go to the System Updates page (System > Tools > Updates).
Find the update you want to load to one or more stacks. Click its globe icon ().

The Global Manager - EM7 System Updates page appears.

The Global Manager - EM7 System Updates page displays the following three panes:

GM System Updates Details. Displays details about the system update you selected in step #2.
Stacks Needing EM7 System Updates. Displays the list of stacks where the system update has not been installed.
Stacks with EM7 Systems Deployed. Displays the list of stacks where the system update has already been installed.

To install a system update to one or more stacks, go to the pane Stacks Needing EM7 System Updates and select the checkbox for each stack on which you want to install the update.
If the Stack Status column displays Need to Upload, click the Upload button.
If the Stack Status column displays Need to Register, click the Register button.
If the Stack Status column displays Ready to Deploy, click the Deploy button.