Oracle^® Business Intelligence Enterprise Edition Deployment Guide > Enabling Oracle Single Sign-On for Oracle Business Intelligence >

Registering Oracle BI as a Partner Application to the Oracle Single Sign-On Server

In the following procedure, the command script you use depends on your operating system:

Under UNIX: use ORACLE_HOME/sso/bin/ssoreg.sh

Under Windows: use ORACLE_HOME\sso\bin\ssoreg.bat

To register Oracle BI as a partner application to Oracle SSO

1. Ensure that Oracle Identity Management is running.
2. On the machine that hosts the Oracle Single Sign-On server, set the ORACLE_HOME environment variable to point to the directory where Oracle Single Sign-On server is installed.
3. On the machine that hosts the Oracle Single Sign-On server, run the following command:

   ssoreg.sh or ssoreg.bat
   -oracle_home_path orcl_home_path
   -site_name <site_name>
   -config_mod_osso TRUE
   -mod_osso_url <mod_osso_url>
   [-virtualhost]
   [-update_mode CREATE | DELETE | MODIFY]
   [-remote_midtier]
   [-config_file config_file_path]
   [-admin_info admin_info]
   [-admin_id adminid]

   where:

   • site_name is the name of the site. It is typically the effective host name and port of the partner application being registered. For example, bi.mycompany.com:7777, or bi.mycompany.com:443 (if SSL is enabled).
   • config_mod_osso is set to TRUE to indicate the application being registered is mod_osso. You must include config_mod_osso for osso.conf to be generated.
   • mod_osso_url is the effective URL of the partner application. This is the URL that is used to access the partner application. For example, http://bi.mycompany.com:7777, or https://bi.mycompany.com:443 (if SSL is enabled).

     Refer to the chapter on configuring and administering partner applications in the Oracle Application Server Single Sign-On Administrator's Guide 10g (10.1.4.0.1) for details of the syntax and parameters for ssoreg.

     For example:

   Oracle_HOME/sso/bin/ssoreg.sh -oracle_home_path Oracle_HOME -config_mod_osso TRUE -site_name bi.mycompany.com:7777 -remote_midtier -config_file Oracle_HOME/Apache/Apache/conf/osso/biosso.conf -mod_osso_url http://bi.mycompany.com:7777

   where:

   • remote_midtier specifies that the mod_osso partner application (in this case, the Oracle BI application) to be registered is at a remote midtier.
   • biosso.conf is the name of the resulting obfuscated osso configuration file created. The details of the registration can be checked at Oracle_HOME/sso/log/ssoreg.log.