Tech Paper - ArcFM Server Installation: 10.0.2 - 10.0.3 SP1

Version 1

    When installing ArcFM Server it is important to determine whether ArcGIS Server will be installed on a single machine or deployed across several machines. The ArcFM Server environment can be scaled similarly. Figure 1 depicts a distributed installation of ArcGIS Server (see Configuring a Distributed Installation of ArcGIS Server (Windows) An Esri Technical Paper – April 2006).



    Figure 1, ArcFM Server


    ArcFM Server Installation

    When you choose the Custom option in the ArcFM Server installer, you can see that the installer installs two components: Server Object Container (SOC) and Server Object Manager (SOM). The ArcFM SOC must be installed on any machine that hosts the ArcGIS SOC component. You can install multiple SOC components on multiple machines. ArcFM Server requires installation of the ArcGIS Server Web Application Developer Framework Runtime component on all SOC machines.


    You can install the SOM on the same machine as the SOC. If you're implementing a distributed system, you can install the SOM on a separate machine and use a load balancer to distribute work to the various SOC machines.



    Figure 2, Installation Components



    ArcFM for Silverlight Application and SDK

    The ArcFM for Silverlight application may be installed for an out-of-the-box web application that allows you to navigate GIS data. This web application installer does not require ArcGIS Server or ArcFM Server on the same machine. However, the web application configuration does need to point to a working ArcFM web service.


    Use the ArcFM for Silverlight SDK to develop a custom web application that suits your unique business needs. The SDK provides a Visual Studio template that includes ArcFM for Silverlight tools such as tracing and the Identify tool. Like the ArcFM for Silverlight application, this installer does not require ArcGIS Server or ArcFM Server on the same machine.


    The ArcFM for Silverlight installers are frequently (but not always) released concurrently with the ArcFM Server 10.0.x releases. However, their release numbers correspond with the ArcGIS API for Microsoft Silverlight/WPF.



    The 2.1.2 release includes two ArcFM for Silverlight installers: ArcFM_Silverlight_Sample.msi and ArcFM_Silverlight_SDK.msi. The first installer provides the sample ArcFM for Silverlight application as well as the code associated with that project. So you can modify the code for the web application to create your own custom web application. The second installer provides an SDK that allows you to create a custom web application using a template in Visual Studio. The 2.1.2 release may be used in conjunction with ArcFM Server 10.0.2 and later.



    The 2.2 release also provides two ArcFM for Silverlight installers: ArcFM_Silverlight_Page.msi and ArcFM_Silverlight_SDK.msi. These installers are very similar to the 2.1.2 installers, but with some changes.


    The first installer provides an out-of-the-box web application. However, the code for this project is no longer provided with this installer. You can download this solution from the download area in order to view the code behind the out-of-the-box web application and customize it to suit your needs. The second installer provides the SDK that offers the tools necessary to create a custom web application. The 2.2 release may be used in conjunction with ArcFM Server 10.0.3 and later.


    The ArcFM Desktop Administrator displays the number of ArcFM Server licenses available. A license is necessary for each ArcFM SOC installation. If you have installed SOCs on multiple machines, you will need multiple ArcFM Server licenses. The steps for enabling a license for a map service are discussed below.


    You will need to install the License Manager on each SOC machine. Using the Desktop Administrator, point to the appropriate server in the Floating License Server field to retrieve the ArcFM Server license.



    Figure 3, Desktop Administrator


    Any existing map services require an ArcFM Server license to be enabled using a Server Object Extension (SOE). Any map services that exist at the time of the ArcFM Server installation will automatically have the ArcFM Server License enabled. Any new map services that are added after the installation will require the ArcFM Server License to be manually enabled. This can be done in ArcCatalog by following these steps:

    1. In ArcCatalog, expand GIS Servers and the machine on which your service(s) reside.
    2. In order to modify the ArcFMMapServer option, the service must be stopped. Right-click the service and select Stop.
    3. Right-click the stopped service and select Service Properties.
    4. On the Capabilities tab, scroll to the bottom of the list of checkboxes to find ArcFMMapServer.
    5. Select the ArcFMMapServer checkbox to enable. Uncheck it to disable.
    6. Click OK.
    7. Right-click the service and select Start.



       Figure 4, Map Service Properties


    Alternatively the ArcFM Server Licensing can be run as an executable from the command line. The Miner.Server.ArcFMServerObjectExtension.exe is an executable file that resides in the \Program Files\Miner and Miner\ArcFM Solution\Bin directory. Use this executable to add the licensing extension and enable it for map services.

    1. Open a command prompt and change the directory to:
      • Program Files\Miner and Miner\ArcFM Solution\Bin
      • Program Files (x86)\Miner and Miner\ArcFM Solution\Bin
    2. Enter the following and press Enter.       

      Miner.Server.AddArcFMServerObjectExtension.exe /a


    If you wish to delete the licensing extension from the server, enter the following and press Enter:

    Miner.Server.AddArcFMServerObjectExtension.exe /d