1. Administering Oracle Analytics Server
  2. Configure Oracle Analytics Server
  3. Manage Oracle Analytics Server Instances Using the WebLogic Server Scripting Tool
  4. Manage Service Instances

Manage Service Instances

A service instance contains all of the Oracle Analytics Server metadata (that is, repository data, presentation catalog, security policy), and includes the customizations that you make to the metadata. You manage a service instance in a BI domain using WebLogic Scripting Tool (WLST) commands described in the table below.

See Use the WebLogic Scripting Tool (WLST).

Command Description

listBIServiceInstances

This command lists all Service Instance keys in the BI domain.

getBIServiceInstance

This command gets service instance details for a given service instance key.

scaleOutBIServiceInstance

This command scales-out the Service Instance(s) onto the new computer, ensuring that the service instance is available on the specified computer within the BI domain. This command is only used in advanced cases.

export_service_instance

This command has been replaced by the exportarchive.sh|cmd script in bitools/bin. The script exports the metadata of your environment in the form of a BAR file.

import_bar

This command has been replaced by the importarchive.sh|cmd script in bitools/bin. This script imports an already exported BAR file (service instance) to replace metadata in the target environment.

refreshServiceInstance

This command refreshes certain aspects of a service instance serviceKey that are inherited from the BI domain. For example, if a new module or product is added to the BI domain, the permission sets for that module or product is only made available to the service instance when the service instance is refreshed.

refreshDomainServiceInstances

This command refreshes all the service instances of the domain.

resetServiceInstance

This command resets the given service instance to empty state equivalent to importing the empty BAR file.
Parameters Description

domainHome

Path to BI domain home.

/oraclehome/user_projects/domains/bi

serviceInstanceKey

Key for the service instance to be associated with, or scaled out to.

For example:

bootstrap

machine

Name of the computer to which you're scaling out.

For example:

machine=mycompany.example.com

port

The port number to use on the scaled out computer.

For example:

port=9768

monitorPort

Name of the monitor port to use on the scaled out computer.

For example:

portMonitor=9502

Assumptions for all WLST commands against BI Service Instances and BAR files:

  • You must have file system (offline) permissions.

  • You run the WLST commands offline.

  • You must start your system after making changes to service instances through WLST.

The following scripts are reserved for future use:

  • ORACLE_HOME/user_projects/domains/bi/bitools/bin/create_bi_service_instance.sh

  • ORACLE_HOME/user_projects/domains/bi/bitools/bin/delete_bi_service_instance.sh