Customizing Auto-Update Settings

Knowledge Cloud (KC) manages both the framework components and the platform resources and allows NetBrain Workstation to automatically upgrade a patch or minor release. Besides replacing the files, the auto-upgrade process may restart services, execute the database upgrading, check the system health and roll back the release if the update fails.

Platform resources can be downloaded and installed automatically since NetBrain Workstation will be connected to KC through License Server. And for Framework resources, the software update package must be downloaded from NetBrain Customer Portal, manually uploaded into the system and then system updates need to be scheduled accordingly.

NetBrain Workstation Auto Upgrade flow consists of the following steps:

Note: Only user with System Management permissions can perform the following actions.

Tip: You can refer to the List of Resources to view which types of platform resources can be auto updated and downloaded via KC.

1.Check the Latest Version

2.Download Package from NetBrain Customer Portal

3.Upload Package to NetBrain Workstation

4.Schedule Update

5.View Update Status

6.View Update History

Check the Latest Version

Follow the steps below to check the available releases from NetBrain:

Note: The following steps only apply to the online auto upgrade procedures.

1.Log in to the System Management page.

2.In the System Management page, click the start menu > System Update.

3.By default, the Automatically check the latest version check box is enabled. You can click Check Update Now to see if there is a new version available.

Note: After the check box Automatically check the latest version is enabled, users with the 'system management' privilege will receive auto notification via email when a new version becomes available.

Note: The Web API Server is required to have internet access with NetBrain public License Server in order to perform the function of Automatically check the latest version and Check Update Now.

Note: In order to download and install platform resources automatically, you need to enable the Automatically check the latest version check box, as well as the Download and Install Platform Resources Automatically check box.

4.When this check is enabled, NetBrain Workstation will check whether a minor release, a patch, a customized built-in, a customized resource or common platform resource updates have been published since the last time check (either auto or manual check). The latest available version will be displayed with the release note.

5.If the respective release or patch is available, after reviewing the Release Note, click Get Latest Version to Download Package from NetBrain Customer Portal.

Download Package from NetBrain Customer Portal

Follow the steps below to download the system upgrade package from NetBrain Customer Portal:

1.Log into the NetBrain Customer Portal with your username and password.

Note: After clicking Get Latest Version in NetBrain Workstation, you will be redirected to the NetBrain Customer Portal. The portal account credentials are required by the web browser to grant access to the NetBrain Customer Portal.

2.Confirm the required info and click Generate Package.

Tip: Required info includes the License ID, Framework Version, Common Repo Version, Customized Built-in Resource Repo, Customized Resource Repo.

Tip: If you don’t want to download framework components, enable the Exclude Framework Patch check box.

3.Click Resource Package Link to download the package to your local drive.

4.Keep note of the password for next step- Upload Package to NetBrain Workstation.

Upload Package to NetBrain Workstation

Follow the steps below to upload the system upgrade package to NetBrain Workstation:

1.Log in to the System Management page.

2.In the System Management page, click the start menu> System Update.

3.Click Upload Latest Version.

4.Click Browse and select the system upgrade package (.zip file).

5.Enter the password and click Upload.

Tip: With the Discard Uploaded Version button, you can discard the previous uploaded update package and delete the system update task before the scheduled task is executed.

Schedule Update

Follow the steps below to schedule the system update:

1.Log in to the System Management page.

2.In the System Management page, click the start menu> System Update.

3.Click Schedule.

4.Review the license agreement, select the I have read the subscription EULA check box and click I ACCEPT.

5.(Optional) Check the Enable Test Plan checkbox.

Tip: You can leave the Enable Test Plan checkbox unchecked to skip the test plan.

Note: Only user with domain and tenant access will be granted permission to run the test plan.

 

1)Click Select and specify the desired Tenant/Domain to perform Domain Health Check.

Note: If there are more than one tenant or domain, step 1) must be completed before proceeding to step 2).

Note: If there is only one tenant and domain, the Initial Tenant will be automatically selected and you can directly proceed to step 2).

2)Click Auto Test Group to specify the devices for Data Accuracy Test.

Tip: The devices in the Auto Test Group are automatically selected according to the device type discovered by the system. You can also manually edit or delete any devices to suit your specific needs.

3)Click Auto Test Application Folder to specify the application for Data Accuracy Test.

Note: The last used Application Paths (up to 5 paths) will be automatically copied to the Auto Test Application Folder. You can also manually change the auto selected path in Application Manager.

6.Set up the schedule to start the system update.

Tip: You can edit or remove the system update once it is scheduled.

7.Click Submit to apply the above settings.

Note: A confirmation message will prompt if the selected tenant/domain does not have application path, you can click Yes to dismiss the message and continue with the update process.

View Update Status

The possible status of auto update are as follows:

Stage of the Auto Update

Possible Status

Before the execution of Auto Update

Ready for schedule.

Ready for running.

During the execution of Auto Update

Running.

After the execution of Auto Update

The system is successfully updated to the new version.

The system is successfully updated to the latest version, but the user performs a manual rollback and the rollback succeeds.

The system is successfully updated to the latest version, but the user performs a manual rollback and the rollback fails.

The update fails, and the system is rolled back to the old version.  

The update fails at the beginning (due to insufficient disk space to perform auto-upgrade, unavailable component and etc.) and the roll back is not executed.

 

View Update History

Follow the steps below to view the update history:

1.Log in to the System Management page.

2.In the System Management page, click the start menu> System Update.

3.Click View Update History.

The update history only records the releases the system is scheduled to update with. The update history table provides the following information:

Update From: the release number from which the system is updated.

Update To: the release number to which the system is updated.

Update Time: when the system finished the update.

Executor: the person to schedule the update

Action: upgrade or user roll back.

Status: one of the status in View Update Status.

Release Note: the link of the release note.

Installation Log: the link of the installation log.

Test Report: the link of the test results.

 

The List of resources

The platform resources that can be auto updated and downloaded via KC:

Resource Name

Qapp

GDR Properties

Golden Baseline Dynamic Analysis Logic

Gapp

Tech Spec

Interface Type (Interface Name Translation)

Runbook Template

Media Type

Default Date View Template 

Data View Template

API Plugin

Object Tree Template

Parser Library

SPOG URL

NGSystem. Technology License Definition

Driver

Visual Space

Multi Source Mapping

Device Type

Vendor Model Table

Domain system settings

Device Icon & Picture

Global Python Scripts (Built-in)

Cloud type

Topology Link Type (IPv4, IPv6 etc.)

Variable Mapping & Global Variable

FIT (Feature Intent Template)

Generic Schema (Including Generic SSchema Icon)

Platform Plugin

Full CLI Command

CLI Command Template

Beta Driver

PV File

Open Driver

/

/