1. Command Line Interface
  2. Verb Reference
  3. EM CLI Verbs
  4. setup_bipublisher

setup_bipublisher

Sets up a relationship between Enterprise Manager and a BI Publisher Web Application. If a relationship already exists, you must provide the -force option. The Enterprise Manager System Reports are deployed to the newly configured BI Publisher Web Application. To just change the registration details without deploying the reports, use the -nodeploy option. Detailed status messages are provided for all operations.

Use the -force option to overwrite existing copies of reports if they exist. If you do not want to deploy following setup, you can specify the -nodeploy option.

Note:

This verb requires Enterprise Manager Super Administrator privileges.

Format

emcli setup_bipublisher
    [-force]
    -protocol=http|https
    -host=<hostname>
    -port=<portnumber>
    -uri=xmlpserver
    [-nodeploy]

[ ]  indicates that the parameter is optional

Options

  • force

    Overwrites existing copies of reports if they exist. The following scenarios are affected by this option:

    • If a relationship exists between Enterprise Manager and a BI Publisher Web Application, this option overrides it with a new relationship (-host, -port, and so forth).

    • If you do not specify -nodeploy, this option causes deployed reports to overwrite any that may already exist for the BI Publisher Web Application in the "Enterprise Manager Cloud Control" folder.

  • protocol

    Must be either http or https.

  • host

    Name of the host that is running, or server load balancer fronting the BI Publisher Web Application.

  • port

    Port number of the web service.

  • uri

    Web application context root, which must be xmlpserver.

  • nodeploy

    Specify if you do not want to deploy following setup. Suppresses the Enterprise Manager BI Publisher System Reports to the BI Publisher Web Application. You can do this later with the deploy_bipublisher_reports cli.

Examples

Example 1

emcli setup_bipublisher
     -protocol=https
     -host=www.somehost.com
     -port=7801
     -uri=xmlpserver

Example 2

This example reconfigures the BI Publisher Managed Server (BIP) inside the WebLogic Server console to listen on a different port (9704): 

emcli setup_bipublisher -protocol=https -host=somehost.com -port=9704 -uri=xmlpserver -force -nodeploy