Image Contents

Release Components

Licensing Information

Supported Tape Devices and Platforms

Upgrading to Oracle Secure Backup Release 18.1

Readme Information for Oracle Secure Backup 18.1

Image Contents

The image for each platform contains all necessary tools, documentation, and software to install and operate Oracle Secure Backup on the selected platform.

You can access the installation files from a downloaded file from the following product site:

https://edelivery.oracle.com

Release Components

The only product in this release is Oracle Secure Backup.

Licensing Information

Refer to Oracle Secure Backup Licensing Information for licensing terms.

Supported Tape Devices and Platforms

Supported platforms, web browsers, NAS devices, tape drives, and tape libraries are listed at the following URL:

http://www.oracle.com/technetwork/database/database-technologies/secure-backup/learnmore/index.html

Upgrading to Oracle Secure Backup Release 18.1

You can upgrade only Oracle Secure Backup 12.1.0.2, Oracle Secure Backup 12.1.0.3, or Oracle Secure Backup 12.2 to Oracle Secure Backup 18.1. If you are using an earlier version, then you must upgrade to Oracle Secure Backup 12.1.0.3 prior to upgrading to Oracle Secure Backup 18.1.

Oracle Secure Backup 18.1 is backward compatible with Oracle Secure Backup 12.2 and Oracle Secure Backup 12.1 clients only.

Oracle Secure Backup 18.1 supports the Oracle Secure Backup 12.2 and Oracle Secure Backup 12.1 features and is interoperable with their functionality.

All media servers must be at the Oracle Secure Backup 18.1 version level.

Access to any new commands and options introduced in Oracle Secure Backup 18.1 are not supported from a 12.2 client. The new commands must be accessed from an Oracle Secure Backup 18.1 host or via the Oracle Secure Backup Web Tool.

A database backup to a cloud storage device from an Oracle Secure Backup 12.2 client is not supported. That backup is restricted to Oracle Cloud Infrastructure Classic, disk, or tape.

The enhanced backup compression levels in Oracle Secure Backup 18.1 are not supported on an Oracle Secure Backup 12.1 client.

See Also:

Readme Information for Oracle Secure Backup 18.1

This information in this section applies only to Oracle Secure Backup 18.1.

This section contains the following topics:

New Features

This section lists the new features in Oracle Secure Backup 18.1.

  • Support for Oracle Cloud Infrastructure

    Oracle Secure Backup now supports backups to Oracle Cloud Infrastructure Object Storage and Archive Storage. Oracle Cloud storage is accessed and managed using Oracle Secure Backup cloud storage devices. All backup data is securely written to cloud storage devices by encrypting the backup data at the client host, with encryption keys being managed by the Oracle Secure Backup administrative server.

    A backup can be copied from Object Storage to Archive Storage. Copy instance jobs support copying from Oracle Cloud Infrastructure Classic to Oracle Cloud Infrastructure and from Oracle Cloud Infrastructure Object Storage Classic to Archive Storage.

  • Backup validation

    While creating or copying backup image instances, Oracle Secure Backup computes a checksum and then stores this value as part of the backup metadata. Validity of backup image instances can be verified by recomputing the checksum and comparing it with the stored checksum.

  • Simplified creation of Cloud wallets

    The installer is enhanced to create a Cloud wallet and eliminate the need for the multi-step process that is currently used to create the Cloud wallet. A clean install or an upgrade from Oracle Secure Backup 12.1 will create a cloud wallet.

Deprecated Functionalities in Oracle Secure Backup 18.1

This section lists the deprecated functionalities in Oracle Secure Backup 18.1.

The following commands are deprecated:

  • The opendoor command to open the import/export door of a tape library
  • The closedoor command to close the import/export door of a tape library
The following feature is deprecated:
  • Support for OSB 12.1 clients. If you are using Oracle Secure Backup v12.1 clients, upgrade it for any future Oracle Secure Backup release.

Bugs Fixed in Oracle Secure Backup 18.1 and 18.1.0.1

This section lists the bugs that have been fixed in Oracle Secure Backup 18.1.0.1.0.

Table 1-1 Oracle Secure Backup 18.1.0.1.0 Fixed Bugs

Bug Number Bug Description
25924596 WILDCARD SUPPORT FOR LISTING BACKUP IMAGES
25954115 STAGESCAN FAILS WITH ERROR NO DEFAULT OSB-DEFAULT-STAGE-RULE
26358423 ADD SEARCH FOR CLIENTS BY PARTIAL NAME (USING WILDCARD)
26358537 ADD WILDCARDING FOR SCHEDULING TO LIMIT SCROLLING-Fix the cases where --ignore case with wildcards was used.
26849852 Web tool form field labels need to be updated.
27519729 LSDEV AND LSJ TO INCLUDE ADDITIONAL USEFUL INFORMATION ON STAGING FEATURE
29177588 DISALLOW DATABASE BACKUPS FROM OSB 12.1.X.X CLIENTS TO CLOUD WITH APPROPRIATE ERROR MESSAGES.
29177977 OSB RESTORES OR CATALOG IMPORT OF SPANNED BACKUPS FAILS WHEN NETAPP MOVER SERVICE SIGNALS AN EOF AT THE END OF TAPE.
29402524 CHECKSUM: VALIDATE JOB FAILS FOR ARCHIVE CLOUD DEVICES.
29502640 ALLOW A CLOUD STORAGE DEVICE TO BE A SOURCE DEVICE FOR STAGING.
29534096 INSTANCES ON CLOUD STAGE DEVICE ARE NOT BEING PURGED.
29535531 RESETTING THE CHECKSUM FIELD VIA CHDEV COMMAND IS ALSO RESETTING THE STAGING FLAG.
29541133 CHDEV --RMSTAGERULE - WARNING MESSAGE MENTIONS DISK POOL WHEN CLOUD DEVICE IS ALSO VALID.
29559314 CAN'T UNCHECK THE "TODAY' BOX IN THE UI UNDER MANAGE->BACKUP IMAGES.
29764137 INSUFFICIENT MESSAGE IN BACKUP JOB STATUS AND TRANSCRIPT WHEN CLOUD DEVICE RUNS OUT OF SPACE.
30237159 LSDEV -L ERRORS OUT WHILE TRYING TO LIST THE 'NUMBER OF OBJECTS' AND 'BYTES USED' FOR CLOUD DEVICES WITH MESSAGE- SYSTEM RUNNING LOW ON RESOURCES.
30326595 CLOUD: CPINSTANCE FAILS WITH EOF WHEN SEGMENTSIZE = BLOCKSIZE.
30326597 CLOUD: THE COPY INSTANCE OF A BACKUP IN THE CLOUD TO A DISK POOL OR TAPE DRIVE FAILS TO IMPORT THE INDEX METADATA.
30569179 CLOUD: DO NOT USE LISTING CODE FOR RESTORE/COPY OR WAIT FOR RESTORE.
30755830 REDO WEB GUI BUTTONS USING CONSISTENT STYLE AND FONT.
30756818 ARCHIVE RESTORE/RESTORE WAIT AND COPY REPORT WARNING IF BACKUP SIZE MULTIPLE OF SEGMENT SZ.
30838341 Add support for IBM LTO8 drives.
30871390 WEB GUI INCORRECTLY REPORTS FILE SIZE ERROR WHEN CREATING AUTHENTICATION OBJECT.
30946279 WINDOWS.X64: Install fails on German Windows.
30984681 INDEX IMPORT FAILS DUE BAD POSITION DATA IN RAW FILE.
31065736 OSB RMAN BACKUP ON SOLARIS SEEMS TO LEAK SEMAPHORES
31069830 UPGRADE AN OSB ENV WITH A REAL ACSLS LIBRARY RESULTS IN SEGMENTATION FAULT ON OBSERVICED
31135260 COMPLETED BACKUP JOB STUCK IN STATUS RUNNING.
31181226 UI DOESN'T RESOLVE A WILDCARD IN "RESTORE BROWSING" TO ACTUAL PATH, CAUSING RESTORE FAILURE.
31224630 Upgrade OpenSSL to 1.1.1g.
31311075 SCHEDULER LOG FILES NOT BEING DELETED AS EXPECTED.
31516564 OSB LRG12 install tests failing on windows.x64 platform.
31567199 18.1.0.1.0 NEEDS TO ALLOW FOR UPGRADE FROM 18.1.0.0.0
31646723 CLOUD: OBTOOL SEGFAULT SEEN WITH STAGING OPTIONS TO MKDEV, CHDEV WHEN --RESTRICT NOT SPECIFIED IN DEFAULT STAGERULE.
31664356 IT SHOULD NOT BE NECESSARY TO INITIALIZE THE DEFAULT STAGE RULE TO ENABLE STAGING FOR A STAGING SOURCE CLOUD DEVICE.
31727057 Upgrade Apache to version 2.4.46
31897779 DELETED RMAN BACK INSTANCE ARE NOT PURGED FROM STAGING DEVICE.
31932228 CLOUDCOPY OF INSTANCE BETWEEN CLOUD DEVICES WITH DEVICES HAVING DIFFERENT SEGMENT SIZE, COPIED INSTANCE BECOMES NON-USABLE.
31961695 UPGRADE PHP TO VERSION 7.4.11
31979933 WEB TOOL MANAGE VOLUMES PAGE - EDIT, DUPLICATE, RECALL AND REMOVE FUNCTIONS DO NOT WORK
31983691 STAGING FROM OCI OBJECT TO ANOTHER OCI OBJECT RESULTS IN MISSING SEGMENT AND DATA LOSS
32004540 CLOUD: ENABLE CHECKSUM FOR CLOUD DEVICE BY DEFAULT

This section lists the bugs that have been fixed in Oracle Secure Backup 18.1.

Table 1-2 Oracle Secure Backup 18.1 Fixed Bugs

Bug Number Bug Description
20959238 THE INSTALLER SHOULD SUPPORT CANCELATION DURING THE INTERVIEW PROCESS.
22598562 PINGHOST -A HANGS IF A CLIENT'S OSB INSTANCE ISN'T RUNNING IN THE DOMAIN
23737644 --VERBOSE OPTION MISSING IN THE HELP OF MANAGEDEV
25056681 "OBTOOL PINGHOST -A" SHOULD INCLUDE AN OPTION TO OMIT "OUT OF SERVICE" CLIENTS
25267254 WINDOWS.X64: UNABLE TO SEND JOB SUMMARY REPORT EMAILS.
25428990 JOB IS FULLY FAILED EVEN A SINGLE SHARE FAILS TO BACKUP OUT OF 40
26040429 OBTOOL: DOUBLE FREE OR CORRUPTION
26382658 CLOUD/SEGMENTSIZE POLICY SHOULD SUPPORT VALUE+UNIT
26632651 INVALID COMPARISON IN FILE QIX_DIR.C
26721958 CLOUD : INITIAL CONNECTION RETRIES AFTER " COS__PUT_REQ: ERROR: CODE 0X97B172F4"
26939448 CLOUD : UNABLE TO RESTORE CATALOGED RMAN ENCRYPTED BACKUP FROM ANOTHER DOMAIN
26951443 "SERVICE OBSERVICED STATUS" NO LONGER WORKING IN OSB V12.1.0.3
27013774 CLOUD: CATALOG OF ARCHIVE CONTAINER TAKES VERY LONG TIME
27013962 CLOUD: CATALOGING OF ARCHIVE CONTAINER HUNG
27047826 CLOUD: COPYFROMSTAGE JOB FAILS IF STAGEPOOL MS DOES NOT HAVE CLOUD WALLET
27056269 CLOUDEV MKDEV CAN HANGS IF CAN'T CONNECT TO CLOUD/RMDEV HANGS AFTER THIS OCCURS
27080322 RENHOST REPORTS ERROR -HOST NOT FOUND,WHEN TRYING TO RENAME A HOST
27084048 PREVENT DELETING INSTANCES WITH STAGE-IN-PROGRESS FLAG SET IN NON-STAGING POOLS
27098874 STAGESCAN TRANSCRIPT AND LOG LEVEL DEBUG2 CAN INCORRECTLY REPORT DBNAME MISMATCH
27147453 COPYFROMSTAGE JOBS FAILS WITH SW TRANSIENT INSTANCE IF HW ENCRYPTION ENABLED.
27157413 TRANSCRIPT STATISTICS SHOWS COMPRESSION ENABLED FOR CONDITIONS ITS NOT APPLIED
27167094 CLOUD : CATALOGED RMAN ENCRYPTED BACKUP FAILS TO RESTORE
27176491 COMPRESSION VALUE RESET ON CHANGING THE HOST IP THROUGH CHHOST
27178808 OSB COMPRESSED BACKUP STATS SOMETIMES REPORT COMPRESSION RATIO AS 0% OR 100%
27247138 ADD SUPPORT FOR IBM ULTRIUM-TD8 & ULTRIUM-HH8 (IS GENERIC DRIVER OK TO USE?)
27266437 POOLMGR UNABLE TO DELETE- BROKEN PIPE CAUSES INSTANCE TO REMAIN IN DISKPOOL
27274359 WINDOW.X64 : INSTALL FAILURE DOES NOT ROLLBACK COMPLETELY.
27293087 STRESS: STAGESCAN INCORRECTLY SKIPS DB INSTANCES COMPARING INCORRECT DBNAME DBID
27298615 LSDEV -L TAKES A LONG TIME TO TIME OUT WHEN CLOUD DEVICES IN DOMAIN
27305905 ALLOW MATCHING ALL CONTENT-MANAGED MEDIA FAMILIES IN A STAGE RULE
27319951 OSB SUMMARY REPORT NOT SHOWING DATABASE NAME
27332751 FIX STAGESCAN TRANSCRIPT FOR DB WILDCARDS AND STAGESCAN NULL SCHEDULE.
27349654 STAGESCAN JOB TRANSCRIPT HAS POSITIVE ERROR COUNT WITH NO ERRORS LISTED
27402327 STAGE RULE VALIDATION CODE ALLOWS INVALID CONFIGURATIONS
27407710 RAW & CDF FILES NOT CONVERTED WHEN FILES SERVICE HALTS DUE TO INTERNAL ERROR
27408455 OSB WEB TOOL SHOULD SET "NOSNIFF" IN HEADERS
27422240 STRESS: LSPIECE SHOWS OBJECT NOT FOUND WARNING AND FAILS TO DISPLAY PIECE INFO
27422978 STRESS : PIECE ENTRY NOT CLEANED IF DB JOB FAILS DUE TO CLOUD CONNECTION ISSUE
27423152 STRESS : SAME IMAGES ARE PICKED UP BY MULTIPLE COPYFROMSTAGE JOB.
27509069 LSDEV -L FOR CLOUD DEVICE TAKES TOO LONG
27509126 CLOUD TRANSFER TIME OUT IS TOO LONG
27516678 MANAGEDEV OUTPUT SHOWS INCORRECT NAME FOR DISK POOL.
27516870 WEB TOOL - CAN'T EDIT DEFAULT STAGE RULE
27517592 SETTING CLOUD POLICY ALSO SETS CLOUD PROXY SERVER
27519729 LSDEV AND LSJ TO INCLUDE ADDITIONAL USEFUL INFORMATION ON STAGING FEATURE
27524283 CLOUD DEVICE BYTES USED IS CAPPED AT 2.0GB
27539723 REMOVE OBCM WALLET "--WPATH" OPTION FROM "OBCM USAGE".
27572808 WEB TOOL - CAN'T DELETE LAST STAGE RULE FROM A DEVICE
27586491 SCHEDULER REPEATEDLY CHECKS THE SAME DEVICES
27608018 OBPOOLMGR MISSING FROM MANGE DAEMONS PAGE
27655451 OSB JOB HUNG NOT REPORTING FAILURE.
27732300 CREATE HARDCODED CLOUD WALLET.
27868941 UNABLE TO IMPORT 12.1 DB2ASC INSTANCE DATABASE USING ASC2DB
27920039 LSVOL -A UNEXPIRED LISTS RECYCLABLE CONTENT MANAGED VOLUMES
27930830 CANCELLING BACKUP JOB FROM RMAN SIDE RENDERS VOLUME UNRECYCLABLE
28028846 OBCM DISPLAY COMMAND SHOULD NOT REQUIRE HOST BE TO MEMBER OF A BACKUP DOMAIN.
28103087 OBCM "MISSING WALLET" ERROR MESSAGE SHOULD CONTAIN DIRECTORY NAME.
28149420 OBACSLIBD CRASHES WITH STATUS_IPC_FAILURE - EXCHANGE FULL (BAD FILE DESCRIPTOR)
28193471 REMOVE OBCM RECERTIFYDOMAIN "--RENEW" OPTION.
28395221 QUALIFY TAPE DEVICE HP LTO8
28395337 ADD SUPPORT FOR THE HP MSL3040 LIBRARY
28461197 THE LSPIECE COMMAND HALTS ON FINDING AN PIECE WITH A BACKUP OID OF ZERO
28474164 OBWEBCERT DOES NOT WORK AFTER 12.1.0.3 TO 12.2 UPGRADE.
28496705 WINDOWS.X64: SETUP.EXE FAILS WITH ERROR 2715 ...
28502973 WEB TOOL USES --RMSTAGERULE WHEN MAKING A DISK POOL
28571312 CHECK ENTIRE INSTALL PATH FOR WORLD READ/EXECUTE ACCESS.
28578179 REMOVE DATA FROM CONTAINER PRIOR TO DELETING DB ENTRY
28584192 CLOUD DEVICE LIMITS SEGMENT SIZE TO 200MB
28611440 NEED TO LSBK BY DBNAME, DBID, AND PIECENAME
28658307 ONLY 32-BITS OF 64-BIT VALUE ARE BEING WRITTEN IN SECURITY-CALLBACK FUNCTION.
28658444 SOLARIS SPARC.64 - REMOVE LIBNLS.SO.1 DEPENDENCY.
28674160 SOLARIS.X64 - REMOVE LIBNLS.SO.1 DEPENDENCY.
28796388 OSB 12.2 SCHEDULE "COMPRESSION" SETTINGS DON'T WORK IN UI/WORK FINE IN OBTOOL
28879168 BACKWARD COMPATIBILITY: ADDING 12.X CLIENT TO 18.1 DOMAIN (USING MKHOST) FAILS.

Outstanding Bugs and Known Issues in Oracle Secure Backup 18.1

This section discusses Oracle Secure Backup release 18.1 outstanding bugs and known issues.

Bug 27273828

The Windows install fails if the user requests a non-existing temp directory.

Workaround:

Create the temporary directory before running the installer.

Bug 29938309

Installation of an Administrative Server on a Windows platform will fail if the Windows TZ environment variable is improperly set.

Workaround:

Remove the TZ environment variable or set the TZ environment variable to match the time zone listed in the Windows Control Panel.

Bug 30344325

The catalog command is not able to import the checksum meta data from a copied backup instance. A validatechecksum of that instance will report the error "...... does not contain checksum”.

Workaround:

No workaround. This error is restricted to only backup instances that were copied to a disk pool. It does not occur with instances that was initially written to a disk pool or copied to tape.

Bug 27149730

A backup of an OSB v12.1 or v12.2 client will fail if the ENCRYPTDATAINTRANSIT policy is ON.

Workaround:

The problem can be resolved by having the client encrypt the data before sending it to the media server. Setting both the client’s encryption policy to “required” (chhost --encryption required host-name ) and the hardware encryption policy to “off” (setp backupencryption/enablehardwareencryption off ) will force the client to encrypt the backup data.

Bug 30467042

A backup of a client’s file system that uses a non-root OS user will fail if ENCRYPTDATAINTRANSIT IS ON.

Workaround:

This problem is restricted to remote client file system backups up to a tape or disk pool device. Setting the client’s encryption policy to “required” and the hardware encryption policy to "off "will allow the backup data to be encrypted on the client before being sent to the media server.

Bug 32073537

WEB TOOL - VIEW LOCATION REPORTS NOT WORKING

Workaround

Use obtool crtprt command to generate the location report.

Bug 31941188

COPY INSTANCE FROM OCI/OCI-C TO AN AIX MEDIA SERVER DISK POOL FAILS.

Workaround

Use a different platform for a media server such as Linux.

Bug 31778207

OSB SKIP LOCK FILE POLICY WITH "NO" OPTION BACKUP JOB SUCCEEDS WITHOUT WARNING OR ERRORS IN TRANSCRIPT LOG.

Bug 32230705

CLIENT RE-CERTIFICATION FAILURE WHEN ADDINGHOST IS NOT THE ADMIN HOST

Work around

Update the failing host’s obconfig file ( /etc/obconfig )addinghost field to be the Admin Host’s FQDN and restart Oracle Secure Backup on the host.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.