startOgServer script

The startOgServer script starts servers. You can use a variety of parameters when you start your servers to enable trace, specify port numbers, and so on.

Purpose

You can use the startOgServer script to start servers.

Location

The startOgServer script is in the bin directory of the root directory, for example:
cd objectgridRoot/bin
Note: If you have Java classes stored in a specific directory, instead of altering the startOgServer script, you can launch the server with arguments as follows: -jvmArgs -cp C:\ . . . \DirectoryPOJOs\POJOs.jar
.

Usage for catalog servers

To start a catalog server:

[Windows]
startOgServer.bat <server> [options]
[Unix]
startOgServer.sh <server>[options]
To start a default configured catalog server, use the following commands:
[Windows]
startOgServer.bat catalogServer
[Unix]
startOgServer.sh catalogServer

Options for starting catalog servers

Parameters for starting a catalog server:
-catalogServiceEndPoints <server:serverHost:clientPort:peerPort,server:serverHost:clientPort:peerPort>
On the container, the -catalogServiceEndpoints option is used to reference the Object Request Broker (ORB) host and port on the catalog service.
-clusterSecurityFile <cluster security xml file>
Specifies the location of the security descriptor XML file.
-clusterSecurityUrl <cluster security xml URL>
-domain <domain name>
-listenerHost <host name>
Default: localhost

Specifies the listener host for communication with Internet Inter-ORB Protocol (IIOP).

-listenerPort <port>
Default: 2809

Specifies the listener port for communication with IIOP.

-haManagerPort <port>
Default: This is the same as the peerport. If this property is not set, the catalog service automatically generates an available port.

Specifies the port number the high availability manager uses.

-serverProps <server properties file>
Specifies the server property file that contains the server-specific security properties. The file name specified for this property is just in plain file path format, such as c:/tmp/og/catalogserver.props.
-JMXServicePort <port>
Default: 1099

Specifies the port number for communication with Java™ Management Extensions (JMX).

-traceSpec <trace specification>
Specifies a string that specifies the scope of the trace that is enabled when the server starts.
Example:
  • ObjectGrid=all=enabled
  • ObjectGrid*=all=enabled
-traceFile <trace file>
Specifies the path of a file in which to save trace information.

Example: ../logs/c4Trace.log

-timeout <seconds>
Specifies a number of seconds before the server start times out.
-script <script file>
Creates a custom script for commands you specify to start catalog servers or containers and then parameterize or edit as you require.
-jvmArgs <JVM arguments>
Specifies a set of JVM arguments. Every parameter after the -jvmArgs parameter is used to start the server Java virtual machine (JVM). When the -jvmArgs parameter is used, ensure that it is the last optional script argument specified.

Example:-jvmArgs -Xms256M -Xmx1G

Usage for container servers

[Windows]
startOgServer.bat <server> -objectgridFile <xml file> 
-deploymentPolicyFile <xml file> [options] 
[Windows]
startOgServer.bat <server> -objectgridUrl <xml URL> 
-deploymentPolicyUrl <xml URL> [options]
[Unix]
startOgServer.sh <server> -objectgridFile <xml file> 
-deploymentPolicyFile <xml file> [options]
[Unix]
 startOgServer.sh <server> -objectgridUrl <xml URL> 
-deploymentPolicyUrl <xml URL> [options]

Options for container servers

-catalogServiceEndPoints<hostName:port,hostName:port>
Default: localhost:2809
-deploymentPolicyFile <deployment policy xml file>
Specifies the path to the deployment policy file.

Example: ../xml/SimpleDP.xml

-deploymentPolicyUrl <deployment policy url>
-objectgridFile <ObjectGrid descriptor xml file>
Specifies the path to the ObjectGrid descriptor file.
-objectgridUrl <ObjectGrid descriptor url>
-listenerHost <host name>
Default: localhost

Specifies the listener host for communication with Internet Inter-ORB Protocol (IIOP).

-listenerPort <port>
Default: 2809

Specifies the listener port for communication with IIOP.

-serverProps <server properties file>
Specifies the path to the server property file.

Example:../security/server.props

-zone <zone name>
Specifies the zone to use for all of the containers within the server.
-traceSpec <trace specification>
Specifies a string that specifies the scope of the trace that is enabled when the server starts.
Example:
  • ObjectGrid=all=enabled
  • ObjectGrid*=all=enabled
-traceFile <trace file>
Specifies the path of a file in which to save trace information.

Example: ../logs/c4Trace.log

-timeout <seconds>
Specifies a number of seconds before the server start times out.
-script <script file>
Creates a custom script for commands you specify to start catalog servers or containers and then parameterize or edit as you require.
-jvmArgs <JVM arguments>
Specifies a set of JVM arguments. Every parameter after the -jvmArgs parameter is used to start the server Java virtual machine (JVM). When the -jvmArgs parameter is used, ensure that it is the last optional script argument specified.

Example:-jvmArgs -Xms256M -Xmx1G