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 17–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 17–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 17–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 17–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.