In our last post, we covered the Requirements of the Advanced Portal for SCSM 2012. In this post, we will walk through the Installation steps.
IMPORTANT: If you have a previous Trial version installed, you will have to uninstall it before beginning the installation.
Advanced Portal Installation
Start by downloading the current version of the Advanced Portal. As of this writing, the current version is 1.5.0910.
Run the AdvancedPortal.DeploymentManager.1.5.0910.1.exe installer. You can choose either a new installation, or upgrade an existing installation, by selecting the option in the Select Site drop down. The second dropdown (Select Version to Install) contains the available versions which can be installed. Make the appropriate selection(s), then click Install.
On the License Agreement screen, read the agreement details, and click Accept.
NOTE: In case you are performing an upgrade, accepting the license agreement will immediately upgrade the existing installation. The upgrade uses the configuration of the existing application, and tries to migrate each setting made on the configuration page.
If you are performing a new installation, you will be presented with the following screen. Fill out the following information, then click Install.
- Web Application Port: Specify a port to use for the WebApplication. If you want to deloy to server “SCSMTests.contoso.com”, using the port 87 without SSL, your Advanced Portal url will look like this: http://scsmtest.contoso.com
- The Application Pool credentials (user and password) required to authenticate the application. The Advanced Portal uses these credentials to connect to the Service Manager 2012 server.
- The address of the Service Manager server.
You may be prompted with the following dialog (“The entered data could not be verified. You can change the settings after installer finished using IIS Manager or the web.config file.”). If you do, click Yes.
NOTE: In my lab experience, I encountered this dialog even though the entered User Name, Password, and Address information was accurate.
I contacted the Vendor to gather additional information on this validation, and what it is checking. This is what they said:
“The Server Manager 2012 Address is the SCSM server. The portal doesn’t require the DWH address. The Application Pool User Name/Password is validated using Active Directory. (The given user will be the Application Pool identity, in IIS.) The Server Manager 2012 Address is validated using the specified address and the Application Pool credentials. If you have problems with authentication, but you are sure, that the entered values are correct, please ignore the message, and continue the installation. This kind of authentication is a little bit different, as later the authentication used by the portal.“
Once the installation is completed, click Exit.
NOTE: The installer automatically opens the site after installation is finished. If you want to change the configuration later, you will have to manually change the website configuration in IIS Manager.
IMPORTANT: In my lab example, I installed the Advanced Portal to an existing web server, so the default http://localhost doesn’t point to the Advanced Portal. Also, in my case the web site was created, but not started. This was due to the default port (Port 80), already being in use by the “Default Web Site” in IIS. All I had to do was stop the Default Web Site, and then I was able to start the Advanced Portal web site.
IMPORTANT: When I attempted to navigate to http://WebServerName, I encountered the following error (Note: This was with a previous version, as the current installation documentation correctly identifies the Application Development Features that were missing at the time I performed the installation. I wanted to keep this information in the article in case it comes up for anyone else).
HTTP Error 500.19 – Internal Server Error
The requested page cannot be accessed because the related configuration data for the page is invalid.
Config Error: This configuration section cannot be used at this path. This happens when the section is locked at a parent level. Locking is either by default (overrideModeDefault=”Deny”), or set explicitly by a location tag with overrideMode=”Deny” or the legacy allowOverride=”false”.
Based on my previous experience with a different program (SMTrak Enterprise Dashboard by Signature Consultancy), I encountered the same error during deployment.
Here’s what the solution for that product was:
Some of the “IIS 8.0” default features are not enabled by default on “IIS 8.5”, to fix this error go to “Program and Features” under “Control Panel” and Click on “Turn Windows features on or off”
Under “Internet Information Services” select “World Wide Web Services” and then “Application Development Features” and enable the below 4 features:
- ASP.Net 4.5
- .Net Extensibility
- ISAPI Extensions
- ISAPI Filters
So, I launched Service Manager again, clicked on Manager > Add Roles And Features, and navigated to the Server Roles screen, and expanded Web Server (IIS). I clicked the “ASP.NET 4.5” Application Development feature to add it, and it automatically added the other 3 missing features.
Then click Next, until you get to the Confirmation screen, then click Install.
After the missing features are installed, I re-attempted to navigate to http://WebServerName. The result? I am properly presented with the Settings screen! Let’s continue with the rest of the Installation and Configuration.
In the web browser, navigate to http://WebServerName:8090. If everything is setup and working correctly, you should see a page similar to this.
If you click on the gear icon in the top right corner, this will bring you to the Settings page.
As you can see from my screenshot, apparently it is in a foreign language (specifically Hungarian), which is odd since my OS is in English, the installer was in English, and there was no option for choosing a language. So, again, I contacted the Vendor for assistance. In the meantime, I was able to correct the issue, which I have documented in the Troubleshooting post of this series.