Resolving path names expand/collapse all
Related Topics

Limitations when authoring in ArcMap

expand/collapse item About resolving path names

Because relative path names are not supported by ArcMap Server, if your map document contains one or more of them, you must resolve them before serving the map document.

The different types of path names are:

If you are using relative path names, you need to change them to absolute or UNC paths. In addition, if you are using Solaris or Linux, all path names must be UNIX-compliant.

If all of the layers in your map document reference ArcSDE data, your map document does not use relative path names, so you do not need to resolve them.

Path names referencing data must be all lower case.

expand/collapse item How to resolve path names

expand/collapse item Checking path names in ArcMap

Use the following steps to ensure your map document uses full path names rather than relative path names by performing the following procedure in ArcMap.

  1. Open your map document in ArcMap.
  2. Click File | Map Properties.
  3. Click Data Source Option.
  4. Click Store full path names.
  5. Click OK.
  6. Click OK.

expand/collapse item Changing path names to UNC paths

If you want to point to data using UNC paths, you must set the data source of each layer individually:

  1. Open your map document in ArcMap.
  2. Right-click the layer in the ArcMap table of contents.
  3. Click the Source tab.
  4. Click Set Data Source. The Data Source dialog box appears.
  5. Click the Look in dropdown arrow and click the folder containing the correct data.
  6. Click Add.
  7. If the data source you want isn't listed in the dropdown box, click Connect to Folder. UNC references to data on other machine will be listed in the form \\computername.
  8. Navigate to the correct computer and folder and click OK. Click Add.

When creating map services with UNC references to data on a remote machine, make sure that the user name and password used to start the ArcIMS Monitor service has sufficient privileges to access the data remotely.

expand/collapse item Changing path names to be UNIX-compliant

Because ArcMap creates map documents only for the Windows platform, you must make path names to shapefiles and images UNIX-compliant.

  1. In ArcMap, create the map document using absolute paths.
  2. If you want to serve a map document (.mxd), skip to step 8.
  3. If you want to serve a published map file (.pmf file), install and activate ArcMap's Publisher extension if you haven't already. For more information on installing and activating this extension, see ArcMap's online Help.

    In ArcMap, the Publisher menu and toolbar buttons display.

  4. In the Publisher menu, click Settings.
  5. In the Publisher Settings dialog box:

    • Click the Application tab.
    • Uncheck Open in ArcReader only.
    • Check Unrestricted access to the contents of the published map.
    • Click OK.
  6. In the Publisher menu, click Publish Map. Save the map document as a .pmf file.
  7. Open ArcCatalog and make sure you have turned on the Publisher extension in ArcCatalog.
  8. In ArcCatalog, navigate to the file you wish to serve (.mxd or .pmf file).
  9. Right-click on the file and select Set Data Source(s).
  10. In the Set Data Source(s) dialog box:

    • In the Output file text box, use standard Windows controls to navigate to a directory that can be accessed, then specify a file name.
    • If you do not choose a new location or file name, a new file is created in the current location with a file name prefix "Copy_of" added to the current file name.
    • In the Data Frame area, choose a specific data frame you want to change path names in, or display all data frames in the file you wish to serve by selecting All data frames.
    • In the New Data Source column, click the layer with the path name you want to change to be UNIX-compliant. You can use standard Windows controls to select multiple layers or click Select All to select all items, provided they all have the same path.
    • Click Replace.
    • In the Replace dialog box, in the Replace With text box, type a UNIX-compliant path name.

      If only part of the path name is not UNIX-compliant, you can specify that only part of the path name be replaced by typing the non-compliant part in the Find What text box.

    • Click Replace.
    • Repeat the replacing steps above (starting with the 3rd bullet) for each path names you want to make UNIX-compliant.
    • Click OK.
    • If you still have trouble, double-check that all the data being referenced in the map document can be accessed by the UNIX machine housing the map document. Make sure the data path and the data name are in lowercase characters and that data resides on UNIX-compliant machines.
    • If you're serving a .pmf file, note that even though much of this procedure involves adjusting path names, your initial map document (.mxd file) must still not contain relative path names.
    • Path names pointing to join tables, text files, and CAD world files cannot be updated.


Search code: @arcmap_resolve_path