Migrating XMap Between Computers

Transcription

1 Migrating XMap Between Computers Table of Contents Introduction... 2 Can I simply copy and paste my data over to my new computer?... 2 Preparation... 2 Draw and Route Files... 2 GIS Layers... 2 Base Datasets... 3 Netlink Data... 3 Using Properties to Find Datasets Locations... 3 Final Preparations... 4 Migration Procedure... 5 Base Datasets... 5 Netlink Data... 5 GIS Layers... 5 Moving GIS Layers by using Openspace files... 5 Moving GIS Layers by Using Copy Layer... 7 Moving GIS Databases Using SQL Server Management Studio... 9 Moving GIS Layers Using Bulk Import/Export... 9 Draw and Route Files... 9 Project File Clean Up Handling Disconnected or Deleted GIS Layers Replacing Old Map Datasets When All Steps Fail Page 1 of 11

2 Introduction The purpose of this document is to provide instructions for retaining and migrating data and files created in XMap to a new installation of the program on a different computer. This document is not for users who are upgrading versions of XMap on the same computer. A new version of XMap features built-in tools for migrating data between versions of the program installed on the same computer. Can I simply copy and paste my data over to my new computer? Unfortunately, due to the file structure of XMap, you will see as you progress through this document that you cannot simply copy over files from the old computer to the new computer and expect everything to work. The only way this would be possible is if the new computer is an exact copy of the old computer. That means everything has to be the same including: Computer name Registry entries Folder structure SQL Instance name The new system has to be a 100% duplicate of the old. In most cases this is not possible. For a better user experience XMap stores data folder references in registry and project file entries which makes moving files around outside of XMap very difficult. If possible, keep your old system working as you make the migrate steps to the new computer. This will make migrating a lot easier in the long run. Preparation Before you begin you will need to figure out where your files are stored on the original computer. Draw and Route Files Most user draw or route files are stored in the DeLorme Docs folder that was installed to your computer when you installed XMap. Depending on your version of XMap the folder could be stored off the root of your C:\drive or in your Documents folder. GIS Layers GIS layers are stored in a SQL Server installed to your local computer when XMap was installed or on a SQL Server somewhere on your network. If you go to the GIS tab the location of each layer is displayed in the Workspace table. In the example below the Triple D layer is stored in the NEIGHBORHOOD database in the LINNEUS\XMAP7 SQL Server instance. Page 2 of 11

3 Base Datasets These are large datasets that usually come with XMap and are stored on the hard drive or read straight off the install disc. Netlink Data Data you downloaded from Netlink is stored in a public folder. Usually the folder is located at C:\Users\Public\Documents\DeLorme Docs\Netlink\Downloads Using Properties to Find Datasets Locations One feature that might come in handy is using the Properties Wizard of a dataset to figure out where data is stored. Note: These steps will not work with all datasets. 1. Open a XMap project associated with your dataset. 2. Click the plus sign next to the dataset to expand the dataset to the lowest level. 3. Right-click on the dataset and click Properties. Note: Not all datasets have properties that you can access. 4. Click Next to move to a window that shows the path of the data. The patch can be found on the Data Positioning page or the Data Zoom Control. Page 3 of 11

4 Final Preparations Now that you know the locations of all of the data to be moved you have to determine what method you will use to move the data. The best setup is to have the two computers connected on the same network. Draw and Route Files and GIS layer transfer is very simple over a network. If the two systems are not on the same network then you need a method of file transfer over some type of detachable mass storage device. USB memory sticks or portable hard drives work the best. Next, locate your installation media for XMap and any base map datasets (i.e. the XMap North America Topographic Dataset). Contact DeLorme Customer Service at if you need replacement discs for a nominal fee. The last item that might come in handy is SQL Server Management Studio (SSMS). If the two computers are connected via a network or you do not have that many GIS layers (< 20 layers) then you might be able to skip installing SSMS on both systems. If you think you will need SSMS then download the most Page 4 of 11

5 recent version from the Microsoft web site. At the time of the creation of this document the most recent location was at the following link. Microsoft will periodically release newer versions of this program. Make sure to search for the most recent copy before downloading. Remember to read all of the information on the download page for a successful installation. Migration Procedure The data migration instructions are laid out by the type of data to migrate. Read all of the sections before proceeding to migrate any of the different data types. Some sections might be contain information that could be useful for migrations of other data types. The first step before proceeding with any of the steps below is to install XMap and any base data on the new computer. If you are migrating to the same version of XMap than install that version. If you are migrating to a newer version of XMap there is no need to install the previous version of XMap, simply install the new version. Base Datasets Base Datasets should not be copied over manually as there are registry entries that are set during the automatic installations of the datasets. Use the DeLorme installation steps that come with the base datasets to install them to your computer. Netlink Data Any datasets downloaded via the Netlink tab can be copied from the old system to the new system. If you are migrating from a system that has an older version of XMap (XMap 6 or older) to a newer version of XMap the folder locations are different between the two systems. A new installation of XMap will place the Netlink folder here C:\Users\Public\Documents\DeLorme Docs\Netlink\Downloads. Remember to copy all of the files and folders located in the DeLorme Docs\Netlink\Downloads folder. Each individual download may have multiple files of different types with the same name. GIS Layers The two easiest methods to move GIS Layers are to export each layer as an Openspace file from the old computer and import them to the GIS tab on the new system or use the copy layer feature built into XMap. These methods are best used when only moving a nominal number of layers (<20). Steps for both of these methods are included below. Moving GIS Layers by using Openspace files IMPORTANT - This option is not available for XMap Professional users! 1. Open XMap on the original computer. Page 5 of 11

6 2. Open a project file with your layers or load the layer(s) into your current workspace. 3. Click a layer to select it. 4. Click Layers and then Export. 5. In the Export File window ensure the Save as Type: field is set to DeLorme XMap 7/XMap 8 Transfer File (*.openspace) 6. If desired, change the File name. 7. Click the Save button. Make sure to note the folder location the file is being saved to. 8. Repeat steps 3-7 for each GIS layer. 9. Copy all Openspace files over to the new system either over your network or via some type of removable mass storage device. The Openspace files can be stored anywhere reachable by the new system. 10. Open XMap on the new computer. 11. On the GIS tab click Layers then Import -> New Layer Page 6 of 11

7 12. Click the box next to the Data File field and select an Openspace file from step Select the database you want to use to store the layer. You might need to create a new database if this is the first time you import a GIS layer. 14. Select Next. The layer will import into the selected database. 15. Repeat steps for each Openspace file to import. Moving GIS Layers by Using Copy Layer Note: This method requires that the old and new computers are connected over a network and that you know the SQL Server and instance that your layers are stored on. 1. Open XMap on the new computer. 2. On the GIS tab click Layers -> Manage. 3. In the Source Database drop-down menu select Other 4. In the Server field under Database Login type in the SQL Server instance the layers are stored in on the old computer and click Connect. Page 7 of 11

8 5. Select the database the layers are stored in from the Database drop-down menu and click OK. 6. Use the tools in the Manage Layers windows to move the layers from the list of Layers in the Database on the left to the list of Layers in the Workspace on the right. Click OK. 7. In the Workspace in XMap left-click on one of the layers from the old computer to select it. 8. Click Layers -> Create -> Copy Layer. The Create Copy of layer dialog box appears. 9. If needed, edit the Layer Name to your desires. 10. In the Target Database dropdown list choose the database on the new computer you want to store the layer in. If this is the first time you have created a GIS layer on this computer you will need to select New from the drop-down list to create the database. 11. Click OK to copy the layer. 12. Repeat steps 7-11 for each layer to copy. Page 8 of 11

9 Moving GIS Databases Using SQL Server Management Studio If you have a lot of GIS layers to transfer (>20 layers) and you are not moving to a newer version of XMap follow the steps on the DeLorme Support site at the following link to backup and detach the databases containing the layers from the SQL server on your old computer and re-attach the databases to the SQL server on your new computer using SQL Server Management Studio Express. Using Microsoft SQL Server Management Studio Express with XMap Moving GIS Layers Using Bulk Import/Export If you have a lot of GIS layers to transfer, are moving from an old to a newer version of XMap Enterprise and have some SQL scripting experience follow the steps found in the Migrating Layers to New Databases section of the following document to write and execute a script to automatically export and import each GIS Layer. XMap Admin Guide Draw and Route Files The safest and most successful way to migrate Draw and Route files is by using DeLorme Transfer Files. Transfer Files look at your current project and compress all of the draw and route files into one file which can be imported into your new XMap installation or any other installation of XMap. 1. Open XMap on the old computer. 2. Open a previously created and saved project. 3. Click the MapData tab. 4. In the tab area click File -> Transfer -> Create. 5. Click Save to save the XMap project (.xmp). 6. Click Save to save the Transfer File (.dmt). Note where the Transfer File is stored. 7. Repeat steps 2-6 for all project files. 8. Copy all created Transfer Files over to the new system either over your network or via some type of removable mass storage device. The Transfer Files can be stored anywhere reachable by the new system. 9. Open XMap on the new computer 10. Click the MapData tab. Page 9 of 11

10 11. In the tab area click File -> Transfer -> Import. If the Save File dialog appears click Cancel. 12. In the Import Transfer File window browse to the location of the transfer files from step 8 and select a transfer file to import. 13. Click Open. 14. Repeat steps for all Transfer Files. Project File Clean Up In some cases project files will have errors even after transferring all data from the old to new computer. The two most common messages are relating to disconnected GIS Layers or a missing connection to old base data. Handling Disconnected or Deleted GIS Layers When a GIS layer is disconnected or deleted from a project a red exclamation point (disconnected) or a red X (deleted) displays next to the layer name in the Workspace area of the GIS tab. When a layer appears as disconnected or deleted the options are to either reconnect the layers to inform the XMap project of the new location for the GIS data or to remove the layers from the project entirely. Instructions for both options are included below. To reconnect all layers to the original database or to connect them to a new database, click the Layers button and click Reconnect. Use the tools in this Connect Layers dialog box to inform the project to the look for the layers at their new location. To reconnect/connect specific layers, left-click on the desired layers to highlight them, right-click the highlighted area, and click Reconnect. Use the tools in this Connect Layers dialog box to inform the project to the look for the layers at their new location. Page 10 of 11

11 To remove the active layer, click the Layers button and click Remove. To remove specific layers, highlight the layers, right-click the highlighted area, and click Remove. Replacing Old Map Datasets In some cases if you open a project file that contains a link to an old base map you will get a dialog box asking you if you want to replace the connection with a newer base dataset. Select the Replace button to replace the old connection with a new one. Once done choose to Save the current project update the project file. If XMap does not find the old or new base dataset the following dialog box appears. If you see this message either reinstall the base dataset or remove it from the project using the tools on the MapData tab. When All Steps Fail In some cases an XMap project file will be irrecoverable and cannot be fixed. If this case use the following instructions to build the project file from scratch. - Use Windows Explorer to move all of the project files out of the DeLorme Docs\Projects folder. - Open XMap and open a new, blank project file. - Add your desired Draw, Route, GIS layers and base map datasets to the project. - Save the project file. - Re-open the project inside of XMap to verify all of the files appear as expected. Page 11 of 11