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.
ERDAS APOLLO Essentials Installation Guide 5
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
6 ERDAS APOLLO Essentials Installation Guide
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
ERDAS APOLLO Essentials Installation Guide 7
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.
8 ERDAS APOLLO Essentials Installation Guide
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
Application Development
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
ERDAS APOLLO Essentials Installation Guide 9
Application Development
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.
10 ERDAS APOLLO Essentials Installation Guide
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.
ERDAS APOLLO Essentials Installation Guide 11
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
12 ERDAS APOLLO Essentials Installation Guide
ERDAS APOLLO Essentials Installation Guide 13
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
14 ERDAS APOLLO Essentials Installation Guide
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.
ERDAS APOLLO Essentials Installation Guide 15
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
16 ERDAS APOLLO Essentials Installation Guide
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.