Accela GatewayVersion 2.1

INSTALLATION AND ADMINISTRATION GUIDE

Accela Gateway Installation and Administration Guide

© 2013 Accela, Inc. All rights reserved.

Accela, the Accela logo, the Accela logo with “Government Software” notation, Accela Automation, Accela Asset Management, Accela Citizen Access, Accela Mobile Citizen Access, Accela ERS, Accela GIS, Accela IVR, Accela Land Management, Accela Licensing, Accela Mobile Office, Accela Public Health and Safety, Accela Service Request, Accela Wireless, Kiva DMS, Kiva Development Management System, 'PERMITS' Plus, SiteSynch, Tidemark Advantage, VelocityHall, Vantage360, and other Accela logos, devices, product names, and service names are trademarks or service marks of Accela, Inc. Brava! Viewer is a trademark of Informative Graphics Corporation. Windows is a registered trademark of Microsoft Corporation. Acrobat is a trademark of Adobe Systems Incorporated. Portions copyright 2009 Ching-Lan 'digdog' Huang and digdog software. All other company names, product names, and designs mentioned herein are held by their respective owners.

Version 2.1August 2013

Corporate Headquarters

2633 Camino RamonSuite 120Bishop Ranch 3San Ramon, CA 94583

Tel: (888) 722-2352 Fax: (925) 659-3201

www.accela.com

3

TABLE OF CONTENTS

Prerequisites ..................................................................................................... 4

Installing Accela Gateway................................................................................. 4

Accela Gateway Administration Portal.............................................................. 7

Logging in to Accela Gateway Administration Portal .................................... 7

Changing the Administrator User Name and Password ............................... 7

Modifying the Gateway Server Configuration as Needed............................. 8

Troubleshooting ................................................................................................ 9

Metabase Issue ............................................................................................ 9

Verifying the ASP.Net State Service ............................................................ 9

Enabling 32-Bit Application on 64-Bit Operating Systems.......................... 11

Correcting HTTP Error 402.2...................................................................... 12

4

ACCELA GATEWAY INSTALLATION

AND ADMINISTRATION

PrerequisitesBefore you run the Accela Gateway Installer, you must obtain an Accela Automation license key from the Accela Customer Resource Center. Additionally, install the following programs before you install the gateway installer.

Accela Automation License Key and Installation

Microsoft IIS 7.0 or higher

Microsoft .NET Framework 4.0

ASP.NET State Service

For more information about how to configure ASP.NET State Service, see Verifying the ASP.Net State Service on page 9.

Installing Accela GatewayYou must install the Accela Gateway component on a server that is accessible from the public internet, and that can access your internal Accela Automation Biz Server. Although not required, installing Accela Gateway on the IIS server you use for Accela Citizen Access or Accela Mobile Office is preferable, as these servers already meet the requirements needed to install Accela Gateway.

The Accela Gateway installer is available on the Resources tab of the Accela Civic Cloud Platform Administration portal or from the Accela Customer Resource Center.

To install Accela Gateway Installer

1. Download the installation file to the machine where your IIS server is installed.

2. Launch the installer: Accela_Gateway_2.1.0.3.exe.

The Virtual Root and Web Site screen appears.

Accela Gateway Installation and Administration GuideInstalling Accela Gateway 5

3. Complete these fields:

4. Click Next to continue.

The Choose Destination Location window displays.

5. Click Next to accept the default location.

Virtual Root Enter a virtual root name for the gateway application.

Web Site Select a web site where the gateway application is hosted.

Accela Gateway Installation and Administration GuideInstalling Accela Gateway 6

Click Change if you want to select another location. If you click Change, navigate to and select the desired location in the window that displays, then click Next.

A Gateway Setup Configuration window displays, prompting you to enter a directory location for the log and an access key to be used in validating client access.

6. Enter values in the fields as described below, then click Next.

7. You are prompted to review your settings. If you need to make changes, click the Back button and make changes as needed.

To proceed with the installation, click Next.

The installation wizard installs the Accela gateway using the settings you defined. When the installation is complete, an InstallShield Wizard Complete message displays.

8. Click Finish.

When the files are copied successfully, the Installation Complete dialog displays the URL, initial user name and password of the Accela Gateway Administration Portal.

Log Directory Enter the location where you want Accela Gateway to store log files when they are created.

Access Key Enter the Access Key to be used by a client (Accela Civic Cloud Platform) when seeking access to Accela gateway.

The same Access Key must be entered while setting up Environment information in Accela Civic Cloud Platform Admin portal to establish a trusted connection between the Accela Civic Cloud Platform and the Gateway. This key can be accessed and modified later via the Accela Gateway Administration portal.

Accela Gateway Installation and Administration GuideAccela Gateway Administration Portal 7

9. Try to connect to the Gateway Administration portal.

If you cannot connect, see Troubleshooting on page 9 for more information.

Accela Gateway Administration PortalThe Gateway portal provides management tools to configure and manage the gateway settings. As part of this installation process, you will use it to change your password.

Topics

Logging in to Accela Gateway Administration Portal

Changing the Administrator User Name and Password

Modifying the Gateway Server Configuration as Needed

Logging in to Accela Gateway Administration Portal Open Accela Gateway URL in your browser (https://ServerDnsName/VirtualDirectoryName/Login.aspx), and log in.

If this is your first login, use the initial user name and password: admin / changeme.

Changing the Administrator User Name and Password

To change the administrator user name and password

1. Log in to Accela Gateway Administration portal.

2. Click the Change Password link.

The Change Password form displays.

3. Enter the old user name and password, followed by the new name and password.

4. Click Save when done.

Accela Gateway Installation and Administration GuideAccela Gateway Administration Portal 8

Modifying the Gateway Server Configuration as Needed

To modify the Gateway Server Configuration as Needed

1. Log in to the Gateway Administration portal.

2. Click the Server Configuration link.

The Server Configuration form displays.

3. Modify the settings as needed, using the following information as a guideline:

Access Key Click the New Access Key button to generate a new access key, or manually enter an access key.

Note: The Access Key is used for security purposes. If an access key is set (or changed), the client (Accela Civic Cloud Platform) must have a matching access key entered on the Host Agency Environment page in the Accela Civic Cloud Platform Administration portal.

Allowed App Servers Optional: If you want to limit access to the Gateway to authenticated application servers only, use this field to list the permitted application server IP or DNS values. If you are entering more than one value, use a comma to separate each application server value.

For example: http://10.50.69.18:11080,http://dns:11080.

Log Directory Define the directory (folder) you want Gateway to use to store log files. Accela recommends that you specify a NON system directory, because transaction log files may be very large.

Log Expired Days The expired log will be cleaned automatically in N days where N is the value entered. If you change this value, you must restart the application before it takes effect.

Enable Debug Set this option to ‘enabled’ only if you are running a diagnostic or debugging the application. Otherwise, set this option to “disabled”.

Accela Gateway Installation and Administration GuideTroubleshooting 9

Troubleshooting

Topics:

Metabase Issue

Verifying the ASP.Net State Service

Enabling 32-Bit Application on 64-Bit Operating Systems

Correcting HTTP Error 402.2

Metabase IssueIf you run into an IIS metabase issue, it is likely because.NET framework was installed before the IIS server. To resolve the issue, run the following command from a MS-DOS Command window in this folder: C:\Windows\Microsoft.NET\Framework\v4.0.30319.

For more information about how to resolve this issue, visit Microsoft Support.

aspnet_regiis –i

Verifying the ASP.Net State ServiceYou may need to verify whether the ASP.Net state service is running.

To verify the ASP.Net state service

1. Open the Windows Services control panel and locate ASP.NET State Service.

2. Verify that the status of the service is “Started” and the startup type is “Automatic.”

a. If the service Status is not Started, click the Start link to start the service.

b. If the Startup Type is not Automatic, right-click the service and select Properties. Change the Startup type to Automatic and click OK.

Note: For information about how to resolve the ASP.Net State Service issues on a 64-bit server, visit Microsoft Support.

Accela Gateway Installation and Administration GuideTroubleshooting 10

c. If the ASP.NET State Service does not exist, follow these steps in IIS 7.0 Manager for setup.

IIS 7.0 Manager displays a similar screen as follows.

Accela Gateway Installation and Administration GuideTroubleshooting 11

Enabling 32-Bit Application on 64-Bit Operating SystemsIf your agency uses IIS 7.0 on 64-bit operating systems, you must set the Enable 32-Bit Application option to “True” in the advanced settings for your application pool. Please follow these steps in Application Pools for setup.

Accela Gateway Installation and Administration GuideTroubleshooting 12

Correcting HTTP Error 402.2 If you encounter the error “Http Error 402.2 - Not Found” while running Gateway on Windows 2008/IIS 7 or above, there is an incorrect IIS setting. Specifically, the Web server ISAPI and CGI Restriction list settings are not correct.

To fix this issue and ensure that the ISAPI and CGI extensions can run on the Web server, do the following:

1. Open the IIS manager and click the server name in the left pane.

Accela Gateway Installation and Administration GuideTroubleshooting 13

2. In the middle pane, double click the ISAPI and CGI Restrictions icon.

A list of ISAPI and CGI extensions displays.

3. Select ASP.NET v4.0 and click Enable in the right pane.