Upgrade to 10.2.1a

Version 31

    In order to install ArcFM 10.2.1a, you must first uninstall your current version. Version 10.2.1a does not install on top of 10.2.1. This page outlines the upgrade steps for various ArcFM Solution applications. These are basic required upgrades and do not include configuration for new tools. If you are skipping release versions (e.g., upgrading from 10.1.1 to 10.2.1a), note the following:

    • DO NOT install each release in between. Only install the version to which you're upgrading.
    • DO review the upgrade steps for each release in between the original version and the one to which you're upgrading. Perform any additional upgrade steps outlined on these pages (e.g., recommended Esri patches, Responder upgrade steps, Process Framework database upgrades, etc.).
    • DO run the Create/Update ArcFM Solution System Tables tool only once. There's no need to run it multiple times.
    • DO run the Upgrade ArcFM Solution Database tool only once. There's no need to run it multiple times.
    • DO review the What's New page for each release in between. These pages will outline the new functionality available to you.
    • DO review the Migration pages for each release in between. These pages will let you know if you need to compile custom code.

     

    What's New?

    This page describes the functionality added to the current release for all products in the ArcFM Solution suite.

     

    Migrate Custom Code

    This section provides a list of API changes for 10.2.1a. Be sure to review the API changes and perform any migration steps for releases between your original version and the one to which you are upgrading.

     

    Tips

    • New ArcFM Geodatabase: If you're configuring a geodatabase to use the ArcFM Solution for the first time, follow the steps on the Configure New Geodatabase page.
    • ArcGIS/ArcSDE Note: A mixed version environment is not supported. If you are upgrading to ArcGIS 10.1, you MUST upgrade your geodatabase to ArcSDE 10.1 as well. ArcFM Errors will occur if an ArcGIS 10.1 machine attempts to access an ArcSDE 9.3 machine or an ArcGIS 9.3 machine attempts to access an ArcSDE 10.1 geodatabase.
    • Licensing Note: If you're upgrading from a release prior to 10.1, you must obtain new licenses for the 10.1 release. Request a new license at the Schneider Electric GIS Support page on exchange. Note that 10.1 licenses can also be used with older versions of ArcFM, back to 9.2.
    • License Manager: 10.1 licenses can be used on earlier versions of License Manager, back to License Manager version 9.2.
    • Context-Sensitive Help: Context-sensitive help (What's This tool) does not work properly with Windows 7 and Windows Server 2008 R2. To resolve this issue, download from Microsoft the WinHlp32.exe file for your operating system and execute it.
    • Beware of WordPad: When editing configuration files, DO NOT use WordPad. It has been known to insert characters that can cause malformed XML.

     

    Upgrade ArcFM Geodatabase

    Applies to: All geodatabases being upgraded.Upgrade your geodatabase before performing any other upgrades. If you are skipping release versions (e.g., upgrading from 9.3 to 10.1), you must perform the upgrade steps for each release in between your original release and the one to which you're upgrading. The exceptions are the Create/Update ArcFM Solution System Tables and Upgrade ArcFM Solution Database tools. These need only be run once with each upgrade, regardless of whether you're skipping versions.

    1. Execute the Create/Update ArcFM Solution System Tables tool with each upgrade. The ArcFM System Tables must be located in the same schema as the SDE system tables. When running this tool, you must be connected to the geodatabase as the user who owns the .Default version. All other users must be disconnected from the database. Running this tool is required.
    2. Use the Upgrade ArcFM Solution Database button to update your geodatabase with modifications required by the latest release. This button remains enabled on the ArcFM Solution toolbar in ArcCatalog. You must be signed in as the owner of the business data to upgrade the database, and you must be connected to an editable version. This tool also requires that there be a single owner for all GIS tables.
    3. Optional. If you are running Terminal Services, it must be running in Install Mode.

     

     

    Upgrade ArcFM Geodatabase Manager

    Applies to: Geodatabase Manager users upgrading from a version prior to 10.1 only.

     

    You will need to check your GdbmConfiguration.xml file in the Bin folder of your ArcFM Geodatabase Manager install location, typically C:\Program Files (x86)\Miner and Miner\ArcFM Solution\Bin on a 64-bit system. Check for either of the following entries:

    • <GdbmAssembly>Miner.Geodatabase, Version=9.2.0.0, Culture=neutral, PublicKeyToken={token value}</GdbmAssembly>
    • <GdbmAssembly>Miner.Geodatabase, Version=10.1.0.0, Culture=neutral, PublicKeyToken={token value}</GdbmAssembly>

    If found in your configuration file, you need to edit the entry to read:

    • <GdbmAssembly>Miner.Geodatabase.Engine, Version=10.1.0.0, Culture=neutral, PublicKeyToken={token value}</GdbmAssembly>

     

    Upgrade Responder 

    Applies to: Responder users only.

    Reminder: Responder users will need to perform the ArcFM Geodatabase upgrade steps as well.

    • Upgrade Tables: If you have installed a previous version of Responder, execute the upgrade scripts for 10.2.1a as well as any releases between the current release and your original release. For example, if you have 10.1 and plan to upgrade to 10.2.1a, you will need to run the scripts for 10.1.1 and 10.2.1a. This will provide the tables, views and indices necessary for Responder. Execute these scripts on your Responder database. Note that no upgrade scripts exist for the 10.2 and 10.2.1 releases as they were not necessary.
    • Upgrade Configuration: After installing the Responder components, run the installed batch script for each component to automatically update the various configuration files. If you are skipping releases, you must execute the batch scripts for each release between the one you started with and the one to which you're upgrading. for example, if you have 10.1 and plan to upgrade to 10.2.1a, you will need to run the batch scripts for 10.1.1, 10.2, and 10.2.1a.  Note that no upgrade batch scripts exist for the 10.2.1 release as they were not necessary. These batch scripts that preserve your existing configuration files and append changes that support new functionality. If you are installing Responder for the first time, this step is not necessary. Each Responder component (client, server, web) has its own batch script. Just double-click it to execute. These scripts are installed at the following locations:
      • Client: Program Files (x86)\Miner and Miner\Responder\Developer Resources\[Upgrade for current release]\Config\UpgradeClient.bat
      • Server: Program Files (x86)\Miner and Miner\Responder\Developer Resources\[Upgrade for current release]\Config\UpgradeServer.bat
      • TroubleMaker: Program Files (x86)\Miner and Miner\Responder\Developer Resources\[Upgrade for current release]\Config\UpgradeTroubleMaker.bat
      • Web: C:\Inetpub\wwwroot\Responder\Developer Resources\[Upgrade for current release]\Config\UpgradeWeb.bat. If your Inetpub directory exists on drive other than C:\, you will need to modify the UpgradeWeb.bat file to point to the correct directory.

     

    Manual Configuration (optional)

    There are a few cases in which you may need to manually configure these files instead of using the batch scripts:

    • The batch script fails. Some customizations to the configuration files may cause the upgrade script to fail.
    • You are starting with a release older than 9.1.2. The batch script functionality was introduced with the 9.1.2 SP1 release.

     

    If you need to update manually, be sure to back up the original configuration files before making any changes. Configuration files for the current release are installed in the following locations:

    • Client and Server: Program Files (x86)\Miner and Miner\Responder\Developer Resources
    • Web: C:\Inetpub\wwwroot\Responder\Developer Resources

    Copy these files from the Developer Resources folder and paste them over your original configuration files (AFTER the originals have been backed up). Configure these files with your connection information, etc.

    • If you have modified any feature class IDs, names or model name assignments, you will need to clear the FacilityTypes*.cache files from the cache on the business server. The FacilityTypes files in this directory become out of date and must be deleted manually. Follow these steps:
      1. Browse to the Cache folder in the Application Data directory for the current user on the business server (e.g., C:\Documents and Settings\[user name]\Local Settings\Application Data\Miner and Miner\Responder\Cache).
      2. In the Cache directory, select all files that start with FacilityTypes and press Delete on the keyboard.

    Cache.png

     

    Upgrade OHDA

     

    OHDA 10.2.1a requires a complete upgrade to ArcFM Solution 10.2.1a, and a complete upgrade to ArcGIS 10.2.1, before installation.

     

     

    Upgrade Fiber Manager

     

    Customers upgrading from Fiber Manager 10.2.1a Patch #1156 will need to perform the following:

    1. If necessary, configure your geodatabase with the new circuit model (see Configure Circuit Manager for configuration steps). These changes may already be complete.
    2. Install the most recent version of the ArcFM Solution Desktop, patch #1209 or higher, which can be found on the GIS Downloads page.
    3. Uninstall previous versions of Fiber Manager.
    4. Install Fiber Manager 10.2.1a.
    5. Run the ArcMap Configuration Cleaner if you previously upgraded to 10.2.1a.

     

    Customers upgrading from Fiber Manager 10.2.1 and earlier will need to perform the following:

    1. Check your data to ensure that all your circuits have header information (see the Fiber Header Migration PDF for best practices).
    2. If all of your circuits have header information, proceed to the next step.
    3. Upgrade ArcFM Solution Desktop to 10.2.1a. Release installers can be found on the GIS Downloads page.
    4. Install the most recent version of the ArcFM Solution Desktop, patch #1209 or higher, which can be found on the GIS Downloads page.
    5. Install Fiber Manager 10.2.1a.
    6. Configure your geodatabase with the new circuit model (see Configure Circuit Manager for configuration steps).
    7. Run the Fiber Circuit Upgrade tool if existing circuits are present in your data (review the Fiber Circuit Upgrade Tool PDF for more details).