Use the Online Update option to register for the online update service from the Customer Center. You can install updates automatically or manually on the Secure API Manager appliance. You must be connected to the internet to use this feature.
In a distributed environment, apply the patches to the components in the order that you would restart the components.
IMPORTANT:Ensure that you apply the updates to one appliance at a time. Ensure that the appliance is up and functioning before applying updates to the next appliance in your system.
Database Service
Analytics
Lifecycle Manager
API Gateway
You can install the updates by ensuring that the appliances have access to the internet to receive the patches or you can configure the appliances to receive off-line updates through another server.
WARNING:Service Pack 1.1.1 requires you to reset all of the appliances in your cluster due to a database schema change. This means any current configuration information or APIs are deleted from your system. For more information, see NetIQ Secure API Manager 1.1 Service Pack 1 Release Notes.
You must have the license key for Secure API Manager to activate the Update Channel. You obtain the license key from the Customer Center. If the key is not available, contact the Customer Center through an email from within the Customer Center.
If you have clustered the Secure API Manager appliance, you must log in to each appliance in the cluster and add the license key to each appliance to enable updates. You can schedule updates or manually perform updates on each appliance.
After you have registered the appliance, you can view a list of the needed updates, or view a list of installed updates. You can use manual or automatic options to update the appliance.
To register for the Online Update Service:
Log in to the appliance management console as the vaadmin user. In a distributed environment, log on to the Database Service first.
https://ip-address-or-dns-name-appliance:9443Click Online Update.
If the Registration dialog box does not open automatically, click the Register tab.
Specify the Service Type as Customer Center.
Specify the following information about the Customer Center account for this appliance:
Email address of the account in the Customer Center
Activation key (the same Full License key that you used to activate the product)
Allow data send (select any of the following):
Hardware Profile
Optional information
Click Register.
Wait while the appliance registers with the service.
Click OK to dismiss the confirmation.
(Conditional) In a distributed environment, log on to the next appliance and repeat Step 1 through Step 7.
To perform other actions after registration:
Update Now: Click Update Now to download and install the available updates.
WARNING:If the updates require a reboot of the appliance, ensure that you restart the Secure API Manager components in the proper order. Otherwise, the components will stop communicating with each other. For more information, see Restarting Secure API Manager.
Schedule: Configure the type of updates to download and whether to automatically agree to the licenses.
To schedule online updates:
Click the Schedule tab.
Select a schedule for download updates (Manual, Daily, Weekly, Monthly).
View Info: Click View Info to display a list of installed and downloaded software updates.
Refresh: Click Refresh to reload the status of updates on the appliance.
If you need to manage access to the internet and your corporate policy does not allow for the Secure API Manager appliances to have internet access, you can still provide updates to the appliance through a local Subscription Management Tool.
A Subscription Management Tool (SMT) is a feature provided in SUSE Linux Enterprise Server. SMT allows you to download the updates to a single SMT server in your network that must have an internet connection. All Secure API Manager appliances receive their updates from that server. For more information, see the Subscription Management Tool Guide. To obtain the proper credentials to use the SMT server, see Mirroring Credentials
in the Subscription Management Tool Guide.
You can disconnect the SMT server from the internet but we recommend that you connect the SMT server often to receive the operating system updates. Operating system updates occur daily. By using the SMT server you control when the updates are applied to the Secure API Manager appliance.
You must have the license key for Secure API Manager to activate the Update Channel. You obtain the license key from the Customer Center. If the key is not available, contact the Customer Center through an email from within the Customer Center.
If you have clustered the Secure API Manager appliance, you must log in to each appliance in the cluster and add the license key to each appliance to enable updates. You can schedule updates or manually perform updates on each appliance.
To register for the Online Update Service through the SMT:
Log in to the appliance management console as the vaadmin user. in a distributed environment start with the Database Service.
https://ip-address-or-dns-name-appliance:9443Click Online Update.
If the Registration dialog box does not open automatically, click the Register tab.
Select the Service Type as Local SMT.
Specify the following information for the SMT server:
Host name, such as smt.example.com
(Optional) URL for the SSL certificate that communicates with the SMT server
(Optional) Namespace path of the file or directory
Specify the following information about the Customer Center account for this appliance:
Email address of the account in the Customer Center
Activation key (the same Full License key that you used to activate the product)
Allow data send (select any of the following):
Hardware Profile
Optional information
Click Register.
Wait while the appliance registers with the service.
Click OK to dismiss the confirmation.
(Conditional) In a distributed environment, log on to the next appliance and repeat Step 1 through Step 8 for each appliance.
After you have registered the appliance, you can view a list of the needed updates, or view a list of installed updates. You can use manual or automatic options to update the appliance.
To perform other actions after registration:
Update Now: Click Update Now to download and install the updates from the RMT.
WARNING:If the updates require a reboot of the appliance, ensure that you restart the Secure API Manager components in the proper order. Otherwise, the components will stop communicating with each other. For more information, see Restarting Secure API Manager.
Schedule: Configure the type of updates to download and whether to automatically agree to the licenses.
To schedule online updates:
Click the Schedule tab.
Select a schedule for download updates (Manual, Daily, Weekly, Monthly).
View Info: Click View Info to display a list of installed and downloaded software updates.
Refresh: Click Refresh to reload the status of updates on the appliance.