configureserviceaccount

This topic is not relevant for ArcGIS Enterprise on Linux.

This utility is used for all ArcGIS Data Store types on Microsoft Windows servers.

The configureserviceaccount utility changes the login used for the ArcGIS Data Store account on a single Windows machine.

When you set the account using this utility, you can export the account information to a file. The password is encrypted in the file. You can use this file to import the same account information if, for example, you set up another ArcGIS Data Store and need to use the same account. In that case, run the configureserviceaccount utility on the new machine and import the file with the account information.

You can also use this utility to update the password of the ArcGIS Data Store account. If the password for the Windows account changes, run the utility and specify a new password for the account.

If you set the ArcGIS Data Store account to a group managed service account, the account you specify with the username parameter can include $ at the end of the account name or omit it. You do not need to specify the password parameter when you use a group managed service account.

When you update the account, you must update it for every machine in the data store. For example, if you update the account for a three node spatiotemporal big data store, you must run the configureserviceaccount utility on all three machines

Syntax

configureserviceaccount [--username <Windows account>] [--password <account password>] [--readconfig <user configuration file>] [--writeconfig <user configuration file>]

Option	Description
--username	The network login or group managed service account used for the ArcGIS Data Store account. This option is not required if you use the --readconfig option.
--password	The password for the network login that you specified with the --username option. To change the password for the existing ArcGIS Data Store account, run the configureserviceaccount utility with the --username option and specify the new password with the --password option. This option is not required if you use the --readconfig option or if you specify a group managed service account with the --username option.
--writeconfig	If included when you run the configureserviceaccount utility, this option creates a configuration file containing the credentials provided. Password information is encrypted in the file.
--readconfig	Configures the ArcGIS Data Store account using information stored in a configuration file that was created using the --writeconfig option. When you use this option, no other options are required.

Example

In this example, configureserviceaccount sets the mynetwork\datastore account to run the ArcGIS Data Store service and grants this account the privileges required on ArcGIS Data Store system folders and files.

configureserviceaccount --username mynetwork\datastore --password SewL0ng

In this example, a group managed service account is used for the ArcGIS Data Store account and the information is written to a configuration file in the temp directory:

configureserviceaccount --username example\datastore-gmsa$ --writeconfig c:\temp\domainaccountconfig.xml

Note:

Changing the account under which the service runs causes the service to restart.

In this example, the ArcGIS Data Store account is changed, and the account information is written to a file (adsainfo) at C:\adminfiles.

configureserviceaccount --username mynetwork\datastore --password SewL0ng --writeconfig C:\adminfiles\adsainfo.xml

In this example, ArcGIS Data Store is installed on a different machine, and the administrator runs the configureserviceaccount utility to set the same account using the file created in the previous example.

configureserviceaccount --readconfig C:\adminfiles\adsainfo