{
    "mode": "man",
    "parameter": "servertool",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/servertool/1/json",
    "generated": "2026-05-30T05:09:50Z",
    "synopsis": "servertool -ORBInitialPort nameserverport [ options ] [ commands ]\noptions\nThe command-line options. See Options.\ncommands\nThe command-line commands. See Commands.",
    "sections": {
        "NAME": {
            "content": "servertool - Provides an easy-to-use interface for developers to register, unregister, start\nup, and shut down a persistent server.\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "servertool -ORBInitialPort nameserverport [ options ] [ commands ]\n\n\noptions\nThe command-line options. See Options.\n\ncommands\nThe command-line commands. See Commands.\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "The servertool command provides the command-line interface for developers to register,\nunregister, start up, and shut down a persistent server. Command-line commands let you obtain\nvarious statistical information about the server. See Commands.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "-ORBInitialHost nameserverhost\nThis options is required. It specifies the host machine on which the name server runs\nand listens for incoming requests. The nameserverhost value must specify the port on\nwhich the orb is running and listening for requests. The value defaults to localhost\nwhen this option is not specified. If orbd and servertool are running on different\nmachines, then you must specify the name or IP address of the host on which orbd is\nrunning.\n\nNote: On Oracle Solaris, you must become a root user to start a process on a port\nbelow 1024. Oracle recommends that you use a port number above or equal to 1024 for\nthe nameserverport value.\n",
            "subsections": [
                {
                    "name": "-J_option_",
                    "content": "Passes option to the Java Virtual Machine, where option is one of the options\ndescribed on the reference page for the Java application launcher. For example, -J-\nXms48m sets the startup memory to 48 MB. See java(1).\n"
                }
            ]
        },
        "COMMANDS": {
            "content": "You can start the servertool command with or without a command-line command.\n\n• If you did not specify a command when you started servertool, then the command-line tool\ndisplays the servertool prompt where you can enter commands: servertool >.\n\n• If you specify a command when you start servertool, then the Java IDL Server Tool starts,\nexecutes the command, and exits.\n\nregister -server server-class-name -classpath classpath-to-server [ -applicationName application-name -args args-to-server -vmargs flags-for-JVM ]\nRegisters a new persistent server with the Object Request Broker Daemon (ORBD). If\nthe server is not already registered, then it is registered and activated. This\ncommand causes an installation method to be called in the main class of the server\nidentified by the -server option. The installation method must be public static void\ninstall(org.omg.CORBA.ORB). The install method is optional and lets developers\nprovide their own server installation behavior, such as creating a database schema.\n\nunregister -serverid server-id | -applicationName application-name\nUnregisters a server from the ORBD with either its server ID or its\napplication name. This command causes an uninstallation method to be called\nin the main class of the server identified by the -server option. The\nuninstall method must be public static void uninstall(org.omg.CORBA.ORB). The\nuninstall method is optional and lets developers provide their own server\nuninstallation behavior, such as undoing the behavior of the install method.\n\ngetserverid -applicationName application-name\nReturns the server ID that corresponds to the application-name value.\n\nlist\nLists information about all persistent servers registered with the ORBD.\n\nlistappnames\nLists the application names for all servers currently registered with the\nORBD.\n\nlistactive\nLists information about all persistent servers that were started by the ORBD\nand are currently running.\n\nlocate -serverid server-id | -applicationName application-name [ -endpointType endpointType ]\nLocates the endpoints (ports) of a specific type for all ORBs created\nby a registered server. If a server is not already running, then it is\nactivated. If an endpointType value is not specified, then the\nplain/non-protected endpoint associated with each ORB in a server is\nreturned.\n\nlocateperorb -serverid server-id | -applicationName application-name [ -orbid ORB-name ]\nLocates all the endpoints (ports) registered by a specific\nObject Request Broker (ORB) of registered server. If a server\nis not already running, then it is activated. If an orbid is\nnot specified, then the default value of \"\" is assigned to the\norbid. If any ORBs are created with an orbid of empty string,\nthen all ports registered by it are returned.\n\norblist -serverid server-id | -applicationName application-name\nLists the ORBId of the ORBs defined on a server. An ORBId is\nthe string name for the ORB created by the server. If the\nserver is not already running, then it is activated.\n\nshutdown -serverid server-id | -applicationName application-name\nShut down an active server that is registered with ORBD. During\nexecution of this command, the shutdown method defined in the\nclass specified by either the -serverid or -applicationName\nparameter is also called to shut down the server process.\n\nstartup -serverid server-id | -applicationName application-name\nStarts up or activate a server that is registered with ORBD. If\nthe server is not running, then this command starts the server.\nIf the server is already running, then an error message is\ndisplayed.\n\nhelp\nLists all the commands available to the server through the\nservertool command.\n\nquit\nExits the servertool command.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "• orbd(1)\n\n\n\nJDK 8                                     21 November 2013                             servertool(1)",
            "subsections": []
        }
    },
    "summary": "servertool - Provides an easy-to-use interface for developers to register, unregister, start up, and shut down a persistent server.",
    "flags": [
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "Passes option to the Java Virtual Machine, where option is one of the options described on the reference page for the Java application launcher. For example, -J- Xms48m sets the startup memory to 48 MB. See java(1)."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "orbd",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/orbd/1/json"
        }
    ]
}