Summary
Enterprise geodatabases are licensed through an ArcGIS Server authorization file. The geodatabase stores this authorization information to allow access to the geodatabase.
If your organization licenses ArcGIS Server for a set time period, your geodatabase administrator can run the Update Enterprise Geodatabase License tool with a new ArcGIS Server authorization file to update license information in the geodatabase before the existing license expires. This allows clients to continue working with the geodatabase without interruptions caused by expired licenses.
Usage
The input workspace must be an enterprise geodatabase. This tool does not work with file, personal, desktop, or workgroup geodatabases.
You must connect to the enterprise geodatabase as the geodatabase administrator to run this tool.
Syntax
arcpy.management.UpdateEnterpriseGeodatabaseLicense(input_database, authorization_file)
Parameter | Explanation | Data Type |
input_database | Provide a database connection (.sde file) to the enterprise geodatabase you want to authorize with a new ArcGIS Server enterprise authorization file. You must connect to the database as the geodatabase administrator. | Workspace |
authorization_file | Provide the path and file name of the keycodes file generated when you authorized ArcGIS Server enterprise. If necessary, copy the file from the ArcGIS Server machine to a directory that the tool can access. ArcGIS Server creates the keycodes file in the following location: \\Program Files\ESRI\License<release#>\sysgen (Windows servers) or /arcgis/server/framework/runtime/.wine/drive_c/Program Files/ESRI/License<release#>/sysgen (Linux servers). | File |
Derived Output
Name | Explanation | Data Type |
out_workspace | The updated enterprise geodatabase. | Workspace |
Code sample
The following script can be run in a Python window to update license information in an enterprise geodatabase.
In this example, the database connection file is enterprisegdb.sde and is located in a folder named gdbs. The keycodes file was copied to the temp folder.
import arcpy
ent_gdb = "C:\\gdbs\\enterprisegdb.sde"
authorization_file = "C:\\temp\\keycodes"
arcpy.UpdateEnterpriseGeodatabaseLicense_management(ent_gdb, authorization_file)
The following is a stand-alone Python script you can alter and use to update the license information in an enterprise geodatabase.
In this example, the database connection file is enterprisegdb.sde and is located in a directory named gdbs in the geodatabase administrators usr directory. The keycodes file was copied to a directory named scratch.
# Import arcpy module
import arcpy
# Local variables:
ent_gdb = "/usr/gdbs/enterprisegdb.sde"
authorization_file = "/usr/scratch/keycodes"
# Process: Import authorization information from a new keycodes file.
arcpy.UpdateEnterpriseGeodatabaseLicense_management(ent_gdb, authorization_file)
Environments
Licensing information
- Basic: No
- Standard: Yes
- Advanced: Yes