Use SASchInvoke when BI Scheduler is SSL-Enabled

When the BI Scheduler is enabled for communication over SSL, you can invoke the BI Scheduler using the SASchInvoke command line utility.

The SASchInvoke tool is a command line job invocation tool which allows you to run pre-existing Oracle BI Scheduler jobs.

1. Create a new text file containing on a single line the passphrase you used when running the ./ssl.sh exportclientcerts command.

   Ensure this file has appropriately restrictive file permissions to protect it. Typically it should only be readable by the owner. See Exporting Client Certificates.

2. Locate the SASchInvoke tool:

   Windows: <Domain_Home>/bitools/bin/saschinvoke.cmd

3. Use the following syntax to run the SASchInvoke command:

   SASchInvoke -u <Admin Name>  (-j <job id> | -i <iBot path>)  
   	([-m <machine name>[:<port>]] | -p <primaryCCS>[:<port>] -s <secondaryCCS>[:<port>])  
   	([(-r <replace parameter filename> | -a <append parameter filename>)]  | [-x <re-run instance id>]) 
   	[-l [-c <SSL certificate filename> -k <SSL certificate private key filename>] [ -w <SSL passphrase>  | -q <passphrase file>  | -y ] 
   	[-h <SSL cipher list>] 
   	[-v [-e <SSL verification depth>] -d <CA certificate directory> | -f <CA certificate file> [-t <SSL trusted peer DNs>] ] ]
   
   where:
   -a  File containing additional parameters.
   -c  File containing SSL certificate. SSL certificate filename = clientcert.pem
   -d  Certificate authority directory.
   -e  SSL certificate verification depth.
   -f  Certificate authority file.
   -h  SSL cipher list
   -i  Agent path
   -j  Job id
   -k  SSL certificate private key filename. SSL certificate private key filename = clientkey.pem
   -l  Use SSL
   -m  Machine name:port of scheduler.  Provides direct access to scheduler.
   -p  Primary cluster controller name:port.  Provides access to clustered scheduler.
   -q  Location of the passphrase file created in step 1 containing the SSL passphrase protecting SSL private key (see -k).
   -r  File containing replacement parameters.
   -s  Secondary cluster controller name:port.  Provides access to clustered scheduler.
   -t  Distinguished names of trusted peers.
   -u  Username
   -v  Verify peer
   -w  SSL passphrase protecting SSL private key (see -k).
   -x  Rerun instance id.
   -y  Interactively prompt for SSL passphrase protecting SSL private key (see -k).
   

4. The command prompts you to enter the administrator password. Once entered, the SASchInvoke tool will get the BI Scheduler to run the specified job.