Licensing and deployment

In this topic

• Licensing
• ArcGIS Server
• ArcIMS
• Deployment
• Preparing the Web Mapping Application during creation and development
• Installing software, data, and services on the production server
• Deploying the Web site to the production Web server
• Enabling the Web site folder as a Web application in IIS
• Updating settings for servers, services, and identity

Licensing

ArcGIS Server

• Basic
• Standard
• Advanced

• Workgroup
• Enterprise

ArcIMS

Deployment

Preparing the Web Mapping Application during creation and development

• Service names—Use the same names for map services and other services as you'll use on the production server. If different names are used, configuration changes will need to be made to the Web site files.
• Data layers and schemas—Use the same data layers in each service as those that will be used during production. At a minimum, use data layers with the same schemas (field names) and spatial references as those that will be used in production. Layers can have different numbers of features (records). Controls in the Web Mapping Application, such as MapTips and QueryAttributeTask, store information such as layer position in the map and field names. If the layer names or fields differ, the Web Mapping Application may fail.
• Server names—Use the same GIS server names for services as those that will be used in production if possible. If different server names are used at deployment, you'll need to modify the configuration of the application. For details on these modifications, see the Updating settings for servers, services, and identity subsection.
• ArcGIS identity—When using ArcGIS Server local services, you must add an identity—with domain, username, and password—to the Web application. ArcGIS Server Manager (Manager) automatically encrypts and stores the identity when adding the ArcGIS Server machine to Manager. If you are using Visual Studio to create the application, add the identity with the Add ArcGIS Identity utility. You can encrypt this identity as well. When you deploy the application, you must update the identity credentials.
• Precompiling applications—If you're using ASP.NET to precompile the Web application before deployment, set the values for the server and services on the production server before compilation. For information on changing values before precompilation, see the Updating settings for servers, services, and identity subsection.
• Turn debugging off—If you developed or customized the Web Mapping Application in Visual Studio, turn debugging off in the application before deployment. Debug versions cause slower performance and are normally unnecessary on deployment servers.

1. Open the web.config file in a text editor, and if the <compilation> tag exists, change the debug value from true to false as shown in the following code:

 < compilation debug = "false" >

2. Save the web.config file.
3. Check each .aspx page to ensure that if the <@Page> directive at the top of the file contains a Debug attribute, it is set to false.
4. If you customized your Web application by adding a dynamic-link library (DLL) from another project, confirm that you have a release version of that DLL. The DLL is located in the bin folder in your Web application. Typically, a release version has no .pdb file with the .dll file. If it does have a .pdb file, its date is older than that of the .dll file.

Installing software, data, and services on the production server

• Required software—Install the following software on the production Web server (in this order):
• IIS
• .NET Framework (same version used during development)
• ESRI Web ADF Runtime

• Optional installations—The following software can be installed on the production server:
• Visual Studio 2005
• Visual Web Developer Express 2005 (VWDE)
• ESRI Web ADF full install with server software (instead of ADF Runtime)

• Data and GIS servers—If needed, install data (files and ArcSDE) and GIS software (ArcGIS Server and/or ArcIMS) on servers that are accessible to the production Web server. See the ArcGIS Server Help for information on installing and configuring those software packages.
• If the Web application uses ArcGIS Server, the edition used in deployment must support the functionality used in the application. For example, if the Web application performs editing using the Editing task, the Advanced edition of ArcGIS Server is required.
• If you're using a GIS server (ArcGIS Server and/or ArcIMS) for production that was not used for development, create services with the same data used during development. Use the same name for services if possible. Use the same data layer names with the same schemas (field names). The easiest approach is to use the same projects (MXD, AXL, LOC files, and so on) as those used in development. If the data layer names or fields differ, the Web Mapping Application may not perform as expected on the production server. The data layers can differ in number of features (records) and in values within records and fields.
• See the product Help and the ESRI Support Center Web site for documents on distributed and fail-over configurations for ArcGIS Server or ArcIMS.
• User and role data—If you secured your application with Manager (or other standard method), you may need to copy the user and role data from the development environment to the production environment.
• Windows Server 2003—If you're using Windows 2003 Server, you may need to allow ASP.NET applications. In IIS Manager, go to <Server name> > Web Service Extensions. If ASP.NET v2.0.xxxx is not marked as Allowed, select it in the list and click Allow.

Deploying the Web site to the production Web server

• Copy the Web site (Xcopy deployment)
• Uses a command prompt to copy the entire folder to another computer.
• Similar to copy/paste (for example, in Windows Explorer) but with additional options. It's possible to use Windows Explorer by itself, but you may miss hidden files and attribute settings on files.
• See the Microsoft Help and Support Web site for Xcopy options and examples and the Microsoft article How to deploy an ASP.NET Web application using Xcopy deployment.
• Visual Studio 2005 Copy Web Site tool
• To use the Copy Web Site tool, you must be able to connect to the deployment server in one of three ways: a mapped drive, an FTP site, or a FrontPage Server Extension. For information on installing FrontPage Server Extensions, see Installing and Enabling FrontPage Server Extensions on the Microsoft Web site.
• For details on using the Copy Web Site tool, see the Visual Studio Help topic Copying Web Sites with the Copy Web Site Tool.
• Zip file
• Use a Zip file if you cannot map a drive to the deployment server, or cannot use the Visual Studio Copy Web Site tool. This option can skip hidden files and file attributes.
• When creating a Zip file of the Web site, include subfolder paths in the Zip file.
• Installer package
• If you created a Web application that will be deployed on multiple servers, you can create an installer package for the Web site. See online resources or books on ASP.NET for information on creating installer packages.

Enabling the Web site folder as a Web application in IIS

1. Open IIS Manager from Control Panel > Administrative Tools.
2. Expand the left panel of IIS Manager to find your Web site location. In Windows 2003 Server, the Web site is in the Web Sites subfolder in the left panel. By default, folders in wwwroot are located in the Default Web Site tree.
3. Right-click the WebSite folder and select Properties. The Web Site Properties dialog box opens.
4. Click the Directory tab.
5. Click the Create button under Application Settings. This sets the Web site name in the Application name box and changes the button name to Remove. (If the button already says Remove, the Web site is already set as an application.)
6. Confirm that Execute permissions is set to Scripts only.
7. Click OK and close IIS Manager.

1. Open IIS Manager from Control Panel > Administrative Tools.
2. Expand the left panel of IIS Manager and click the Default Web Site item. This displays Web sites currently set up for use in IIS.
3. Right-click Default Web Site, select New, and click Virtual Directory. The Virtual Directory Creation Wizard opens.
4. Click Next. The Virtual Directory Alias panel opens.
5. Type a name for the Web site. This is the name users will use to get to the Web site. For example, if you name the Web site MapViewer1, the uniform resource locator (URL) for the site will be http://<server name>/MapViewer1.
6. Click Next. The Web Site Content Directory panel opens.
7. Click Browse, navigate to the WebSite folder you copied to the production server, and click Next. The Virtual Directory Access Permissions panel opens.
8. Check the boxes for Read and Run scripts, and click Next.
9. Click Finish and close IIS Manager.

Updating settings for servers, services, and identity

1. Open the Web application.
2. Double-click the default.aspx page, click the Design view tab, and set the resource manager values (MapResourceManager and any others used, such as GeocodeResourceManager).
3. Use the smart tag on the ResourceManager control to edit the resource properties.

1. Identify the server, service names, and usernames and passwords that need to be updated. If necessary, open the Web application on the development machine and record the values in the MapResourceManager, GeocodeResourceManager, and GeoprocessingResourceManager controls. Determine the new values for the corresponding servers and services on the deployment machine.
2. Open default.aspx in a text editor (such as Notepad) or development environment (such as Visual Studio). If you customized the Web application by adding pages with additional ADF resource managers, update the values for server and services on those pages as well.
3. Search for the GIS server name used during development, and replace this value with the GIS server to be used in deployment. For ArcGIS Server Internet or ArcIMS Hypertext Transfer Protocol (HTTP) resources, obtain the correct server URL (for example, http://<servername>/arcgis/services), then update map and other service names if they are different from those on the production GIS server. These values can be in tags for a MapResourceManager, GeocodeResourceManager, or GeoprocessingResourceManager control. Replace only the server or service values. Preserve the escaped version of quote (&quot;) and other characters. Do not add extra spaces or characters to the resource strings.
4. If the production GIS server uses ArcGIS Server local resources, see the ArcGIS identity subsection for more information.
5. If the production GIS server requires that you add a username and password for ArcIMS, ArcGIS Server Internet resources, or if these values are different from those used on the development server, add or modify these identity values. The Identity portion of the Definition attributes for the resource managers must be set to values that are valid for the production GIS server.

1. Open the Web application.
2. Set the identity for each resource manager, save the page, and copy it to the production server. If the login for the production server is not recognized on the development machine, you can create an identity in a temporary resource item or page without running the page, then copy the identity value from the page.
   
   An example of a resource item definition with an identity value is shown in the following code:

 < esri: mapresourcemanager id = "MapResourceManager1" runat = "server" >  <
     ResourceItems >  < esri: MapResourceItem Name = "World"Definition = 
     "<Definition DataSourceDefinition=&quot;localhost@5300&quot; DataSourceType=&quot;ArcIMS&quot; Identity=&quot;WMYMENUMWCPZUKYRAIIBDEFBPZ&quot; ResourceDefinition=&quot;World&quot; DataSourceShared=&quot;True&quot; />"DisplaySettings = "visible=True:transparency=0:mime=True:imgFormat=PNG8:height=100:width=100:dpi=120:color=:transbg=False" /  >  <  / ResourceItems >  <  / esri: mapresourcemanager >

1. Click Start-Run to open a command prompt, type cmd, and click OK.
2. Change to the DotNet directory in your ArcGIS Developer Kit installation folder. For example, type cd "C:\Program Files\ArcGIS\DeveloperKit10.0\DotNet" and press Enter (use quotation marks around the path when it contains spaces).
3. Enter the command to create the encrypted identity by using the -i option for adfutil. Include the username and password, separating the two with a semicolon, for example:

4. Enter this identity into the Identity setting in the resource manager Definition string. For example, if the encrypted string is bDQLnmv1Mwkh9@3PKMbB0C==, the Identity part of the Definition would be set as follows:

Identity = "
bDQLnmv1Mwkh9@3PKMbB0C ==  & quot;