---
title: Joining a topology with manage-topology
description: To join an existing PingAuthorize Server to an existing PingDirectory Server topology, you can use the manage-topology add-server command to provide connection information for one of the PingDirectory Servers. This PingDirectory Server must be running when you execute the setup tool.
component: pingauthorize
version: 11.0
page_id: pingauthorize:pingauthorize_server_administration_guide:paz_join_topo_manage_topology
canonical_url: https://docs.pingidentity.com/pingauthorize/11.0/pingauthorize_server_administration_guide/paz_join_topo_manage_topology.html
revdate: July 29, 2022
---

# Joining a topology with manage-topology

To join an existing PingAuthorize Server to an existing PingDirectory Server topology, you can use the `manage-topology add-server` command to provide connection information for one of the PingDirectory Servers. This PingDirectory Server must be running when you execute the `setup` tool.

The following table lists the options that specify connection information for a PingDirectory Server. To see this command's complete set of options, run `manage-topology add-server --help`.

| Option                             | Description                                                                                                                                                                                                                                                                                                                                                    |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--remoteServerHostname`           | The address of a PingDirectory Server in the topology to be joined.                                                                                                                                                                                                                                                                                            |
| `--remoteServerPort`               | The LDAP / LDAPS port for communication with the PingDirectory Server.                                                                                                                                                                                                                                                                                         |
| `--remoteServerConnectionSecurity` | The type of security to use when communicating with the remote server. This value can be:- `useSSL`

  Indicates that the communication should be encrypted with SSL

- `useStartTLS`

  Indicates that the communication should be encrypted with the StartTLS extended operation

- `noSecurity`

  Indicates that the communication should not be encrypted |
| `--remoteServerBindDN`             | The DN of the account to use to authenticate to the PingDirectory Server, such as `cn=Directory Manager`. This account must be able to modify the configuration of the target server.                                                                                                                                                                          |
| `--remoteServerBindPassword`       | The password for the account to use to authenticate to the PingDirectory Server.                                                                                                                                                                                                                                                                               |
| `--remoteServerBindPasswordFile`   | The path to a file containing the password for the account to use to authenticate to the PingDirectory Server.                                                                                                                                                                                                                                                 |
| `--adminUID`                       | User ID of the topology-wide administrator. This is typically the account used to enable replication for the PingDirectory Servers.                                                                                                                                                                                                                            |
| `--adminPassword`                  | The password of the topology-wide administrator.                                                                                                                                                                                                                                                                                                               |