Setting up the initial topology
About this task
The server.uuid
file in the server’s config
directory indicates whether the server is being set up initially or being updated.
If you’re not using persistent storage, set up a new server and skip step 3. If you are using persistent storage, start on step 3. |
For more information about server profiles, see Server profiles.
Steps
-
Create or obtain the
topology.json
file either manually or by using external automation.When promoting from a dev/test environment to a stage/prod environment, you can obtain a
topology.json
file usingmanage-topology export
. -
To install and configure a server instance, run the
manage-profile
command with thesetup
option.Example:
manage-profile setup \ --profile /path/to/server-profile \ --profileVariablesFile /path/to/instance-specific-variables.properties
-
If you’re using persistent storage, replace the current server profile. Otherwise, proceed to step 4. To replace the current profile, run the
manage-profile replace-profile
command from a second, extracted server install package on the same host as the existing server.Example:
manage-profile replace-profile \ --profile /path/to/server-profile \ --profileVariablesFile /path/to/instance-specific-variables.properties --serverRoot /path/to/existing/server
-
To enable replication within the topology, run
dsreplication
with theenable
option.Example:
dsreplication enable \ --topologyFilePath /path/to/topology.json \ --retryTimeoutSeconds 120
-
To initialize the replication data, run
dsreplication
with theinitialize
option.Example:
dsreplication initialize \ --topologyFilePath /path/to/topology.json