Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
servertool(1)		    General Commands Manual		 servertool(1)

Name
       servertool - The	Java(TM) IDL Server Tool

       servertool  provides  a command-line interface for application program-
       mers to	register,  unregister,	startup,  and  shutdown	 a  persistent
       server.

SYNOPSIS
       servertool -ORBInitialPort nameserverport options [ commands ]

       If  you	did  not  enter	 a  command when starting servertool, the com-
       mand-line tool displays with a servertool _ prompt. Enter  commands  at
       the servertool _	prompt.

       If  you	enter  a command when starting servertool, the Java IDL	Server
       Tool starts, runs the command, and exits.

       The -ORBInitialPort nameserverport option is required.  The  value  for
       nameserverport  must specify the	port on	which orbd is running and lis-
       tening for incoming requests. When using	Solaris	software, you must be-
       come  root to start a process on	a port under 1024. For this reason, we
       recommend that you use a	port number greater than or equal to 1024  for
       the nameserverport.

DESCRIPTION
       The  servertool provides	the command-line interface for the application
       programmers to register,	unregister, startup, and shutdown a persistent
       server.	Other  commands	are provided to	obtain various statistical in-
       formation about the server.

OPTIONS
	  -ORBInitialHost nameserverhost
	     Specifies the host	machine	on which the name  server  is  running
	     and  listening for	incoming requests. The nameserverhost defaults
	     to	localhost if this option is not	specified. If orbd and server-
	     tool are running on different machines, you must specify the name
	     or	IP address of the host on which	orbd is	running.

	  -Joption
	     Pass option to the	Java virtual machine, where option is  one  of
	     the  options described on the reference page for java(1). For ex-
	     ample, -J-Xms48m sets the startup memory to 48 megabytes. It is a
	     common  convention	 for -J	to pass	options	to the underlying vir-
	     tual machine.

COMMANDS
	  register	 -server <server class name>	    -classpath <class-
	  path to server>		 [ -applicationName <application name>
	  -args	<args to server> -vmargs <flags	to be passed to	Java VM>  ]
	     Register a	new persistent server with the Object  Request	Broker
	     Daemon  (ORBD).  If  the  server is not already registered, it is
	     registered	and activated. This command causes an  install	method
	     to	 be  invoked in	the main class of the server identified	by the
	     -server option. The install method	must be	public static void in-
	     stall(org.omg.CORBA.ORB).	The install method is optional and en-
	     ables the developer to provide their own server installation  be-
	     havior (for example, creating database schema).

	  unregister	-serverid <server id > |    -applicationName <applica-
	  tion name>
	     Unregister	a server from the ORBD by using	either its  server  id
	     or	 its application name. This command causes an uninstall	method
	     to	be invoked in the main class of	the server identified  by  the
	     -server  option.  The uninstall method must be public static void
	     uninstall(org.omg.CORBA.ORB). The uninstall  method  is  optional
	     and  enables  the developer to provide their own server uninstall
	     behavior (for  example,  undoing  the  behavior  of  the  install
	     method).

	  getserverid -applicationName <application name>
	     Return the	server id that corresponds with	an application.

	  list
	     List information about all	persistent servers registered with the
	     ORBD.

	  listappnames
	     List the application names	for all	servers	 currently  registered
	     with the ORBD.

	  listactive
	     List  information	about  all  persistent	servers	that have been
	     launched by the ORBD and are currently running.

	  locate -serverid <server id >	|  -applicationName <application name>
	  [-endpointType <endpointType>	]
	     Locate the	endpoints (ports) of a specific	type for all ORBs cre-
	     ated by a registered server. If a server is not already  running,
	     it	 is  activated.	If an endpoint type is not specified, then the
	     plain/non-protected endpoint associated with each ORB in a	server
	     is	returned.

	  locateperorb	 -serverid <server id >	|   -applicationName <applica-
	  tion name> [-orbid <ORB name>	]
	     Locate all	the endpoints (ports) registered by a specific ORB  of
	     registered	server.	If a server is not already running, then it is
	     activated.	If an orbid is not specified, the default value	of  ""
	     is	 assigned  to the orbid. If any	ORBs are created with an orbid
	     of	empty string, all ports	registered by it are returned.

	  orblist -serverid <server id > | -applicationName <application name>
	     Lists the ORBId of	the ORBs defined on a server. An ORBId is  the
	     string  name  for the ORB created by the server. If the server is
	     not already running, it is	activated.

	  shutdown     -serverid <server id > |	    -applicationName <applica-
	  tion name>
	     Shutdown  an  active  server that is registered with ORBD.	During
	     execution of this command,	the shutdown() method defined  in  the
	     class  specified  by either the -serverid or -applicationName pa-
	     rameter is	also invoked to	shutdown the server process  appropri-
	     ately.

	  startup -serverid <server id > | -applicationName <application name>
	     Startup or	activate a server that is registered with ORBD.	If the
	     server is not running, this command launches the server.  If  the
	     server  is	 already  running, an error message is returned	to the
	     user.

	  help
	     List all the commands available to	the server through the	server
	     tool.

	  quit
	     Exit the server tool.

SEE ALSO
       orbd(1)

				  16 Mar 2012			 servertool(1)

Name | SYNOPSIS | DESCRIPTION | OPTIONS | COMMANDS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=servertool&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help