ArcFM Web 4.4 Installation and Configuration Guide

Version 46

    leviathan.pngArcFM Web is a powerful and lightweight HTML5/JavaScript web application that expands the capabilities of GIS across an organization for use anytime, anywhere, on any device. Providing ArcFM functionality over the web allows a simple deployment model for applications that requires only a web browser on the client side.

     

    ArcFM Web puts the utility’s data – backed by the power of ArcFM – in the hands of more individuals within the organization, creating more effective decision making by more parts of the utility. ArcFM Web allows utilities to leverage quicker, more intelligible information to report and manage assets, optimize decision making, and quickly identify and solve problems.

    Note: ArcFM Web replaces ArcFM for Silverlight.

     

    Contact GIS Client Services for assistance on choosing the deployment architecture that best suits your Enterprise GIS roadmap.

     

    This document outlines the following aspects of ArcFM Web:

     

    Requirements

     

    Hardware

    ComponentMinimumPreferred
    Random access memory (RAM)1 GBAt least 2 GB
    Hard drive (HDD)200 MBMore than 200 MB
    Central processing unit (CPU) clock speed1.6 GHzHigher than 1.6 GHz
    CPUx86 compatibleIntel Core Duo, Intel Pentium, Intel Xeon

    Software

    ComponentRequirement
    Operating system
    • Windows Server 2012
    • Windows Server 2008 R2 (Standard / Enterprise)
    • Windows Server 2008 (Standard/Enterprise)
    • Windows Server 2003 (Standard/Enterprise/Small Business)
    • Windows 8
    • Windows 7
    • Windows Vista
    • Windows XP Professional SP2
    .NET Framework

    If your server is running Windows XP, Windows Vista, or Windows Server 2003, you must install .NET Framework 3.5 before you install one of these supported versions:

    Recommended: .NET Framework 4.5

    Minimum: .NET Framework 4.0

    Internet Information Services (IIS) components

    Web Management Tools

    • IIS Management Console
    • IIS Management Scripts and Tools
    • IIS Management Service

    World Wide Web Service

    • Application Development Features
      • .NET Extensibility
      • ASP .NET
      • ISAPI Extensions
      • ISAPI Filters
    • Common HTTP Features
      • Static Content
      • Default Document (newer versions of Windows)
    • Security
      • Basic Authentication
      • Request Filtering
      • Windows Authentication
    iis.png

    Necessary IIS components. Click image to view full size.

    ArcGIS Server supported versions10.3, 10.2.2, 10.2.1, 10.2, 10.1, 10.0, 9.3.1, 9.3, and their service packs.

     

     

    Installation

     

    Before installing the software, you will need to download the ArcFM Web installation zip file. The compressed file includes the installer (ArcFM Web.msi) and a viewer template file (ArcFM.Web.Html5Viewer.Template.2.x.x.vte).

    The ArcFM Web installer will install both ArcFM Web and Geocortex Core on your server. The installation wizard will also walk you through a post installation and configuration process.

     

    ArcFM Web and Geocortex Core installation

    1. Double-click ArcFM Web.msi and follow the installation wizard.
    2. The final screen of the wizard has a Launch Post Installation Configuration checkbox. Make sure the checkbox is selected and click Finish.
    3. The Geocortex Core Setup installer begins automatically. Follow the instructions to complete the installation of Geocortex Core.
    4. Click Finish on the final screen.

     

    Geocortex Essentials Post Installation

    1. The Geocortex Essentials Post Installation Configuration interface automatically opens after ArcFM Web and Geocortex Core installation.
    2. Click Next to advance through the post installation configuration options, changing or typing values as needed, until you reach the Configure Viewer Templates setting in the Geocortex Essentials Configuration section.
    3. On the Configure Viewer Templates setting, click Add and browse to the ArcFM.Web.Html5Viewer.Template.2.x.x.vte file you extracted from the zip file download.
    4. Double-click the file and select Yes to install the Management Pack. 
    5. Click Yes to deploy the template to an IIS virtual directory.
    6. Accept the defaults or change values on the Deploy Template to IIS dialog and click Deploy.
    7. Click OK once the installer deploys the template.
    8. Advance through the other settings on the post installation interface. Click Finish when done.
    9. On the Summary page, review your changes. If satisfied, click OK. Otherwise, click Cancel to exit without applying changes.

    Note: If needed, you can run the Geocortex Essentials Post Installation Configuration interface manually. The default location of the file is C:\Program Files (x86)\SchneiderElectric\ArcFM Web\Default\Post Install\Geocortex.Essentials.PostInstall.exe on a 64-bit machine.

     

     

    Configuration

     

    After installation, you will need to point ArcFM Web to a map service.

    1. After installation, use your favorite web browser to log into the Geocortex Essentials Manager at http://ServerName/Geocortex/Essentials/RestManager/. Be sure to replace "ServerName" with the name of the machine that hosts your web service.
    2. Click Add New Site. A site creation wizard will walk you through the process.
    3. After you create the site, the Geocortex Essentials Manager loads the Configure Site screen and defaults to the Map setting. Click the Add Map Service button.
    4. On the Search tab, type http://server.arcfmsolution.com/arcgis/rest/services/Schneiderville/ElectricDistribution/MapServer as the service URL. Press Enter or click the search icon.
    5. Select the map service to use (e.g., ElectricDistribution) and click Add to Map. You can also select individual layers in the service to Add as Map Service or Add as Feature Layer.
    6. Click Save Site in the upper-right corner.
    addmap.png

    Map service added to ArcFM Web site. Click image to view full size.

     

    Add Viewer

    You will need to set an HTML5 viewer to interact with your site:

    1. Click the Viewers tab on the left side of the page.
    2. Click Add Viewer.
    3. Type a Display Name for the new Viewer. Ensure the Template is Viewer for HTML5 2.5.2. Click OK.
    4. By default, the viewer only includes some basic tools. To add navigation tools, click the Toolbar tab on the left side of the page.
    5. Under Available Tools, hover over the Navigation tree. The cursor changes to a four-way arrow.
    6. Click and drag the Navigation tree to the Configured Toolbar section. Release the mouse button when the yellow highlight appears in the position you want. You can also move individual tools and create new tabs with the Add Tab button.
    7. Click Apply Changes to enable the Save Site button.
    8. Click Save Site.
    9. Click the Launch in Browser link on the Viewer Info tab to launch ArcFM Web with your viewer.
    mapcreated.png

    ArcFM Web viewer displaying map service. Click image to view full size.

     

     

    Uninstall

     

    You can use Windows Control Panel to uninstall all components of ArcFM Web:

    1. From Control Panel, select Programs and Features. In a typical installation, you will need to uninstall three components:
      • ArcFM Web
      • Geocortex Core
      • Geocortex Identity Server
    2. Beginning with ArcFM Web, select the program and click Uninstall.
    3. If prompted to confirm, select Yes.
    4. Wait for the uninstall process to complete before you uninstall the next program.
    5. Repeat this process for Geocortex Core and Geocortex Identity Server.
    6. You will need to manually delete the Html5Viewer and Geocortex directories. The default location of these file trees is C:\inetpub\wwwroot.
    7. Open IIS Manager and remove the Geocortex folder and the Html5Viewer application.
    8. Some data files remain on the system after uninstall (e.g., log files, user data, configuration data). In a typical installation on a 64-bit system, you will find these files under C:\Program Files (x86)\SchneiderElectric\ArcFM Web\Default. You can safely delete these files if you are certain you will not need to install ArcFM Web on the same server again.

     

     

    Documentation

     

    For support, visit the Schneider Electric exchange website.

     

    The ArcFM Web help files are automatically installed on your server when you install ArcFM Web. The default help URL is

    http://ServerName/Geocortex/Essentials/RestManager/Help/RM_HelpFileWEBHELP

    Replace ServerName with the name of the machine that hosts your web service.