This project is read-only.

Beyond Version 2.1 Code In-Progress Notes

About

If you've connected to the latest branch of the ArcGIS Editor for OSM project, you are working with the in-progress version of the ArcGIS Editor for OSM. See Working with the Code for tips on setting up your development environment. The overarching user stories supported in the upcoming version can be found in the What's Next topic.

System Requirements

Important: if you have an earlier version of ArcGIS Editor for OSM installed, you should uninstall this before installing a newer version

Because Version 2.1 offers a Server component and/or a Desktop component, the system requirements differ depending on which components are installed. See the requisite sections below for the Desktop and Server components.

Desktop component requirements

  • ArcGIS 10.0 or 10.1 for Desktop. Note: ArcGIS for Desktop must be installed before the ArcGIS Editor for OpenStreetMap can be installed.

Server component requirements

Operating Systems
The following operating systems have been tested with the Server Component. If you find other OS that work well, please let us know. Note, 32 bit systems are not supported for the Server Component with the version 2.1 and above.
  • Windows 2003 Server SP2 64 bit (note - will not work with MS SQL Server - see known issue 11233.
  • Windows 2008 Server 64-bit
  • Windows 2008 R2 Server 64-bit
  • Windows 7, 64-bit

Internet Information Services (IIS)
IIS is required for the Server component,and you must enable the following role services:

Web Server
  • Common HTTP Features
    • Static Content
    • Default Document
    • HTTP Errors
  • Application Development
    • ASP .NET
    • ISAPI Extensions
    • ISAPI Filters
  • Health and Diagnostics
    • HTTP Logging
  • Security
    • Basic Authentication
    • Windows Authentication
Management Tools
  • IIS Management Console
Third Party Components
The installer checks for certain third party components. If not present, a dialog will appear giving you the option to agree to their license and install them, or exit the installation.
  • Microsoft SQL Server Compact 4.0
  • Microsoft ASP.Net MVC3
  • Microsoft Entity Framework

ArcGIS for Server
One of the following should be installed on the machine hosting the ArcGIS Editor for OSM Server component:
  • ArcGIS for Server 10.0 SP3 or higher (.NET) (GIS Services) should be installed on the machine hosting the ArcGIS Editor for OSM Server component. Note: ArcGIS 10 for Server (Java) is not supported.
  • ArcGIS for Server 10.1

ArcSDE
ArcSDE can be installed locally or on a different server. Note that if installed on a different server, you may need to add an entry (e.g., esri_sde 5151/tcp #ArcSDE) for the sde service in the local c:\windows\system32\drivers\etc\services file. You can update the \\<serverName>\C$\inetpub\wwwroot\OSM\web.config file for where the SDE file is: <add key="DatabaseConnection" value="C:\Data\OSM\Mxds\osmdevsde.sde" />

Both the windows service or the direct connect setups for ArcSDE will work.
  • ArcSDE for SQL Server
    • SQL Server 2005 SP2 & SP3 (32-bit)
    • SQL Server 2005 SP2 & SP3 (64-bit)
    • SQL Server 2008 Final - R2 (64-bit)
    • SQL Server Express 2008 R2 (64 bit)
  • ArcSDE for Oracle
    • Oracle 11g R2 (64-bit) 11.2.0.1
  • ArcSDE for Postgres
    • PostgreSQL 8.4.9-1 (32-bit)

Installation

Important: if you have an earlier version of ArcGIS Editor for OSM installed, you should uninstall this before installing a newer version

ArcGIS Editor for OSM version 2.1 is available for version 10.0 or 10.1 of ArcGIS. Follow the relevant section below for your ArcGIS version.

Install on ArcGIS 10.0 Environment

If you are using ArcGIS 10.0, then the installer will include installation options for both the Desktop and the Server Component for ArcGIS Editor for OSM. See the Installation for how to guidance to install on ArcGIS 10.0.

Install on ArcGIS 10.1 Environment

For the ArcGIS 10.1 environment, there are separate installers for the Desktop and Server Components. The ArcGIS Editor for OSM Server and Desktop components operate independent from one another; this means that you don’t have to have one installed for the other to work. You can install one or both on your environment.

Desktop Component for 10.1
To install the ArcGIS Editor for OSM Desktop component on ArcGIS 10.1, run the setup.exe. Accept the license, and then choose an installation directory. Continue to click through the wizard, and then click Finish at the end. After installation, a page will launch with instructions for how to get started with the Desktop tools. After installation of the Desktop component, three items are installed to your ArcGIS Desktop environment:
  • A set of geoprocessing tools and models to download, extract, and upload vector data from and to the OpenStreetMap server.
  • Customizations to the core editor environment in ArcMap to handle the OpenStreetMap tags inside the core Esri software.
  • A conflict editor user interface to similar to the Reconcile Version tool for enterprise geodatabases.

Note - the installer will put the OpenStreetMap Toolbox in your ArcGIS System Toolbox.

Server Component for 10.1
To install the ArcGIS Editor for OSM Server component on ArcGIS 10.1, you will need to work through the screens the installer presents carefully. The installer has many automatic checks for connections to ensure that the information you provide is adequate for installing the server component. You may notice a delay after inputting information in the wizard screen – this occurs because the installer is doing those checks. Follow the steps below.
  • Launch the installer by double-clicking the setup.exe. Begin the installation, accepting the license presented.
  • Upon accepting the license, you will be notified that in addition to installing the ArcGIS Editor for OSM Server component, the installation will also install three other components – Microsoft SQL Server Compact 4.0, Microsoft ASP.Net MVC3, and Microsoft Entity Framework – if not already present. These components have a different license than the license for the ArcGIS Editor for OSM, and so you will be prompted to accept the licenses for those components later in the installation process. Click “Yes” to acknowledge this and proceed to the next screen.
additional_components.png
*On the next screen, you will enter information that connects the ArcGIS Editor for OSM with your ArcGIS Server instance, as shown and described below:
server_installer1.png
  • Server Name: Name of the server hosting ArcGIS Server.
  • Instance URL: The URL to your ArcGIS Server instance.
  • ArcGIS Server Primary Site Administrator Account: This is the username and password of the ArcGIS Server user who can access the ArcGIS Server site where your services will be created and maintained.
  • Publishing User: The username and password of an ArcGIS Server user who can publish services. If this user should be the same as the ArcGIS Server Primary Site Administrator Account, check the box that indicates this.
  • Click Next. The next screen shows more parameters for creating your feature service. Fill out the fields as shown and described below:
server_installer2.png
  • OSM Application Admin User: username and password to a user who has access to the inetpub directory for IIS, and the local folder structure for creating/storing the generated mxd files. If this user should be the same as the ArcGIS Server Primary Site Administrator Account, check the box that indicates this.
  • Directories - Working Folder: where the template MXDs and ArcSDE geodatabase information is stored. Default is C:\Data\OSM.
  • Directories - Output Folder: where the output MXD ArcGIS Server uses for the feature service is stored. Default is C:\arcgisserver\directories\arcgisoutput.
  • SDE Platform: Indicate which of the three supported database platforms you are using for SDE.
  • Click Next. Now you will be presented with fields to further describe the SDE connection. Fill these out as shown and described below:
server_installer3.png
  • Database Server instance: servername of the machine hosting sde service (must be accessible to the machine upon which ArcGIS Editor for OSM - Server is being installed).
  • Database: name of the sde database
  • User Name: sde username
  • Password: sde password
  • Version: version of the sde database (typically 'sde.DEFAULT')
  • Click Next. Now you will be presented with a file path to where the ArcGIS Editor for OSM Server files will be installed. Change this if you like, and click Next to proceed with the installation. Important: this is not an installer you can just leave - remember that you will be prompted to accept licenses from the three Third Party Components. The installer will eventually timeout if you don't respond to prompts.
  • When the installer is finished, a page will launch with instructions on how to access your new feature service creation interface and what to do next. See ArcGIS Editor for OSM Feature Service for how to use the newly installed Feature Service interface. If you have installed the Server component and your Operating System is Windows XP or Windows Server 2003, you will need to carry out some Post-Installation Steps.
  • Important: After the installation completes, check that the datastore was correctly created. For steps to check the datastore, see "About registering your data with the server". If you saw an error that looked like the following during installation, then you'll need to verify the registration. Steps are also provided below.

register_with_AGS_Error.png

To remedy this, you'll need to register your datastore with the ArcGIS Server instance after the installer completes. If you proceed with creating feature services with the Create Feature Service interface, your services will not be created successfully and contain errors.

First, open ArcCatalog and create an Administration connection to the ArcGIS Server instance where you installed the ArcGIS Editor for OSM Server Component. After creating the Administrative connection, right click on the connection and select "Server Properties", as shown below:

register_with_AGS.png

When the Server Properties dialog opens, select the 'Data Store' tab. On the Data Store tab, if there is an existing connection showing in the 'Registered Databases' window, remove it. Now, assuming there is no connection is showing in the Registered Database window, click the large Plus button to the right. You will have the option to add or import a connection file. Select 'Import', and browse to the connection file at the location where the ArcGIS Editor for OSM Server Component stores its mxd information, e.g., C:\Data\OSM\MXDS by default. Select the file with the ".sde" suffix, as shown below.

register_with_AGS2.png

After adding this connection, there should be a green checkmark next to the connection in the Registered Databases window. You can close the dialog, and proceed with using the installed ArcGIS Editor for OSM Server Component (no need to reinstall or restart any services).

Things to Test

Having just released version 2.1, please read the What's New topic for new functionality to try out.

Contributing Feedback

Please submit feedback on this software. We welcome found issues, defects, enhancement ideas, or your user stories. See How to Contribute.

Known Issues

Please see Known Issues 2.1.

Last edited Dec 12, 2012 at 12:28 AM by eggwhites, version 54

Comments

No comments yet.