Join Site

Description

The joinSite operation connects a portal machine to an existing site. You must provide an account with administrative privileges to the site for the operation to be successful.

When an attempt is made to join a site, the site validates the administrative credentials, then returns connection information about its configuration store back to the portal machine. The portal machine then uses the connection information to work with the configuration store.

If this is the first portal machine in your site, use the Create Site operation instead.

The joinSite operation:

The operation is time-consuming as the database is configured on the machine and all configurations are applied from the active machine. After the operation is complete, the web server that hosts the API will be restarted.

Request Parameters

Parameter

Details

machineAdminUrl

The admin URL of the existing portal site to which a machine will be joined

username

The username for the initial administrator account of the existing portal site.

password

The password for the initial administrator account of the existing portal site.

f

The formatting parameter. Default is html.

Values: json | html

Example Usage

https://<portaladmin>/joinSite
machineAdminUrl=https://portalhost.domain.com:7443
username=admin
password=admin.secret

JSON Response Example

{
"status":"success",
"recheckAfterSecs":10}

7/5/2017