What Is the Oracle BI Systems Management API?

22-8 System Administrators Guide for Oracle Business Intelligence Enterprise Edition cd .. cd biinstance.toString servicestatus=getServiceStatus print BIInstance MBean; ServiceStatus: + servicestatus print Calling stop ... objs = jarray.array[], java.lang.Object strs = jarray.array[], java.lang.String invokestop, objs, strs servicestatus=getServiceStatus print BIInstance MBean; ServiceStatus: + servicestatus print Calling start ... objs = jarray.array[], java.lang.Object strs = jarray.array[], java.lang.String invokestart, objs, strs servicestatus=getServiceStatus print BIInstance MBean; ServiceStatus: + servicestatus exit 2. Save the script. 3. Navigate to the folder \MW_HOME\wlserver_10.3\common\bin and run the script, entering any arguments required. For example, you might enter the following at the command line: .wlst.sh wlst_stop_start_obi.py localhost 7001 user1 password1 UNIX wlst wlst_wlst_stop_start_obi.cmd localhost 7001 user1 password1 Windows The command window and log file, displays prompts and messages, for example: Initializing WebLogic Scripting Tool WLST ... Welcome to WebLogic Server Administration Scripting Shell Type help for help on available commands Connecting to localhost:7001 as user: user1 ... Connecting to t3:localhost:7001 with userid password1 ... Successfully connected to Administration Server AdminServer that belongs to domain bifoundation_domain. Warning: An insecure protocol was used to connect to the server. To ensure on-the-wire security, use the SSL port or Admin port instead. Connecting to Domain ... Location changed to domain custom tree. This is a writable tree with No root. For more help, use helpdomainCustom Connecting to BIDomain MBean ... Connecting to BIInstance MBean ... BIInstance MBean; ServiceStatus: FULLY_STARTED Calling stop ... BIInstance MBean; ServiceStatus: STOPPED Calling start ... BIInstance MBean; ServiceStatus: FULLY_STARTED Introducing the Oracle BI Systems Management API 22-9 Exiting WebLogic Scripting Tool.

22.3.2.2 Example: Using a Java Program to Stop and Start Oracle Business Intelligence

Refer to the example in Section 22.3.1.2, Example: Using a Java Program to Display the Status of Oracle Business Intelligence, remove the comments before whichever method you want to run example.stopAll; or example.startAll;, as shown in the following main method: param args public static void mainString[] args throws Exception { MBeanAPIExample1 example = new MBeanAPIExample1args; example.connect; example.displayStatus; example.stopAll; example.startAll; }

22.3.3 Updating Configuration Settings Using the Oracle BI Systems Management API

You can use the Oracle BI Systems Management API to change Oracle Business Intelligence configuration settings using WLST commands or a Java program as follows: ■ Section 22.3.3.1, Example: Using WLST to Edit the E-Mail Sender Display Name Configuration Setting ■ Section 22.3.3.2, Example: Using a Java Program to Edit the E-Mail Sender Display Name Configuration Setting You can copy the examples in this section, replacing MBean details with details of other MBeans to update different Oracle Business Intelligence configuration settings for example, log file settings, security settings. For more information, see Section 22.4, Descriptions of JMX Admin MBeans and Methods for the Oracle BI Systems Management API.

22.3.3.1 Example: Using WLST to Edit the E-Mail Sender Display Name Configuration Setting

This example connects to Oracle Business Intelligence, invokes the system lock, updates the value of the E-Mail Sender Display Name configuration setting, and releases the system lock. To use WLST to update the E-Mail Sender Display Name configuration setting: 1. Open a text editor and enter WLST commands similar to the following: Example to demonstrate connecting to a BIEE domain using WLST, and changing a simple configuration setting This script expects the following arguments: 1. wls.host localhost