After you install ArcGIS Notebook Server and configure it with Docker, create a server site. A site is an individual deployment of ArcGIS Notebook Server and is the server unit that can be federated with the ArcGIS Enterprise portal.
Note:
At 10.7, ArcGIS Notebook Server only supports single-machine sites. You cannot add server machines to the site you're creating.
There are two ways to create the server site. You can either use the ArcGIS Notebook Server configuration wizard, or create the site using the createsite command line utility.
Use the wizard to create your site
The ArcGIS Notebook Server configuration wizard opens once the installation wizard completes. Use the wizard to create an ArcGIS Notebook Server site on the machine.
- In the wizard, provide a user name and password and click Next.
- Type the paths to the directories you want to use for your content directory and configuration store. By default, they will be created under <ArcGIS Notebook Server installation directory>\arcgisserver. You can use different directories on your local drive or on your network for the configuration store, content store, and logs. This location must be accessible to the ArcGIS Notebook Server account, and the account must have read and write permissions to it. Click Next.
- Review the summary page and click Finish to create your site or click Back to make changes.
Note:
The primary site administrator account using this user name and password is recognized only by ArcGIS Notebook Server; it's not an operating system account, and it's managed separately from the user accounts in your user store. The primary site administrator has unrestricted access to the ArcGIS Notebook Server site. This account is typically used to create the ArcGIS Notebook Server site and to configure and manage security. The primary site administrator account shouldn't be confused with the ArcGIS Notebook Server account you provided during installation.When your site is created, proceed to the Configure ArcGIS Notebook Server after installation topic.
Use the createsite utility to create your site
Once ArcGIS Notebook Server is installed, you can use the createsite command line utility to create a server site. To do so, you have the following options:
- Run the createsite utility as the ArcGIS Notebook Server account from the command prompt window, and specify the user name, password, configuration store location, and directory parameters.
- Provide the path to the createsite.properties file that specifies these parameters. This is the recommended option, as it is more secure.
| Parameters | Description |
|---|---|
-u or --username | A user name for the primary site administrator. The user name cannot contain these characters: \:/*?|<>". |
-p or --password | A password for the primary site administrator. The password cannot contain these characters: \:/*?|<>". |
-d or --directory | The root server directory location. By default, the ArcGIS Notebook Server directories are created in the local directory C:\\arcgisserver\\directories or the network directory \\\\<Absolute path to>\\<Server directories>. |
-c or --configstore | The configuration store location for the ArcGIS Notebook Server site. By default, the configuration store is created in the local directory C:\\arcgisserver\\config-store or the network directory \\\\<Absolute path to>\\<Server config-store>. |
-f or --file | The full path to the properties file for the createsite utility, if you're using it to specify your parameters. |
-h or --help | Displays command line help and exits. |
Specify parameters in the utility
If you're specifying parameters in the utility, run the command with the following syntax: createsite.bat [-u <username>] [-p <password>] [-d <directory>] [-c <config-store>]. The arguments are as follows:
The following code example demonstrates keeping default directory and configuration store locations.
<ArcGIS Notebook Server install directory>\tools\createsite\createsite.bat -u notebookPSA -p my.Password3The following code example demonstrates specifying locations other than the defaults.
<ArcGIS Notebook Server install directory>\tools\createsite\createsite.bat -u notebookPSA -p my.Password3 -d C:\\AdminFolder\directories -c C:\\AdminFolder\config-storeSpecify parameters from a file
If you're specifying parameters from a file, run the command to use the createsite.properties file with the following syntax: createsite.bat [-f <filepath>]. A sample template of this file is located in <ArcGIS Notebook Server install directory>\tools\createsite\. The file should use the following syntax:
#
# Configuration properties for ArcGIS Notebook Server site creation
SERVER_ADMIN_USERNAME =
# User name for primary site administrator.
# Cannot contain these characters: \/:*?<>"
SERVER_ADMIN_PASSWORD =
# Password for primary site administrator.
# Cannot contain these characters: \/:*?<>"
SERVER_ADMIN_PASSWORD_ENCRYPTED = false
# Initially, leave SERVER_ADMIN_PASSWORD_ENCRYPTED set to false.
# When you run the tool the first time, the password will be
# encrypted and SERVER_ADMIN_PASSWORD_ENCRYPTED will change to true.
SERVER_DIRECTORIES_PATH =
# Root server directory. By default, the server directories will be created locally.
SERVER_CONFIGSTORE_PATH =
# Configuration store for the ArcGIS Notebook Server site. By default, the configuration store will be created locally.Each file path referenced in the createsite.properties file adds a second backslash, such as C:\\arcgisserver\\directories. This is required by the command line utility.
When you run the utility successfully, a message appears before the tool closes indicating that the ArcGIS Notebook Server site was created.
Once your site is created, proceed to install and configure ArcGIS Web Adaptor with your site.