Skip To Content
ArcGIS Developers
Dashboard

Create Site

Description

The createNewSite operation is the first operation that you must invoke when you install ArcGIS Server for the first time. Creating a new site involves the following:

  • Allocating a store to save the site configuration
  • Configuring the server machine and registering it with the site
  • Configuring server directories
  • Deploying the services that are marked to automatically deploy

Because of the number of tasks, it usually takes awhile for this operation to complete. Once a site has been created, you can publish GIS services and deploy them to your server machines.

Note:

This operation is available only when a server machine is not participating in a site.

Request parameters

ParameterDescription
username

The name of the administrative account to be used by the site. This can be changed later.

Example

username=admin
password

The credentials of the administrative account.

Example

password=secret
configStoreConnection

A JSON object representing the connection to the configuration store. By default, the configuration store is maintained in the ArcGIS Server installation directory.

Example

configStoreConnection={
  "type"="FILESYSTEM",
  "connectionString": "\\myshare\config-store",
  "localRepositoryPath": "C:\\arcgisserver\\local"
}
directories

A JSON object representing a collection of server directories to create. By default, the server directories are created locally.

Example

directories={
  "directories": [
    {
      "name": "arcgiscache",
      "physicalPath": "C:\\arcgisserver\\directories\\arcgiscache",
      "directoryType": "CACHE",
      "cleanupMode": "NONE",
      "maxFileAge": 0,
      "description": "Stores tile caches used by map, globe, and image services for rapid performance"
    },
    ...
  ]
}
settings

Optional log settings.

Example

settings={
  "logLevel": "INFO",
  "logDir": "C:\\arcgisserver\\logs\\",
  "maxErrorReportsCount": 10,
  "maxLogFileAge": 90
}
runAsync

A flag that indicates if the operation needs to be run asynchronously.

Values: true | false

f

The response format. The default response format is html.

Values: html | json | pjson

Example usage

Below is a sample POST request for createSite, formatted for readability:

POST /arcgis/admin/createNewSite HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

username=admin&password=secret&configStoreConnection={
  "type"="FILESYSTEM",
  "connectionString": "\\myshare\config-store",
  "localRepositoryPath": "C:\\arcgisserver\\local"
}&directories={
  "directories": [
    {
      "name": "arcgiscache",
      "physicalPath": "C:\\arcgisserver\\directories\\arcgiscache",
      "directoryType": "CACHE",
      "cleanupMode": "NONE",
      "maxFileAge": 0,
      "description": "Stores tile caches used by map, globe, and image services for rapid performance"
    },
    {
      "name": "arcgisjobs",
      "physicalPath": "C:\\arcgisserver\\directories\\arcgisjobs",
      "directoryType": "JOBS",
      "cleanupMode": "TIME_ELAPSED_SINCE_LAST_MODIFIED",
      "maxFileAge": 360,
      "description": "Stores results and other information from geoprocessing services"
    },
    {
      "name": "arcgisoutput",
      "physicalPath": "C:\\arcgisserver\\directories\\arcgisoutput",
      "directoryType": "OUTPUT",
      "cleanupMode": "TIME_ELAPSED_SINCE_LAST_MODIFIED",
      "maxFileAge": 10,
      "description": "Stores various information generated by services, such as map images"
    },
    {
      "name": "arcgissystem",
      "physicalPath": "C:\\arcgisserver\\directories\\arcgissystem",
      "directoryType": "SYSTEM",
      "cleanupMode": "NONE",
      "maxFileAge": 0,
      "description": "Stores directories and files used internally by ArcGIS Server"
    }
  ]
}&settings={
  "logLevel": "INFO",
  "logDir": "C:\\arcgisserver\\logs\\",
  "maxErrorReportsCount": 10,
  "maxLogFileAge": 90
}&runAsync=true&f=json