This document is one of a group of documents on using the Alpha Anywhere Application Server for IIS. The documents are:
Note that server names and IP address have been blurred in accompanying images.
For a production environment the minimum IIS server version is 7.5 and Windows Server 2008 R2. The steps and images below are from IIS 8.0 and Windows Server 2012 Standard.
For a development environment Windows 7 (32-bit or 64-bit) is the minimum desktop version.
These instructions require that you are logged in as a local administrator.
These directions assume familiarity with IIS and Windows Server 2012. See Detailed steps to install IIS on Windows Server 2012 in the appendix for more detailed set of instructions if you are not familiar with IIS and Windows Server 2012. For a Windows 7 development machine see the Detailed Steps to Install IIs on Windows 7 in the appendix.
Include the Management Tools feature and select the Management Service. This service is required for publishing. The IIS Management Console is not required unless you want to manage IIS locally.
The image on the default page shows IIS 7, but the Help -> About dialog in IIS Manager shows the actual version.
The image on the default page does not show any version, but the Help -> About dialog in IIS Manager shows the actual version.
Download and run the Alpha Anywhere Application Server for IIS installer a5v12_ApplicationServerIIS.exe. The components are installed by default in the folder
C:\Program Files (x86)\A5V12 Application Server for IIS
See details about the components that are installed in the appendix. Of note, Alpha Anywhere Application Server for IIS uses the ASP.NET State Service for session state. This service is started if it isn’t running already and it is set to startup automatically by the installer.
Once the Alpha Anywhere Application Server for IIS is installed you will need to set the license key. Open IIS Manager, select the server node and open the License Information feature.
Enter your license key into the “License key” prompt and then click the apply link.
In order to properly license Alpha Anywhere Application Server for IIS the machine must have outbound port 443 open. The product will contact https://activation.alphasoftware.com to validate licensing and create and refresh a license lease.
The checkbox for “Store key with shared configuration” will only be enabled if you have first enabled “Shared Configuration” for your server. See Enabling Shared Configuration in the appendix for more information.
The license information data is stored in the registry under the key
HKEY_LOCAL_MACHINE\Software\Alpha Software\Alpha Anywhere Application Server for IIS 12.0
in the 32-bit hive. Use this key path when running 32-bit Windows 7 on a development machine. When running on a 64-bit server or development machine the key path is
HKEY_LOCAL_MACHINE\Software\WoW6432Node\Alpha Software\Alpha Anywhere Application Server for IIS 12.0
Alpha Anywhere Developer Edition publishes a web application directly to an IIS server. To publish directly to an IIS Server from Alpha Anywhere Developer Edition you are required to install two Microsoft components on the IIS Server.
The server requires Microsoft Web Deploy 3.5, adding the Management Service feature and enabling remote connections in IIS, and opening up some inbound ports with firewall rules on the server you want to publish to.
The Alpha Anywhere Developer Edition machine requires the IIS Management Console and Microsoft Web Deploy 3.5. Installing the IIS Management Console will install the required assembly Microsoft.Web.Administration.dll that is not redistributable and is needed for direct publishing. The IIS Management Console install can be found under the Control Panel’s “Programs and Features” section in the “Turn Windows features on or off” link on client operating systems (i.e. Windows 7 and Windows 8). Microsoft Web Deploy 3.5 will install the Microsoft.Web.Deployment assemblies.
To allow direct publishing from Alpha Anywhere Developer Edition to IIS you will need to make some configuration changes on the IIS server machine. Select the tab below for the type of operating system that IIS is installed on: Server OS for Windows Server 2008R2, 2012, or 2012R2; or Client OS for Windows 7, 8, or 8.1.
You will need to enable remote connections to IIS Management Service which will open up port 8172.
The following list is a summary of ports that are opened by these instructions.
Disabling remote connections (unchecking Enable remote connections) does not disable the inbound firewall rule for port 8172 Web Management Service (HTTP Traffic-In). This will have to be done manually to close that port.
To publish from Alpha Anywhere Developer Edition to an IIS server, the user you are publishing under needs to have local administrator access on the IIS server machine. The user or group a user is in also needs to be given privilege to run some utilities during publish. This privilege is the "Replace a process level token" privilege in the Local Security Policy. This is required so that a site and application pool can be created at publish time if needed. This privilege is also required so that server configuration can be validated to ensure that the web application will run as expected. Select the users and/or groups that are allowed to publish to IIS from Alpha Anywhere Developer Edition.
To select users and/or group that are allowed to publish go to the "Direct Publishing" feature in the Alpha Anywhere group in IIS Manager.
In the example image below, the machine's "administrators" group is given the "Replace a process level token" privilege so that the Alpha Anywhere Developer Edition will be able to publish using any user that is in the IIS server machine's local administrators group.
Publishing to IIS on a client operating system is only supported for development purposes. Publishing is done through "localhost". No other configuration is required in IIS for this case.
Finally, add the Web deploy extension to IIS.
Click on the "Get New Web Platform Components" link in IIS Manager when the server node is selected in the Connections pane on the left. Note: You may need to download the Microsoft Web Platform Installer manually if using Windows Server 2008R2 with IIS 7.5.
Search for web deploy
Click Add and then Install.
This completes the configuration for publishing directly from Alpha Anywhere Developer Edition to IIS. Continue to the Alpha Anywhere Application Server for IIS Getting Started Guide to publish a sample application to IIS.
In the Server Manager select Add roles and features.
Select Next through the Before You Begin page and then select Role-based or feature-based installation on the Installation Type page.
Select your server on the Server Selection page.
Select Web Server (IIS) in the list of roles on the Server Roles page.
Note: If you already have IIS installed Web Server (IIS) will have (Installed) appended to it.
When you select Web Server (IIS) the wizard will prompt you to add management tools for IIS. As the dialog states, you will need these tools to manage IIS. If you don’t have these tools installed anywhere else or if you want to manage IIS locally you will need to add this feature. If you are unsure, add the features. You can remove the features later if you decide you don’t want or need IIS management tools local to the server.
Select ASP.NET 4.5 on the Features page.
Continue through the wizard until you get to Role Services page for Web Server Role (IIS).
Note: If IIS had already been installed the feature selection nodes of the tree will be listed under the “Web Server (IIS) (Installed)” node rather than as a separate “Web Server Role (IIS)” step in the wizard.
There is 1 default setting that must be selected and 4 default settings that you may want to change.
The default setting that must be selected is:
This required setting will also automatically select 3 other settings
The 4 default settings that you may want to change are:
Select Next and then Install on the Confirmation page.
Once the install is complete return to the IIS Install steps to verify the IIS install and then continue from there to install Alpha Anywhere Application Server for IIS and configure direct publishing.
There are six modules of note installed for the Alpha Five Application Server for IIS.
This program registers all of the components, updates IIS and .NET framework configuration files, sets file read access permissions on IIS’ redirection.confg file, will start IIS’ built-in state server service ASP.NET State Service and set that service to automatic startup. The installer runs this program. You should not need to run it again unless you are instructed to do so by support..
This .NET assembly is used to initialize the configuration of a web application on startup.
This .NET assembly contains the module and handlers that are used by IIS to service web requests. This is the core of the IIS integration logic.
IIS Manager Extensions
The .NET assemblies A5IISManagerClient.dll and A5IISManagerServer.dll are IIS Manager Extensions. The client component (A5IISManagerClient.dll) is automatically downloaded from the server where it is installed when a client running IIS Manager connects to the server. A5IISManagerServer.dll provides access to the web.config file sections that make up the Alpha Anywhere Application Server for IIS configuration.
This is technically part of the development environment. A5IISPublish.dll is an assembly that is registered and loaded into the Alpha Anywhere development environment to provide publication services.
Open the control panel by selecting the option from the Start menu. The All Control Panel Items dialog will be displayed.
Double click on Programs and Features from the list of items on the All Control Panel Items display. The Programs and Features dialog will be displayed.
On the left of the Programs and Features dialog you will see a link labeled "Turn Windows Features on or off". Click on this link to open the Windows Features Dialog as shown below.
If it is not already checked, check the box labeled World Wide Web Services to install IIS. Be sure to open the Application Development Features and check ASP.NET as well. You should see some other items automatically become checked.
Click the button labeled OK to continue installation.
When IIS Manager starts it will prompt you to download the Microsoft Web Platform Installer if you don't already have it installed. If you do not have it installed already, install it. It should launch after installation, but if it does not or you already have it installed click on the "Get New Web Platform Components" link in IIS Manager when the server node is selected in the Connections pane on the left.
Search for Application Initialization
Click Add and then Install.
IIS has the concept of a shared configuration where multiple servers use a single configuration stored in a shared folder. This feature is available when the server node is selected in IIS Manager.
Read the IIS documentation for more information on this feature. When this feature is enabled and you choose “Store key with shared configuration” in the Alpha Anywhere Application Server for IIS License Information feature, the license key will be written to a file in the shared configuration folder. The name of the file is Alpha Anywhere Application Server for IIS 12.0.lic
© Copyright Alpha Software Corporation 2000-2015