Summary
Legacy:
Starting at ArcGIS 10.1 for Server, Map Server Definition (.msd) files have been replaced with Service Definition Draft (.sddraft) and Service Definition (.sd) files. Please use the Upload Service Definition Geoprocessing tool instead.
Publishes an existing map service definition (MSD) file to a designated ArcGIS Server.
Discussion
Starting at ArcGIS 10.1 for Server, Map Server Definition (.msd) files have been replaced with Service Definition Draft (.sddraft) and Service Definition (.sd) files. See the following help topic for more information: What to expect when migrating to ArcGIS Server.
Automating the publishing of a Map Document to a GIS Server using ArcPy is a four-part process. The first step is to run the CreateMapSDDraft function. The output created from CreateMapSDDraft is a Service Definition Draft (.sddraft) file. A Service Definition Draft is the combination of a Map Document, information about the server, and a set of service properties. The output Service Definition Draft file can then be analysed for suitability and potential performance issues using the AnalyzeForSD function. The Service Definition Draft can then be converted to a fully consolidated Service Definition (.sd) file using the Stage Service Geoprocessing tool. Staging compiles all the necessary information needed to successfully publish the GIS resource. If you have chosen to copy data to the server, the data will be added when the Service Definition Draft is staged. Finally, the Service Definition file can be uploaded and published as a GIS service to a specified GIS server using the Upload Service DefinitionGeoprocessing tool. This step takes the Service Definition file, copies it onto the server, extracts required information, and publishes the GIS resource. For more information, see overview of the Publishing toolset.
Syntax
PublishMSDToServer (msd_path, connection_url_or_name, server, service_name, {folder_name}, {service_capabilities}, {connection_username}, {connection_password}, {connection_domain})| Parameter | Explanation | Data Type |
msd_path | A string that represents the path and name of an existing MXD document you want to serve. | String |
connection_url_or_name | A string that represents the URL of the ArcGIS Server to which you want to publish the MSD. | String |
server | A string that represents the ArcGIS Server host name to which you want to publish the MSD. | String |
service_name | A string that represents the name of the service. This is the name people will see and use to identify the service. The name can only contain alphanumeric characters and underscores. No spaces or special characters are allowed. The name cannot be more than 120 characters in length. | String |
folder_name | A string that represents a folder name to which you want to publish the MSD. If the folder does not currently exist, it will be created. The default folder is the server root level. | String |
service_capabilities [service_capabilities,...] | A list of strings that represents additional capabilities in addition to the map service capability.
(The default value is MAPPING) | String |
connection_username | A string that represents a user name used to connect to the ArcGIS Server. To publish a map service, this user name should be a member of the ArcGIS Server admin group. This variable is only necessary when connecting to a UNIX/Linux ArcGIS Server. (The default value is None) | String |
connection_password | A string that represents a password used to connect to the ArcGIS Server. This variable is only necessary when connecting to a UNIX/Linux ArcGIS Server. (The default value is None) | String |
connection_domain | A string that represents a domain name used to connect to the ArcGIS Server. This variable is only necessary when connecting to a UNIX/Linux ArcGIS Server. (The default value is None) | String |