APOLLO Essentials Installation Guide...ERDAS APOLLO Essentials Installation Guide 3 The APOLLO...

ERDAS APOLLO Essentials Installation Guide

14.00

December 2013

Copyright

Copyright © 2013 Intergraph Corporation. All Rights Reserved.

Including software, file formats, and audiovisual displays; may be used pursuant to applicable software license agreement; contains

confidential and proprietary information of Intergraph and/or third parties which is protected by copyright law, trade secret law, and

international treaty, and may not be provided or otherwise made available without proper authorization from Intergraph Corporation.

U.S. Government Restricted Rights Legend

Use, duplication, or disclosure by the government is subject to restrictions as set forth below. For civilian agencies: This was developed

at private expense and is "restricted computer software" submitted with restricted rights in accordance with subparagraphs (a)

through (d) of the Commercial Computer Software - Restricted Rights clause at 52.227-19 of the Federal Acquisition Regulations

("FAR") and its successors, and is unpublished and all rights are reserved under the copyright laws of the United States. For units of the

Department of Defense ("DoD"): This is "commercial computer software" as defined at DFARS 252.227-7014 and the rights of the

Government are as specified at DFARS 227.7202-3.

Unpublished - rights reserved under the copyright laws of the United States.

Intergraph Corporation

P.O. Box 240000

Huntsville, AL 35813

Terms of Use

Use of this software product is subject to the End User License Agreement ("EULA") delivered with this software product unless the

licensee has a valid signed license for this software product with Intergraph Corporation. If the licensee has a valid signed license for

this software product with Intergraph Corporation, the valid signed license shall take precedence and govern the use of this software

product. Subject to the terms contained within the applicable license agreement, Intergraph Corporation gives licensee permission to

print a reasonable number of copies of the documentation as defined in the applicable license agreement and delivered with the

software product for licensee's internal, non-commercial use. The documentation may not be printed for resale or redistribution.

Warranties and Liabilities

All warranties given by Intergraph Corporation about equipment or software are set forth in the EULA provided with the software or

applicable license for the software product signed by Intergraph Corporation, and nothing stated in, or implied by, this document or its

contents shall be considered or deemed a modification or amendment of such warranties. Intergraph believes the information in this

publication is accurate as of its publication date.

The information and the software discussed in this document are subject to change without notice and are subject to applicable

technical product descriptions. Intergraph Corporation is not responsible for any error that may appear in this document.

The software discussed in this document is furnished under a license and may be used or copied only in accordance with the terms of

this license. No responsibility is assumed by Intergraph for the use or reliability of software on equipment that is not supplied by

Intergraph or its affiliated companies. THE USER OF THE SOFTWARE IS EXPECTED TO MAKE THE FINAL EVALUATION AS TO THE

USEFULNESS OF THE SOFTWARE IN HIS OWN ENVIRONMENT.

Intergraph is not responsible for the accuracy of delivered data including, but not limited to, catalog, reference and symbol data. Users

should verify for themselves that the data is accurate and suitable for their project work.

Trademarks

Intergraph, the Intergraph logo, and GeoMedia are registered trademarks of Intergraph Corporation. Microsoft and Windows are

registered trademarks of Microsoft Corporation. Bing is a trademark of Microsoft Corporation. Google Maps is a trademark of Google

Incorporated. Pictometry Intelligent Images is a registered trademark of Pictometry International Corporation. ERDAS, ERDAS

IMAGINE, Stereo Analyst, IMAGINE Essentials, IMAGINE Advantage, IMAGINE, Professional, IMAGINE VirtualGIS, Mapcomposer,

Viewfinder, Imagizer, LPS, and ERDAS APOLLO are registered trademarks and exclusive property of Intergraph Corporation.

Other brands and product names are trademarks of their respective owners.

ERDAS APOLLO Essentials Installation Guide 3

The APOLLO Essentials installation occurs in two stages: the first stage copies the necessary application files to the system and the second stages configures and deploys the required web applications.

Prerequisites The Intergraph Setup Manager consolidates all products within the Intergraph Geospatial Server offering a single installation package. Before launching the setup manager you must have the following prerequisites installed

.NET Framework 4.0

Other APOLLO Essentials dependencies will be detected and prompted to be installed if required later in the configuration wizard.

Intergraph Setup Manager 1. APOLLO Essentials can be installed from the Intergraph Geospatial Server setup

manager by highlighting the product and selecting the “install” action. If the Setup

Manager is not used, skip to the following step

Installation Guide - Windows

4 ERDAS APOLLO Essentials Installation Guide

Installation 2. Click Next to start the installation.

3. You will see the Software License Agreement dialog displaying the terms and conditions under which ERDAS APOLLO Essentials is licensed to you. You must accept these terms and conditions to install or use ERDAS APOLLO Essentials.

4. Click I accept and then click Next to accept the licensing terms and continue with your installation. To decline the licensing terms and abort the installation, click Cancel.


5. Select components to be installed:

ERDAS APOLLO Essentials

SDI Components i. This is an optional component not required for a fully operational

APOLLO Essentials install. See Release Notes for more information

6. Choose a destination for your ERDAS APOLLO Essentials files to be installed. You can accept the default location by pressing the Next button.

7. Select Next once you confirm the installation location.

18 Copy Installation Files


8. Click Install to continue your installation. Click Cancel to abort the installation. During installation, the Installer will display a screen indicating progress and actions being performed.

9. When the installation has completed, the Installation Complete dialog will be displayed


n 19

10. To exit the installer, click the Finish button. The Release Notes and configuration wizard will automatically load

Configure Server 1. The configuration wizard can either be invoked straight after the installation of the

required files or by double clicking on the ConfigurationWizard.exe which is located

by default at C:\Intergraph\APOLLO Essentials\PostInstallConfigurator.

2. Click Next to start the configuration wizard. The next dialog may take several

minutes to appear as the configuration wizard scans your system for the required

features.


3. The required features listed will be dependent on the components selected during

the installation stage, for example not installing SDI Components reduces the

number of dependencies.

If a required feature is not presented, a red cross will appear. Please install the

feature and click Refresh to update the detected features. Once all the required

features are installed, click on the Next button to continue.

APOLLO Essentials required features

Role Services

IIS-ISAPIFilter: Internet Server Application Programming Interface (ISAPI) Filters

o Web Server

Application Development

ISAPI Filters

IIS-ISAPIExtensions: Internet Server Application Programming Interface (ISAPI) Extensions

o Web Server


ISAPI Filters

IIS-StaticContent: Static Content

o Web Server

Common HTTP Features

Static Content

GeoMedia SDI Portal required features

Role Services

IIS-ASPNET: ASP .Net

o Web Server



ASP.NET

IIS-IIS6ManagementCompatibility: IIS 6 Management Compatibility

o Web Server

Management Tools

IIS 6 Management Compatibility

Features

WCF-HTTP-Activation: HTTP Activation

o .NET Framework 3.5.1 Features

WCF Activation

HTTP Activation

MSMQ-Server: Message Queuing

o Message Queuing

4. Select the IIS web site to deploy APOLLO Essentials onto. Multiple websites will be

listed here if detected, or if a previous installation is detected it will prompt you to

upgrade the previous installation which will retain all previous 2013 settings and

configuration.

You can also select to enable or disable JPIP support which will configure the

Website application pool to run under the same APOLLO Essentials account. Select

the appropriate site and Click Next to continue.


5. If the SDI Components were installed the following dialog will appear. Select the

website you want to install the GeoMedia SDI Administration Console. This does

not need to be the same website as APOLLO Essentials. Click Next to continue.

6. A summary page detailing the selected options will appear. Click Finish to start

the configuration process.

7. During the configuration process, a progress dialog will appear. Click Cancel if you

want to abort the configuration.


8. When the configuration is complete, the final dialog will appear. You can view

the configuration log file by clicking on the Open Log File button, or click Close to

exit the configuration wizard.

9. Congratulations you can now open the Administration Console and start

configuring and using your APOLLO Essentials server


Prerequisites Red Hat Enterprise Linux v5.x / 6.x

CentOS v5.x / 6.x

o Apache 2.2 and above

See Supported Environments for more information

Installation

1. The APOLLO Essentials Linux installation is distributed as a binary executable that has to be given executable permission and installed as root.

chmod a+x ERDAS-APOLLO-Essentials_2013.bin ./ERDAS-APOLLO-Essentials_2013.bin

2. Accepting the EULA will extract a RPM installation package that needs to be run,

Rpm –I ERDASAPOLLOEssentials-14.00.0000-61.x86_64.rpm

3. Depending on security configuration, SE Linux may need to be configured as a

post-install step to grant access to the newly deployed APOLLO Essentials files. An

example script is available,

/usr/local/intergraph/apollo-essentials/conf/selinux.sh

Installation Guide - Linux


4. Start the APOLLO Essentials process,

/usr/local/intergraph/apollo-essentials/bin/iwsctl start

5. To configure APOLLO Essentials via the local Administration Console, Sun JRE 1.7

must be installed from http://java.com/en/download/manual.jsp.

a. For console-only environments, the Administration Console can be

launched remotely via JNLP at

http://localhost/erdas-iws/ecwpmgr.dll?action=jws. Refer to the User

Guide for remote configuration instructions

6. Congratulations you can now open the Administration Console and start

configuring and using your APOLLO Essentials server on Linux

Refer to the User Guide for further installation troubleshooting information.

http://java.com/en/download/manual.jsp

http://localhost/erdas-iws/ecwpmgr.dll?action=jws


Windows 1. For customers upgrading from 2013 (v13.00.000x) it is required that the previous

version, including any other Intergraph Geospatial Server 2013 components be

uninstalled first. Within the uninstaller there is a “Leave configuration” option that

should be enabled that retains all configuration files, filelist.db and projection

library changes that will be upgraded.

2. Complete the uninstall process and start the installation procedure for 2014. As

part of the new installation, the configuration wizard will detect the existing

configuration files and upgrade these files where required. Your previous service

configuration and options will remain

3. Congratulations, you have now upgraded to APOLLO Essentials 2014

Upgrading to 2014


Linux 1. For customers upgrading from 2013 (v13.00.000x) the upgrade procedure is

handled via RPM. Installation will fail if a 2013 installation is detected, however you

can upgrade by using the –U (upgrade flag)

Rpm –U ERDASAPOLLOEssentials-14.00.0000-61.x86_64.rpm

2. This upgrade will maintain or upgrade the previous configuration files such as the

filelist.db, config.xml matching the workflow on Windows platforms.

APOLLO Essentials Installation Guide...ERDAS APOLLO Essentials Installation Guide 3 The APOLLO...

Documents

Transcript of APOLLO Essentials Installation Guide...ERDAS APOLLO Essentials Installation Guide 3 The APOLLO...