Administering Diameter Peers

The following topics are addressed here:

• To Create a Diameter Peer

• To Update a Diameter Peer

• To Delete a Diameter Peer

• To List Diameter Peers

To Create a Diameter Peer

Use the create-diameter-peer command in remote mode to add peer host information to the known peer list in the specified cluster or server instance. If you do not specify the --target option, the default instance is used. If the task applies to a cluster, the --target option must specify the cluster name.

Before You Begin

A Diameter application must be created before a Diameter peer can be created.

1. Ensure that the server is running.

   Remote commands require a running server.

2. Add peer host information to the Diameter peer list by using the create-diameter-peer(1) command.

   Information about the options and properties of the command is included in this help page.

Example 2–11 Adding Peer Information to a Diameter Application Set

This example creates a peer named peer_1 on the default instance.

asadmin> create-diameter-peer --applicationsref apps_1 --realm Sun.com --peerhost nyx
--peerport 3878 --transport tls peer_1
Command create-diameter-peer executed successfully.

See Also

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

To Update a Diameter Peer

Use the set command to update an existing Diameter peer.

1. List Diameter peers by using the list-diameter-peers(1) command.

2. Update a Diameter peer by using the set(1) command.

   This example changes the listening port of the peer with ID p1.

   asadmin> set server-config.diameter-service.peer-configuration.peers.peer.p1.port=3737 server-config.diameter-service.peer-configuration.peers.peer.p1.port = 3737

   where p1 is the peer ID which can be changed.

3. Restart the server for changes to take effect.

   Use the stop-domain(1) and start-domain(1) commands.

To Delete a Diameter Peer

Use the delete-diameter-peer command in remote mode to remove a peer in the Diameter service from the specified cluster or server instance. If you do not specify the --target option, the default instance is used. If the task applies to a cluster, the --target option must specify the cluster name.

1. Ensure that the server is running.

   Remote commands require a running server.

2. List Diameter peers by using the list-diameter-peers(1) command.

3. Delete a Diameter peer by using the delete-diameter-peer(1) command.

Example 2–12 Deleting a Diameter Peer

This example deletes peer_1 from the default instance.

asadmin> delete-diameter-peer peer_1
Command delete-diameter-service executed successfully.

See Also

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

To List Diameter Peers

Use the list-diameter-peers command in remote mode to list all peers on the specified cluster or server instance. If you do not specify the --target option, the default instance is used. If the task applies to a cluster, the --target option must specify the cluster name.

1. Ensure that the server is running.

   Remote commands require a running server.

2. List Diameter peers by using the list-diameter-peers(1) command.

Example 2–13 Listing Diameter Peers

This example lists the Diameter peers on the default instance.

asadmin> list-diameter-peers
peer_1
Command list-diameter-peers executed successfully.

See Also

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