A WordPress.com site dedicated to System Center and Cloud Management

Posts tagged ‘Advanced Portal for SCSM 2012’

Advanced Portal for SCSM 2012 by CodeCraft-Solutions – Part 4: Troubleshooting


In our last post, we covered the Installation of the Advanced Portal for SCSM 2012. In this post, we will walk through some Troubleshooting steps.

According to the Installation Guide from the Vendor, here are the steps as requested by the Vendor.

 

Troubleshooting the Advanced Portal

If you have any problems with the installation, please collect some additional information, to help us in solving the issue.

Some tips, where you can find usable:

  • Windows Event Log (Application or Installation source)
  • Next to the deployment tool, you will find a trace.log file with verbose information about the deployment process.

SCSM Advanced Portal - TraceLogFile

  • DebugView is always helpful, it gives a little more information then the above mentioned log options.

If you have problems with starting, running the application, please send us the trace.*.log files found under the installation directory, with an error description. The logs are under the [sysdrive]:\Program Files (x86)\CodeCraft\AdvancedPortal” (or under the custom install directory).

If you notice my Trace.Application.Log file, you will notice that there are multiple entries that show “Initializing view before first use” and then some Hungarian text.

SCSM Advanced Portal - TraceApplicationLogFile

I have sent these Log files to the Vendor for further analysis/direction.

Alternatively, on the Settings page, you can choose English from the list of language, as displayed in the following screen shot.

SCSM Advanced Portal - Settings Page (Language List)

Obviously, unless you read Hungarian, you might have a hard time finding the Save button to apply the language change. Near the top left on the Settings page, look for the button labelled “Mentés” which is “Save” in Hungarian.

SCSM Advanced Portal - Settings Page (Save)

The site will re-load after the language re-configuration, and will finally be shown in English.

SCSM Advanced Portal - Settings Page (English)

SCSM Advanced Portal - Home Page (English)

Hopefully the Vendor will correct this minor issue, and update the installer.

UPDATE: I have received a response back from the Vendor, indicating that “Yes, it’s a good point. We will add an option to the installer, for choosing language. There is a configuration file, inside the installation package, with the default portal language. This is set by the build server. In this case it was built for Hungarian.

 

Default Portal Views

Additionally, the Vendor also provided the following additional information (with some screenshots added by me for clarity).

The default views on the portal are generated on the first installation. So probably you will have them with Hungarian labels. However you can rename them, I’ll describe you below, how you can re-generate them with English labels.

Stop the Advanced Portal site in the IIS Manager.

SCSM Advanced Portal - Stop Website

On the Service Manager Management Server, open the Service Manager console, navigate to Administration > Management Packs, and delete the “CodeCraft EnterpriseManagement Common Library“.

SCSM Advanced Portal - Delete CodeCraft MP

Back on the Advanced Portal web server, open Windows Explorer and navigate to the Advance Portal installation directory (by default at C:\Program Files (x86)\CodeCraft\AdvancedPortal). Within the this directory, look for the Web.Config file, and open it (i.e. in Notepad).

SCSM Advanced Portal - Install Directory

With the Web.Config file open in an editor, find the line “<add key=”IsDeployment” value=”false” />”, and change the Value to “true”. In the Web.Config file, this should be at Line 73.

SCSM Advanced Portal - WebConfig - IsDeploymentKey

Also find the line “<globalization culture=”en-US” uiCulture=”en-US” />”, and confirm that it is set to “en-US”. In the Web.Config file, this should be at Line 81.

SCSM Advanced Portal - WebConfig - GlobalizationKey

Once you have made these changes save the Web.Config file. Go back into the Internet Information Services (IIS) Manager, and Start the website.

SCSM Advanced Portal - Start Website

Re-launch the website in a browser. This will cause the Advanced Portal to re-import the required Management Packs, and should generate the Views in English. Also, the “IsDeployment” key will automatically be changed back to “False”. This worked successfully in my testing.

SCSM Advanced Portal - Home Page (English)

Well, that’s my review/experience with the Advanced Portal for SCSM. Give it a try, and see if it will fill the current SCSM Portal gaps, and fill your company’s needs.

 

As always, if this post helped you in any way, and you would like to show your appreciation, please rate it and comment on it. Also, feel free to contact me (via the About Me page) with requests for future articles.

Advertisements

Advanced Portal for SCSM 2012 by CodeCraft-Solutions – Part 3: Installation


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.

SCSM Advanced Portal - Install Setup

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.

SCSM Advanced Portal - License Agreement

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.

SCSM Advanced Portal - Setup Details

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.

SCSM Advanced Portal - Settings Not Verified

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.

SCSM Advanced Portal - Installation Finished

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”.

SCSM Advanced Portal - Launch Error

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.

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.

SCSM Advanced Portal - Website Home

If you click on the gear icon in the top right corner, this will bring you to the Settings page.

SCSM Advanced Portal - Settings Page (Wrong Language)

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.

Advanced Portal for SCSM 2012 by CodeCraft-Solutions – Part 2: Requirements


In our last post, we were introduced to the Advanced Portal for SCSM 2012. In this post, we will walk through the Requirements, and get those ready.

Requirements

To be able to use the Advanced Portal, you need to ensure that the server it will be hosted on meets the following requirements prior to starting the installation:

  • Microsoft .NET Framework 4.5 (or later)
  • Web Server (IIS) Role (including Windows Authentication)
  • A Domain User account that is a member of the Service Manager Administrators role
  • Your Service Manager Management Server needs to be accessible over the network
  • Service Manager version 2012 (or higher, including SP1 or R2)

NOTE: It is not required to install the Advanced Portal on the same server as the Service Manager Management Server, therefore it can be on its own server.

Installing Internet Information Services

This walk through on installing the Web Server (IIS) server role has been done on Windows Server 2012 R2. If you are using a different Windows Server version other than Windows Server 2012 or R2, your steps may be slightly different.

Start by launching Server Manager from the taskbar.

Launch Server Manager

Click on Manage, and select Add Roles And Features.

Server Manager - Add Roles And Features

On the Before You Begin screen, click Next.

Add Roles And Features Wizard - Before You Begin

On the Installation Type screen, select Role-based or feature-based installation, then click Next.

Add Roles And Features Wizard - Installation Type

On the Server Selection screen, ensure that your web server is listed and selected, then click Next.

Add Roles And Features Wizard - Server Selection

On the Server Roles screen, scroll to the bottom of the Roles list and select Web Server (IIS).

Add Roles And Features Wizard - Server Roles

NOTE: You will be prompted with the following message. Click Add Features to continue. The Web Server (IIS) role should now be selected, then click Next.

Add Roles And Features Wizard - Required Features

On the Features screen, click Next.

Add Roles And Features Wizard - Features

On the Web Server Role (IIS) screen, click Next.

Add Roles And Features Wizard - Web Server Role (IIS)

On the Role Services screen, ensure that the following Role Services are selected, then click Next.

  • Web Server > Security > Basic Authentication (optional)
  • Web Server > Security > Forms Authentication (optional)
  • Web Server > Security > Windows Authentication
  • Web Server > Application Development > .NET Extensibility 4.5
  • Web Server > Application Development > ASP .NET 4.5
  • Web Server > Application Development > ISAPI Extensions
  • Web Server > Application Development > ISAPI Filters
  • Management Tools > IIS Management Console

Add Roles And Features Wizard - Role Services

On the Confirmation screen, click Install.

Add Roles And Features Wizard - Confirmation

Once the installation has completed, click Close.

Add Roles And Features Wizard - Results

We now have the Web Server (IIS) role installed.

In our next post, we will cover the actual Installation of the Advanced Portal.

Tag Cloud

%d bloggers like this: