Managing Capacity in Oracle Business Intelligence (Vertically Scaling)

You can change the number of Oracle Business Intelligence system components and managed servers to suit capacity requirements.

You should first configure shared files and directories for clustered components to use (see Setting Up Shared Files and Directories).

You can change the number of BI System components to suit capacity requirements.

The commands described in this section should only be used by advanced users.

Adding System Components

You can add BI System Components to a computer when the system is stopped (offline).

Note:

If SSL is configured, see Configuring SSL in Oracle Business Intelligence in Security Guide for Oracle Business Intelligence Enterprise Edition

Assumptions:

  • You must have appropriate file system permissions.

  • Ports are allocated from the Oracle Business Intelligence port range, unless otherwise specified.

  • Supported system component types are OBIPS (BI Presentation Server), OBICCS (Cluster Controller), OBIJH (BI JavaHost), and OBISCH (BI Scheduler).

    OBIS is not scaled out because OBIS instances are managed as part of service instances.

    See About System Components.

  • You can only create two instances each of the component types OBICCS, OBISCH (one active, one passive). Therefore, if it is required to add another instance on another host, then an existing instance must first be removed.

  1. Start the WebLogic Scripting Tool (WLST).

    ORACLE_HOME/oracle_common/common/bin/wlst.sh

  2. Select your domain using the readDomain(DOMAIN_HOME) command.

    For example on UNIX:

    readDomain(‘/oraclehome/user_projects/domains/bi’)

    For example on Windows:

    readDomain(‘D:\\Oracle\\Middleware\\ORACLE_HOME\\user_projects\\domains\\bi’)

  3. Create the new Presentation Services system component(s) using an appropriate WLST command.

    All commands take a DOMAIN_HOME a machine name and an optional port specification.

    createOBIPSComponent(domainHome, machine, port=<portnumber>)

    Where machine is the WebLogic logical computer name (for example 'm1'). Use WLST or the WebLogic Admin Console (if running) to discover the logical machine name.

    For example on UNIX:

    createOBIPSComponent(‘/u01/../../domains/bi’,'m1’)

    For example on Windows:

    createOBIPSComponent(‘D:\\Oracle\\Middleware\\ORACLE_HOME\\user_projects\\domains\\bi,'m1’)

    Command Description

    createOBICCSComponent(domainHome, machine, port=None, portMonitor=None)

    This command creates a new cluster component.

    createOBISCHComponent(domainHome, machine, port=None, portMonitor=None,portScript=None)

    This command creates a new scheduler component.

    createOBIPSComponent(domainHome, machine, port=None)

    This command creates a new BI Presentation Server component.

    createOBIJHComponent(domainHome, machine, port=None)

    This command creates a new JavaHost component

    listBISystemComponents(domainHome)

    This command returns an object listing all of the system components in the domain.

    getBISystemComponents(domainHome, instanceId)

    This command displays details of system component with specified instanceID.
  4. Once command(s) have completed successfully, then you must commit the changes using the updateDomain('DOMAIN_HOME') command.

    The WLST command is same for all environments.

    For example:

    updateDomain()
  5. Close the domain using the closeDomain('DOMAIN_HOME') command.

    The WLST command is same for all environments.

    For example:

    closeDomain()
  6. Start the new component in:

    DOMAIN_HOME/bitools/bin/

    For example, enter:

    ./start.sh

    See Starting Oracle Business Intelligence Component Processes in a Domain.

    Note:

    If you make a mistake or decide to abandon changes, you should use the closeDomain() command without using the updateDomain() command.

Post Conditions

  • The new component is created.

  • New port(s) are allocated.

  • The new component is started.

See Using the WebLogic Scripting Tool (WLST).

Removing System Components

You can remove an unwanted or inactive Presentation Services system component instances from a computer.

Assumptions:

  • Run commands when system is stopped (offline), as long as you have appropriate file system (offline) privileges.

  • Supported system component types are OBIPS (BI Presentation Server), OBICCS (BI Cluster Controller), OBIJH (BI JavaHost), and OBISCH (BI Scheduler). See About System Components.

  1. Stop the system using the stop script located in:

    DOMAIN_HOME/bitools/bin/

    For example on UNIX enter:

    ./stop.sh

    See Stopping Oracle Business Intelligence Component Processes in a Domain.

  2. Delete a system component by running the deleteBISystemComponent WLST command from ORACLE_HOME/oracle_common/common/bin/wlst.sh:

    deleteBISystemComponent(domainHome, instanceId)

    Where domainHome is the DOMAIN_HOME for the domain, and instanceID is the BI component ID (for example, obips1, obis4)

    For example:

    deleteBISystemComponent("/oraclehome/user_projects/domains/bi", "obips1")

    This removes system component(s) and un-allocates ports.

    See Using the WebLogic Scripting Tool (WLST).

    The deleted system component name is displayed.

  3. Start the system by running the following command located in:

    DOMAIN_HOME/bitools/bin/

    For example on UNIX enter:

    ./start.sh

    See Starting Oracle Business Intelligence Component Processes in a Domain.