Upgrade to 10.1

Version 9

    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 9.3.1 to 10.0.1), 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.1 as well as information for migrating custom code. 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 Telvent Technical Support web page. Contact Telvent with licensing questions. 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. This tool also performs the following updates:
        • To support Enhanced Circuit Management within Fiber Manager, this tool creates three new fields on your circuit table (which is identified by the assignment of the FIBERCIRCUITTABLE class model name). These fields support the header information required by the new circuit healing functionality, and are also assigned field model names of the same name:
          • FIBERCIRCUITHEADERCLASS
          • FIBERCIRCUITHEADERGLOBALID
          • FIBERCIRCUITTRACESTYLE
        • Create Fiber Manager domains and model names if they do not already exist in your database:

     

    Fiber Field Model Names domainFiber Object Class Model Names domainSpliceType domain
    ACLASSMODELNAME
    ACONNECTIONOBJECTGLOBALID
    ATTENUATIONAFREQ
    ATTENUATIONBFREQ
    AVAILABLE
    BCLASSMODELNAME
    BCONNECTIONOBJECTGLOBALID
    BUFFERTUBECOLOR
    BUFFERTUBECOLORNAME
    BUFFERTUBENAME
    BUFFERTUBENUMBER
    BUFFERTUBEPOSITION
    CALCULATEDFIBERCIRCUITLENGTH
    CIRCUITCHANNEL
    CONTAINERCLASSMODELNAME
    CONTAINERGLOBALID
    ENDFOOTSTAMP
    FIBERCHILDCLASSMODELNAME
    FIBERCIRCUITGLOBALID
    FIBERCIRCUITNAME
    FIBERCOLOREDFIELD
    FIBERCOLORNAMEFIELD
    FIBERCONNECTIONDISPLAYFIELD
    FIBERCONNECTIONDISPLAYSORTFIELD
    FIBERFACETSCONTAINED
    FIBERFACETSCONTAINEDBY
    FIBERGRIDDEFAULTHEIGHT
    FIBERGRIDDEFAULTWIDTH
    FIBERGRIDPOSITION
    FIBERIMPLIEDALIGNMENT
    FIBERIMPLIEDCONNECTIONSOURCEGUID
    FIBERNUMBERGRIDCOLUMNS
    FIBERNUMBERGRIDROWS
    FIBERPARENT
    FIBERPARENTCLASSMODELNAME
    FIBERSTRANDCOLOR
    FIBERSTRANDCOLORNAME
    FIBERSTRANDNAME
    FIBERSTRANDNUMBER
    FIBERTWOPOINTTRACEFIELD
    FIELDNOTESLENGTH
    GLASSLENGTH
    GLOBALID
    MODETYPE
    MULTIMODEAVAILABILITYINDICATOR
    NUMBEROFCOLUMNS
    NUMBEROFPORTCOLUMNS
    NUMBEROFSTRANDS
    OVERHEADUNDERGROUND
    POINTLENGTH
    PORTNUMBER
    PORTPOSITIONONCARD
    SCHEMATICEXPORTATTRIBUTE
    SEGMENTGLASSLENGTH
    SEGMENTLENGTH
    SHEATHID
    SHEATHLENGTH
    SHEATHLENGTHSOURCE
    SHEATHTYPE
    SINGLEMODEAVAILABILITYINDICATOR
    SLOTPOSITION
    SPLICETYPE
    STARTFOOTSTAMP
    THISFIBERCLASSMODELNAME
    TRAYNUMBER
    TWISTFACTOR

    BUFFERTUBE

    CONNECTIONOBJECT

    ENDDEVICE

    ENDDEVICEPOINT

    ENDDEVICEPORT

    FIBERCIRCUITPARTICIPANT

    FIBERCIRCUITTABLE

    FIBERCONNECTABLEOBJECT

    FIBERCONNECTIONCONTAINER

    FIBERDATATABLESOURCE

    FIBERFACETEDOBJECT

    FIBERGRIDABLECONTAINER

    FIBERGRIDABLEOBJECT

    FIBERIMPLIEDCONNECTIONDESTINATION

    FIBERIMPLIEDCONNECTIONSOURCE

    FIBERMULTICONTAINER

    FIBEROBJECT

    FIBERPATCHLOCATION

    FIBERSPLITNOCOPY

    FIBERSTRAND

    FIBERTWOPOINTTRACEPOINT

    LOCATIONEDITABLE

    PATCHPANEL

    PATCHPANELBACKSIDEPORT

    PATCHPANELCARD

    PATCHPANELFRONTSIDEPORT

    RACK

    SHEATH

    SLACKLOOP

    SPLICEPOINT

    SPLITTER

    SPLITTERINPUTPORT

    SPLITTEROUTPUTPORT

    SUPPORTSALOSS

    SUPPORTSBLOSS

    SUPPORTSCONNECTIONTYPE

    SUPPORTSDISCONNECTWARNING

    SUPPORTSSELFCONNECTION

    SUPPORTSTRAYS

    TRANSITIONPOINT

    Mechanical

    Fusion

    Continuous

    Glue

      1. Optional. If you are running Terminal Services, it must be running in Install Mode.
      2. Optional. When upgrading from 9.3, select the geodatabase and right click Properties. On the General tab, click Upgrade Geodatabase. In the Upgrade Geodatabase window, click OK.

    Upgrade ArcFM Geodatabase Manager

    Applies to: Geodatabase Manager users.

     

    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 Designer

    Applies to: Designer users only.

    The 10.0.3 release brought a new CU library structure that supports a new CU filter tool in Designer as well as CU referencing. To upgrade to 10.1 from a version before 10.0.3, you must also upgrade the CU library. The CU Administrator tool in ArcCatalog provides the tools necessary to convert your existing CU library to the new format.

    • Geodatabase Upgrade: Perform the geodatabase upgrade steps (e.g., Upgrade ArcFM Solution Database) as discussed in the previous section (above).
    • Update Schema: This tool adds the tables required by the CU Administration tool. Be sure to login as the owner of the system tables.
    • Migrate Data: This tool copies the CUs in your geodatabase from the existing (blob) format and into the tables created in the Update Schema step. Note that the data is copied and not moved.

     

    Upgrade Fiber Manager

    Applies to: Fiber Manager users only.

    Enhanced Circuit Management

    Before you can use the new circuit healing functionality in Fiber Manager, create a new domain to be used by one of the new header information fields:

    1. In ArcCatalog, right-click the database and select Properties.
    2. On the Domains tab, add a new domain called Circuit Trace Style, or something similar.
    3. Set its field type property to Long Integer and its Domain type property to Coded Values.
    4. Create coded values of 0 and 1 (0 indicates a Y-style trace and 1 indicates and X-style trace). Click OK.
    5. Right-click the circuit table in your database and select Properties.
    6. On the Fields tab, assign the domain you just created to the FIBERCIRCUITTRACESTYLE field. Click OK.


    OTDR Length

    Add "OTDR Length" as both the code and description to the coded values table belonging to the domain that represents the fiber optic cable length source. Then, in ArcMap, if the length source is set to "OTDR Length," the field notes value is not multiplied by the twist factor to populate the cable length field.


    Slack Loop Deletion

    Before this release, when you deleted a slack loop feature, cable length was not updated accordingly. This is fixed in 10.1, but requires you to make a configuration change:

    1. In ArcCatalog, navigate to the feature class that represents slack loops in your database.
    2. Right-click the slack loop feature class and click ArcFM Properties Manager.
    3. Click the Object Info tab.
    4. In the Feature Properties list, assign the ArcFM Fiber Optic Cable Length autoupdater to On Feature Delete.
    5. Click OK.

     

    Upgrade Geodatabase Replication

    Applies to: Geodatabase Replication users only.

    Update Backup Copies of Existing Configuration Files

    The ArcFM installers automatically update your existing replication configuration files as described below. If you keep backup copies of these files, however, you must manually make the following changes before they can be used in Geodatabase Replication.

    Replication configuration files in 10.1 have changed in the following ways:

    • Change the assembly name from Miner.Geodatabase to Miner.Geodatabase.Engine
    • Change the version from 9.2.0.0 or 10.0.0.0 to 10.1.0.0

    Look toward the top of each configuration file for the code shown below. The necessary changes are in red:

    Replication Server Configuration

    ReplicationConsole.exe.config resides in the ArcFM Solution\Bin directory on the server machine.

    <section name="GlobalServerReplicaSection" type="Miner.Geodatabase.Replication.Configuration.GlobalServerReplicaSection, Miner.Geodatabase.Engine, Version=10.1.0.0, Culture=neutral, PublicKeyToken=196beceb052ed5dc" />

     

    Web Service Configuration

    Web.config resides in the C:\Inetpub\wwwroot\ArcFMGDBReplicationService directory. The web service component may or may not reside on the same machine     as the replication server.

    <section name="GlobalWebReplicaSection" type="Miner.Geodatabase.Replication.Configuration.GlobalWebReplicaSection, Miner.Geodatabase.Engine, Version=10.1.0.0, Culture=neutral, PublicKeyToken=196beceb052ed5dc" />
       
    Replication Client Configuration

    ReplicationConsole.exe.config resides in the ArcFM Solution\Bin directory on the client machines.

    <section name="GlobalClientReplicaSection" type="Miner.Geodatabase.Replication.Configuration.GlobalClientReplicaSection, Miner.Geodatabase.Engine, Version=10.1.0.0, Culture=neutral, PublicKeyToken=196beceb052ed5dc" />

     

    Upgrade Mobile

    Applies to: Mobile users only.

    Set Server OIDs

    This tool assigns a ServerOID to each feature in the workspace. Use the Customize menu to add this tool to the ArcFM Solution toolbar.

    See the Event Viewer for errors logged while running the ArcFM Set Server OIDs tool. Click Applications and Services Logs > Miner.
    This tool may not be used on an SDE database. It works only on personal (Access) and file geodatabases. If you're using Mobile, the database must be designated for field use.

    The ArcFM Set Server OIDs tool takes the following action on your database:

    1. It adds the ServerOid field if it does not already exist.
    2. It adds an index to the ServerOid field.
    3. It copies values from the existing ObjectID field to the new ServerOID field.
    4. It remaps relationships that were based on ObjectID to instead be based on ServerOID.
    5. For each table on which a GlobalID type field exists, the tool changes the field to be a Guid type.
    6. It adds an index to the GlobalID field if it does not exist.
    7. It disables visibility of the ServerOid and GlobalID fields.
    8. It makes ServerOid and GlobalID field editable.
    9. It allows null values for the ServerOid and GlobalID fields.


    Run the Set Server OIDs tool

    Due to limitations in the size of Personal (Access) Geodatabases, there are different methods for running the Set Server OIDs tool based on the type of initial extract database you use.

     

    File Geodatabases

    Use the following process to run the ArcFM Server OID tool on your Initial Extract database:

    1. Disable any virus-scanning software. If you use Microsoft Security Essentials, for example, follow these steps to temporarily disable real-time         protection:     
      1. Open Microsoft Security Essentials.
      2. Click the Settings tab.
      3. Click Real-time protection in the left pane.
      4. Uncheck Turn on real-time protection.
      5. Click Save Changes.
    2. If the ArcFM Set Server OIDs button does not appear on the ArcFM Solution toolbar, add it:     
      1. Click Tools > Customize.
      2. Click the Commands tab.
      3. Click ArcFM Solution in the Categories list on the left.
      4. From the list on the right, drag the ArcFM Set Server OIDs tool to the ArcFM Solution toolbar.
      5. Close the Customize window.
    3. Open your Initial Extract geodatabase in ArcCatalog.
    4. Select the Initial Extract geodatabase and click ArcFM Set Server OIDs on the ArcFM Solution toolbar.
      • The time required to run the tool will vary according to the size and complexity of your database.
      • See the Event Viewer for errors logged while running the ArcFM Set Server OIDs tool. Click Applications and Services Logs > Miner.
      • Try either of the following workarounds if you see an error similar to "Failed to add field, could not acquire schema lock!"
        • Temporarily disable Microsoft Security Essentials or any virus scan that might be running.
        • Run MMFieldExtractorServerOID.exe from the command line:                                 
          1. Open a command prompt and change the directory to point to the ArcFM Solution\Bin.
          2. Type the following command: MMFieldExtractorServerOID.exe "<path to your initial extract geodatabase>"
            SetServerOIDsCMD.png
    5. Delete the contents of the directory containing your geodatabase replicas associated with your Base Path. Do not delete the initial extract directory or its contents.
    6. Run ReplicationConsole.exe server to recreate the server replicas. Client machines will receive a full download the next time they run replication.
    7. Re-enable real-time protection in Microsoft Security Essentials, or re-enable your other virus-scanning software.

     

    Personal Geodatabases

    For Personal Geodatabases, we recommend running the Set Server OIDs tool from the command line.

    While you may run ArcFM Set ServerOIDs on a personal geodatabase (*.mdb) in ArcCatalog (exactly as described in the File Geodatabase instructions above), it may cause the Personal Geodatabase to temporarily grow to surpass the 2GB size limit. You may see an error in the event log similar to this:  Process failed! System.Runtime.InteropServices.COMException (0x80004005): Cannot open database. It may not be a database that your application recognizes, or the file may be corrupt.

    When this happens, the ArcFM Set ServerOIDs tool will fail. In this event, you have two options. Either run the Set Server OIDs tool from the command line, or compress the database and retry. To Compress and Retry, first Restart ArcCatalog. Next, right-click the personal geodatabase and select Administration > Compact Database. Run ArcFM Set ServerOIDs again. Last, you may want to compact the geodatabase again when ArcFM Set ServerOIDs has completed.

     

    Use the following process to run the ArcFM Server OID tool on your Initial Extract database:

    1. Disable any virus-scanning software. If you use Microsoft Security Essentials, for example, follow these steps to temporarily disable real-time protection:   
      1. Open Microsoft Security Essentials.
      2. Click the Settings tab.
      3. Click Real-time protection in the left pane.
      4. Uncheck Turn on real-time protection.
      5. Click Save Changes.
    2. Run the Set Server OIDs tool from the command prompt:
           16891c5e-c02c-4625-b2ab-f15eaf2841f8           The time required to run the tool will vary according to the size and complexity of your database.
    3. Delete the contents of the directory containing your geodatabase replicas associated with your Base Path. Do not delete the initial extract directory or its contents.
    4. Run ReplicationConsole.exe server to recreate the server replicas. Client machines will receive a full download the next time they run replication.           
    5. Re-enable real-time protection in Microsoft Security Essentials, or re-enable your other virus-scanning software.

     

    Upgrade Responder

    Applies to: Responder users only.

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

    If you're implementing Responder for the first time, this section is not necessary. Follow the steps outlined in the Configure Responder section.

    • Upgrade Tables: If you have installed a previous version of Responder, execute the upgrade scripts for 10.1 as well as any releases between the current release and your original release. For example, if you have 9.2.1 and plan to upgrade to 10.1, you will need to run the scripts for 9.3 SP1, 9.3 Rev2, 9.3.1, 9.3.1 SP1, 10.0.1 SP1, 10.0.2, 10.0.3, and 10.1. This will provide the tables, views and indices necessary for Responder 9.3.1 SP1. Execute these scripts on your Responder database.
    • 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. These batch scriptsthat 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:

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

      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: 

      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.

      • 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.
      • 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.
      • Client and Server: Program Files (x86)\Miner and Miner\Responder\Developer Resources
      • Web: C:\Inetpub\wwwroot\Responder\Developer Resources
    • 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