Administering IIOP Listeners

An IIOP listener is a listen socket that accepts incoming connections from the remote clients of enterprise beans and from other CORBA-based clients. Multiple IIOP listeners can be configured for GlassFish Server. For each listener, specify a port number (optional; default 1072), a network address, and security attributes (optional). If you create multiple listeners, you must assign a different port number for each listener.

The following topics are addressed here:

• To Create an IIOP Listener

• To List IIOP Listeners

• To Update an IIOP Listener

• To Delete an IIOP Listener

To Create an IIOP Listener

Use the create-iiop-listener subcommand in remote mode to create an IIOP listener.

1. Ensure that the server is running.

   Remote subcommands require a running server.

2. Create an IIOP listener by using the create-iiop-listener(1) subcommand.

   Information about the properties for the subcommand is included in this help page.

3. To apply your changes, restart GlassFish Server.

   See To Restart a Domain.

Example 15-1 Creating an IIOP Listener

This example creates an IIOP listener named sample_iiop_listener.

asadmin> create-iiop-listener --listeneraddress 192.168.1.100
--iiopport 1400 sample_iiop_listener
Command create-iiop-listener executed successfully.

See Also

You can also view the full syntax and options of the subcommand by typing asadmin help create-iiop-listener at the command line.

To List IIOP Listeners

Use the list-iiop-listeners subcommand in remote mode to list the existing IIOP listeners.

1. Ensure that the server is running.

   Remote subcommands require a running server.

2. List the IIOP listeners by using the list-iiop-listeners(1) subcommand.

Example 15-2 Listing IIOP Listeners

This example lists all the IIOP listeners for the server instance.

asadmin> list-iiop-listeners
orb-listener-1
SSL
SSL_MUTUALAUTH
sample_iiop_listener
Command list-iiop-listeners executed successfully.

See Also

You can also view the full syntax and options of the subcommand by typing asadmin help list-iiop-listeners at the command line.

To Update an IIOP Listener

1. List the IIOP listeners by using the list-iiop-listeners(1) subcommand.
2. Modify the values for the specified IIOP listener by using the set(1) subcommand.

   The listener is identified by its dotted name.

Example 15-3 Updating an IIOP Listener

This example changes SSL from enabled to disabled.

asadmin> set "server.iiop-service.iiop-listener.SSL.enabled" server.iiop-service.iiop-listener.SSL.enabled=false
Command set executed successfully.

To Delete an IIOP Listener

Use the delete-iiop-listener subcommand in remote mode to delete an IIOP listener.

1. Ensure that the server is running.

   Remote subcommands require a running server.

2. List the IIOP listeners by using the list-iiop-listeners(1) subcommand.
3. Delete an IIOP listener by using the delete-iiop-listener(1) subcommand.
4. To apply your changes, restart GlassFish Server.

   See To Restart a Domain.

Example 15-4 Deleting an IIOP Listener

This example deletes the IIOP listener named sample_iiop_listener.

asadmin> delete-iiop-listener sample_iiop_listener
 Command delete-iiop-listener executed successfully.

See Also

You can also view the full syntax and options of the subcommand by typing asadmin help delete-iiop-listener at the command line.