|
Oracle® Business Intelligence Presentation Services Administration Guide > Administering Oracle BI Presentation Services > Using the Javahost Service in Oracle BI Presentation Services >
Javahost Service Command Line Options
When using the command line in UNIX and Windows, you can specify some command line options. In UNIX, the command line for starting the Javahost service is: run.sh [-h] [-service] [-Config Javahostconfig]
In UNIX, the command line for stopping the Javahost service is: shutdown.sh [-h] [-Config Javahostconfig] [-Port port] [-Host host]
In Windows, the command line for starting the Javahost service in Console mode is: sawjavahostsvc.exe [-regserver instancename | -regserverauto instancename | -unregserver instancename | -h | -service -V ] [-user username] [-pwd password] [-SAWConfig instanceconfig] [-Config Javahostconfig]
NOTE: You can specify multiple Javahost configuration files (config.xml) and multiple Oracle BI Presentation Services configuration files (instanceconfig.xml). You might want to have multiple Javahost configuration files, for example, if you want to define all components supported by Javahost services and other necessary settings in one file and then modify the listening port and selectively enable and disable components supported by Javahost services in another file.
If you specify multiple files, the configuration elements are merged and the precedence of values in the files is based on the order in which the files are specified.
For example: sawjavahostsvc.exe /SAWConfig ../OracleBIData/web/config/instanceconfig.xml /Config ../javahost/config/config.xml /Config ../javahostconfigs/config.xml
Table 5 lists and describes the command line options.
Table 5. Javahost Service Command Line Options
|
|
|
-regserver instancename |
Windows |
Registers the Oracle Business Intelligence Javahost service in manual startup mode. (optional) The instancename parameter is used to register more than one Javahost service on the same machine. If specified, the Javahost service name is set to OracleBI Java Host <instancename>. |
-regserverauto instancename |
Windows |
Registers the Oracle Business Intelligence Javahost service in automatic startup mode. (optional) The instancename parameter is used to register more than one Javahost service on the same machine. If specified, the Javahost service name is set to OracleBI Java Host <instancename>. |
-unregserver instancename |
Windows |
Unregisters the Oracle Business Intelligence Javahost service. (optional) The instancename parameter is used when more than one Javahost service is registered on the same machine. |
-service |
UNIX, Windows |
Executes Javahost in Service mode. On Windows, this parameter should never be used explicitly. Instead, use the control panel Services applet to start and stop the Oracle Business Intelligence Javahost service. |
-V |
Windows |
Displays the version. |
-user username |
Windows |
Specifies the username for the user account which will be used by Windows to launch Javahost service. Used in conjunction with the -regserver and -regserverauto options. |
-pwd password |
Windows |
Specifies the password for the user account which will be used by Windows to launch Javahost service. Used in conjunction with the -regserver and -regserverauto options. |
-SAWConfig instanceconfig |
UNIX, Windows |
Specifies the path to Oracle BI Presentation Services configuration file (instanceconfig.xml). The default path is: SADATADIR/web/config/instanceconfig.xml
(where SADATADIR is the data directory) |
-Config Javahostconfig |
UNIX, Windows |
Specifies the path to config.xml. The default path is: SAROOTDIR\web\javahost\config
(where SAROOTDIR is the installation directory) NOTE: You should use -Config when stopping a Javahost service that uses an SSL connection so that required SSL configuration parameters can be read.
|
-Port port |
UNIX |
Identifies the Javahost listening port. |
-Host hostname |
UNIX |
Identifies the computer running the Javahost service. |
In UNIX, the shutdown.sh parameters serves one purpose, which is to pass connection information (host and port) so that a shutdown signal can be sent to the Javahost service. The following rules explain how these parameters interact: - If either the -Host or the -Port parameter is specified, then shutdown.sh ignores the -Config parameter.
- If -Host is specified and -Port is not, then shutdown.sh uses 9810 as the port number.
- If the -Config parameter is set, then shutdown.sh uses the instanceconfig.xml file to find the Javahost listening port. It expects that the Javahost service is running on the local computer (Host=localhost).
- If no parameters are specified, then shutdown.sh uses Host=localhost and port=9810.
| 
