Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Znav
nextSetting Environment Variables in Descriptors
prevVariable Descriptor Element

Server descriptors and IceBox descriptors may specify command-line options that the node will pass to the program at startup. As the node prepares to execute the server, it assembles the command by appending options to the server executable's pathname.

In XML, you define a command-line option using the option element:

Wiki Markup
{zcode:xml}
<server id="Server1" ...>
    <option>--Ice.Trace.Protocol</option>
    ...
</server>
{zcode}

The node preserves the order of options, which is especially important for Java servers. For example, JVM options must appear before the class name, as shown below:

Wiki Markup
{zcode:xml}
<server id="JavaServer" exe="java" ...>
    <option>-Xnoclassgc</option>
    <option>ServerClassName</option>
    <option>--Ice.Trace.Protocol</option>
    ...
</server>
{zcode}

The node translates these options into the following command:

Wiki Markup
{zcode}
java -Xnoclassgc ServerClassName --Ice.Trace.Protocol
{zcode}
Ztop
See Also
Zret
Znav
nextSetting Environment Variables in Descriptors
prevVariable Descriptor Element