By Daniel Du
Autodesk Infrastructure Map Server 2013 has been released, it can be downloaded from ADN website if you are an ADN member. Trail version will also be published to Autodesk.com website very soon.
In this article, I would like to share with you how to install AIMS 2013 on windows machine.
Before Installation
Before you start, to avoid unexpected errors, please do read the System Requirement to ensure your computer meets the minimum system requirements of AIMS. Documentation is accessible from links at the lower left corner of the installer.
Core Server & Web Extension & Infrastructure Application Extensions need Microsoft® Windows® Server 2008 Enterprise SP2. It is not officially supported to install AIMS2013 on Windows 7, but it does run without problem.Since many developers are developing AIMS application from a Win7 machine, I will use Windows 7 as demonstration here. To install on windows with IIS+.NET binding, please make sure IIS is installed/configured correctly, make sure you can run common ASP.NET application first.
Autodesk Infrastructure Map Server Web Extension uses CGI to communicate with core Server, please make sure check “CGI” in IIS configuration. For Windows 7, click Control Panel—> Program and Features –> Turn Windows features on or off:
Another reminder is to ensure that your user name has Administrator permissions to install AIMS 2013.
Start Installation
Now let’s begin, you will see this screen after the setup is launched, please do take some time reading the Installation Help, System Requirement and Readme. Click “Install” to continue.
Read and accept the license agreement:
Input your serial number and product key if you have one, otherwise you can select the first option to try this product for 30 days.
Caution! Do not go too fast in this page. You need to click each item to open the configuration page, otherwise it will install with default configuration.
Click “Autodesk Infrastructure Map Server 2013” to open the server configuration page as below. You can install Map Server and Web Extension on same machine or separate machines.
For “Autodesk Infrastructure Web Server Extension 2013”, it is a little complicated. As you know, Autodesk Infrastructure Map Server runs on both Windows and Linux, provides APIs in 3 languages: .net, php and Java. Depending on the choices you made to develop AIMS applications, you have different choice to install Infrastructure Map Server Web Extension.
You should decide which language you are planning to use before installing AIMS Web Extension.
Language OS Web Server
-----------------------------------------------------------------------------
.net Windows IIS Configuration with .net
php Windows IIS Configuration with php
php Linux Apache with php
Java Windows Apache/Tomcat with Java
Java Linux Apache/Tomcat with Java
------------------------------------------------------------------------------
I am going to use .NET to develop AIMS application, so I select IIS configuration with .NET.
I need to install “Autodesk Infrastructure Studio 2013” in next page. You can also install “Autodesk Infrastructure Application Extension 2013” and “Autodesk Infrastructure Administrator 2013” if you are going to use industry model.
Please note that IIS with .NET configuration is the only option if you want to install “Autodesk Infrastructure Application Extension 2013” .
Now it is all set, you can sit back to have a cup of coffee now.
A few minutes latter, the product will be installed successfully.
License Activation
Unlike other Autodesk products, Autodesk Infrastructure Map Server 2013 does not start the activation process when you launch the program for the first time. You must manually activate Infrastructure Map Server by clicking Start Programs (or All Programs)
Autodesk
Autodesk Infrastructure Map Server 2013
Autodesk Infrastructure Map Server 2013 Licensing Activator.
The Autodesk Licensing wizard is started where you can follow the on-screen instructions to activate your Autodesk Infrastructure Map Server 2013 license.
Verifying the Configuration
You can run some simple tests to ensure that the Map Agent and Web Server Extensions are configured properly.
Testing the Map Agent
Ensure that the Infrastructure Map Server is running. The installer configures Infrastructure Map Server as a service. Open Services Management Console by typing “Services.msc” in Start—>Run, check that the service status is Started.
Open a web browser and go to the following URL. If the Web Server Extensions are not running on your local machine, replace localhost with the name or IP address of your server.
http://localhost:8008/mapserver2013/mapagent/index.html (Apache) or http://localhost/mapserver2013/mapagent/index.html(IIS)
Note that if your web server is listening on a different port you must include the port number in the HTTP request. For example, if Apache is listening on port 8700, you must go to the following URL:
http://localhost:8700/mapserver2013/mapagent/index.html
Click one test method, for example, “Features” in Service API, then “GetFeatureProviders”, it will get all register FDO providers. Enter Administrator for the user id and admin for the password. Both are case-sensitive.
If the Map Agent is running properly, you will get an XML document describing the resources in the repository.
Testing the Site Administrator
Ensure that the Map Server is running. Open a web browser and go to the following URL.
http://localhost:8008/mapserver2013/mapadmin/login.php (Apache) or http://localhost/mapserver2013/mapadmin/login.php(IIS)
Note that if your web server is listening on a different port you must include the port number in the HTTP request. For example, if Apache is listening on port 8700, you must go to the following URL:
http://localhost:8700/mapserver2013/mapadmin/login.php
Enter Administrator for the user id and admin for the password. Both are case-sensitive.
If the Site Administrator is configured properly, you will get a Manage Servers page which lists all the servers configured in the Map Server Site.
Common Errors/Problems:
Here are some solutions for common problems for your reference:
1. cannot login from Infrastructure Studio,
Error message:
---------------------------
Unable to complete request to Site
The User ID or Password is invalid. Please try again.
---------------------------
Solution:
Enable “Anonymous Authentication” and Disable “Basic Authentication” in IIS for MapServer2013 web application.
Start—>Run, type “inetmgr” to open Internet Information Service Manager. Click “MapServer 2013” web application from let, then Authentication from right.
2. Get following error message in Infrastructure Studio:
---------------------------
Unable to complete request to Site
FastCGI must be properly configured before attempting to connect to Map Server.
---------------------------
Solution:
- Check whether your configure CGI successfully in IIS(see Before Starting)
- Disable “ASP.NET Impersonation”
3. Cannot login from mapagent, http://localhost/mapserver2013/mapagent/index.html, always get this authentication dialogue even input the correct user name “Administrator” and password “admin”:
Solution:
Disable “Digest Authentication ” in IIS for MapServer2013 web application.