- URL:https://<site-url>/createNewSite(POST only)
- Required Capability:Default administrator role
- Version Introduced:10.1
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
Parameter | Description |
---|---|
username | The name of the administrative account to be used by the site. This can be changed later. Example
|
password | The credentials of the administrative account. Example
|
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
|
directories | A JSON object representing a collection of server directories to create. By default, the server directories are created locally. Example
|
settings | Optional log settings. Example
|
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