Upgrade Information

The following topics provide important information you need to know the before an Oracle® Communications Security Shield upgrade. For some releases, you might need to perform certain tasks before the upgrade. Only the releases listed below require providing you with upgrade documentation.

Upgrade Information for the 22.0.0.0.0 Release

Oracle recommends that you review the following information about upgrades before using Oracle® Communications Security Shield (OCSS).

Save Custom Analytics Reports Before the Upgrade

When Oracle upgrades OCSS, the process may affect analytics reports stored in the OCSS folder in certain circumstances. The OCSS folder is the folder where OCSS automatically keeps the default analytics reports and initially any that you create. Under certain circumstances during an upgrade, OCSS overwrites the default reports and deletes any other reports in the OCCS folder.

You must take steps before the upgrade to preserve any reports that you want after the upgrade by moving them out of the OCSS folder. See "Save Analytics Reports Before an Upgrade" in the User's Guide.

Edit the Cloud Communication Service Configuration (CCS) File After the Upgrade

Existing OCSS customers must edit the CCS configuration file for the 22.0.0.0.0 release.
  1. In the CCS configuration file /opt/oracle/ccs/cfg/cfg.json, edit the value for the Client-Session-Pool parameter to a new value of 15.
    Client-Session-Pool: 15
  2. Execute the script /opt/oracle/ccs/perl/deactivate.pl. You must enter “y” to confirm and proceed.
  3. Execute the script /opt/oracle/ccs/perl/activate.pl. You must enter “y” to confirm proceed.

Note:

New OCSS customers do not need to perform this update.

Reload the Web GUI Browser Page After the Upgrade

After an OCSS software upgrade, copies of the styles, javascript, and images stored in your web browser cache for the Web GUI will be out of sync with what is on the web server for the new release. You must reload the browser you use for the OCSS Web GUI with a hard refresh to load the newly upgraded version.
  • Google Chrome, Mozilla Firefox, and Microsoft Edge—Hold the Shift key and click the Reload button next to the address bar. When you hold Shift and click Reload , the browser fully reloads the OCSS Web GUI with all of the latest HTML, images, styles, JavaScript code, and so on from the web server and re-displays the OCSS Web GUI.

    Note:

    If you click only Reload, the browser will load the HTML but not the images, styles, JavaScript code, and so on that you need to use the OCSSC Web GUI.

Upgrade Information for the 21.3.0.0.0 Release

Oracle recommends that you review the following information about upgrades before using Oracle® Communications Security Shield (OCSS).

Before the Oracle Communications Security Shield Cloud Service (OCSSC) 21.3.0.0.0 upgrade, you must modify the Cloud Communication Service configuration.
In the following procedure the Trans-Limit parameter sets the lifetime of an HTTP session, based on the number of messages sent. The Client-Session-Pool parameter sets the maximum number of simultaneous HTTP sessions to OCSS. Use only the values shown in the procedure.
  1. Edit the CCS configuration file, /opt/oracle/ccs/cfg/cfg.json, as follows:
    • Set the value for the Trans-Limit configuration parameter to 1000.
      Trans-Limit: 1000
    • Set the value for the Client-Session-Pool configuration parameter to 10.
      Client-Session-Pool: 10
  2. Execute the /opt/oracle/ccs/perl/deactivate.pl script and confirm by entering “y” to proceed.
  3. Execute the /opt/oracle/ccs/perl/activate.pl script and confirm by entering “y” to proceed.
Next Steps
  • Upgrade to 21.3.0.0.0