OBIEE 12.2.1.3 Deprecated BAR file APIs

Whilst running the exportServiceInstance WLST API command on an OBIEE 12.2.1.3 instance to generate an OBIEE 12c BAR file, I got this warning message:

In 12.2.1.4, however, the warning is now an error message:

There doesn't appear to be any Oracle documentation about what the replacement APIs are other than the location in the 12.2.1.4 error message (see above). The importServiceInstance WLST API command is also impacted by this.

A list of files in the /bitools/bin directory shows there are 2 scripts called import_bar.sh and export_service_instance.sh.

The export_service_instance.sh script takes the following parameters:

1. <service key> - the service instance is typically ssi
2. <bar location> - the location where the bar file should be created
3. [excludes] which is a comma separated list of nouserfolders and/or noconnectioncredentials where nouserfolders indicates that user folders will be excluded from the generated BAR file and noconnectioncredentials indicates that repository connection credentials will be excluded from the generated BAR file.

An example call to this script would be:

For the import_bar.sh script, the parameters are as below:

1. <service key> - the service instance is typically ssi
2. <bar location> - the location of the bar file
3. [excludes] which is a comma separated list of nodatamodel,nocontent,noauthorization where nodatamodel indicates that the repository won't be imported, nocontent indicates that the web catalog won't be imported and noconnectioncredentials indicates that repository connection credentials won't be imported.

An example call to this script would be:

These new APIs are available in 12.2.1.3 as well as 12.2.1.4. They appear to be more straightforward to execute as the old WLST API commands took up to 8 parameters!

UPDATE

The import_bar.sh command is deprecated in OBIEE 12.2.1.4. If it is used, custom application roles will not be imported and there are no errors by the way.

In 12.2.1.4, you will need to use the import archive.sh command which is located in the bitools directory.

The parameters for this command are as follows:

Service Instance
Location of BAR file to be imported

There is a list of optional parameters as well which determine what content of the BAR file is required for the import.

More details of the importarchive.sh command can be found here