Enhancing Microsoft Content Management Server with ASP.NET 2.0 — Save 50%
Use the powerful new features of ASP.NET 2.0 with your MCMS Websites
Installing MCMS 2002 Prerequisites
Before we can proceed with the installation of MCMS itself, we need to install two prerequisites. Installation of MCMS will be halted if these prerequisites are not met.
- J# 2.0 redistributable:
Elements of MCMS Site Manager require the J# redistributable.
- Internet Explorer Web Controls for MCMS:
Portions of the MCMS Web Author make use of the Internet Explorer Web Controls (IEWC), of which a specific MCMS distribution exists for which compilation is unnecessary. These controls, unlike the standard IEWC, are supported as part of an MCMS installation. As they are a prerequisite for MCMS, IEWC can be utilized within your applications. However, ASP.NET 2.0 offers far richer controls for navigation, as we will see later in this book.
J# 2.0 Redistributable
We need to install the Visual J# 2.0 Redistributable to enable the installation of the MCMS Site Manager.
- Download and save the J# 2.0 installer from: http://www.microsoft.com/downloads/details.aspx?familyid=f72c74b3-ed0e-4af8-ae63-2f0e42501be1&displaylang=en
- Double-click the installer.
- On the Welcome to Microsoft Visual J# 2.0 Redistributable Package Setup page, click Next.
- On the End User License Agreement page, check the I accept the terms of the License Agreement checkbox and click Install.
- Wait while J# 2.0 installs, and when the Setup Complete page appears, click Finish.
Internet Explorer Web Controls for MCMS
Internet Explorer Web Controls (IEWC) are required by the MCMS Web Author.
- Download and save the IEWC installer from: http://www.microsoft.com/downloads/details.aspx?FamilyID=FAC6350C-8AD6-4BCA-8860-8A6AE3F64448&displaylang=en
- Double-click the installer.
- On the Welcome to the Microsoft Internet Explorer WebControls Setup Wizard page, click Next.
- On the License Agreement page, select the I Agree radio button and click Next.
- On the Confirm Installation page, click Next.
- Wait while the web controls are installed, and when the Installation Complete page appears, click Close.
Installing MCMS 2002 SP1a
- Insert the MCMS 2002 SP1a CD-ROM, and on the splash screen, click Install Components.
- On the Customer Information page, enter your User Name and Organization along with your Product Key and click Next.
- On the License Agreement page, click Accept.
- On the Installation Options page, select the Custom radio button and click Next.
- On the Custom Installation page, deselect the Site Stager item, and click Next.
- On the Summary page, click Install.
- Wait while MCMS 2002 SP1a is installed.
- On the Installation Completed page, uncheck the Launch MCMS Database Configuration Application checkbox, and click Finish.
Remove Temporary Items
Now MCMS SP1a is installed, we can tidy up the temporary items we created earlier to trick the installer.
- Select Start | Run.
- In the Run dialog, type cmd and click OK.
- Execute the following commands:
cscript VS2003ByPass.vbs c:\VSTemp remove
- Use Windows Explorer to delete the folders c:\VSTemp and c:\kb915190.
Install Visual Studio 2005
- Insert the Visual Studio 2005 DVD, and on the splash screen, click Install Visual Studio 2005.
- On the Welcome to the Microsoft Visual Studio 2005 installation wizard page, click Next.
- On the Start Page, select the I accept the terms of the License Agreement checkbox, enter your Product Key and Name, and click Next.
- On the Options Page, select the Custom radio button, enter your desired Product install path, and click Next.
- On the second Options Page, select the Visual C# and Visual Web Developer checkboxes within the Language Tools section, and the Tools checkbox within the .NET Framework SDK section. Ensure that all the other options are not selected and click Install.
Feel free to install any additional features you may wish to use. The above selections are all that are required for following the examples in this article.
- Wait (or take a coffee break) while Visual Studio 2005 is installed. When the Finish Page appears, click Finish.
- From the Visual Studio 2005 Setup dialog, you can install the product documentation (MSDN Library) if desired, otherwise click Exit.
- From the Visual Studio 2005 Setup dialog, click Check for Visual Studio Service Releases to install any updates that may be available.
- Click Exit.
Install MCMS SP2
- From the Start Menu, click Run.
- In the Open textbox, enter IISRESET /STOP and click OK.
- Wait while the IIS Services are stopped.
- Double-click the SP2 installation package.
- On the Welcome to Microsoft Content Management Server 2002 SP2 Installation Wizard page, click Next.
- Select I accept the terms of this license agreement radio button, and click Next.
- On The wizard is ready to begin the installation page, click Next.
- Wait while Service Pack 2 is installed.
- On The Installation Wizard has completed page, click Finish.
- If prompted, click Yes on the dialog to restart your computer, which will complete the installation.
- Otherwise, from the Start Menu, click Run.
- In the Run textbox, enter IISRESET /START and click OK to restart the IIS services.
Stopping IIS prior to the installation of SP2 avoids potential problems with replacing locked files during the installation, and can prevent the requirement to reboot.
eBook Price: $22.99
Book Price: $37.99
Configuring the Development Environment
Before continuing, we need to look at a small number of additional steps required to configure the development environment.
Site Manager Shortcut
During the installation of SP2, the Site Manager Start-menu shortcut will be overwritten. To configure Site Manager to bypass the Connect To dialog, follow the steps here:
- Select Start | All Programs | Microsoft Content Management Server.
- Right-click the Site Manager shortcut and click Properties.
- In the Target textbox, replace
"C:\Program Files\Microsoft Content Management Server\Client\NRClient.exe" http:///NR/System/ClientUI/login.asp
"C:\Program Files\Microsoft Content Management Server\Client\NRClient.exe" http://localhost/NR/System/ClientUI/login.asp.
- Click OK.
Visual Studio Templates
The installation of MCMS Service Pack 2 automatically registers the MCMS developer tools such as MCMS Template Explorer in Visual Studio 2005. However, before we can create MCMS applications with Visual Studio, we need to make the website and item templates available.
- Select Start | All Programs | Microsoft Visual Studio 2005 | Visual Studio Tools | Visual Studio 2005 Command Prompt.
- Execute the following commands, replacing MCMS_INSTALL_PATH with the installation location of MCMS (usually C:\Program Files\Microsoft Content Management Server) and PATH_TO_MY_DOCUMENTS_FOLDER with the location of your My Documents folder:
xcopy "MCMS_INSTALL_PATH\DevTools\NewProjectWizards80\Visual Web Developer" "PATH_TO_MY_DOCUMENTS_FOLDER\Visual Studio 2005\Templates\ProjectTemplates\Visual Web Developer" /E
xcopy "MCMS_INSTALL_PATH\DevTools\NewItemWizards80\Visual Web Developer" "PATH_TO_MY_DOCUMENTS_FOLDER\Visual Studio 2005\Templates\ItemTemplates\Visual Web Developer" /E
- Execute the following command to register the templates with Visual Studio 2005:
- Close the command prompt.
It is not necessary at this stage to register ASP.NET as detailed in the Microsoft Installation Instructions (KB 906145). This registration was performed by the Visual Studio 2005 installer.
Additionally, it is unnecessary to configure IIS to use ASP.NET 2.0 using the Internet Information Services snap-in, as Visual Studio 2005 automatically sets this option on each MCMS website application created.
However, if you are installing on Windows Server 2003 SP1, you must configure the Virtual Website root and the MCMS Virtual Directory to use ASP.NET 2.0, as it is not possible to use two versions of ASP.NET within the same Application Pool.
The ActiveX Toolbar control that supports the out-of-the-box Placeholder controls is updated with SP2. Therefore, you may be prompted to install this control when switching to edit mode for the first time.
You can pre-install the controls using regsvr32 or Group Policy as detailed at http://download.microsoft.com/download/4/2/5/4250f79a-c3a1-4003-9272-2404e92bb76a/MCMS+2002+-+(complete)+FAQ.htm#51C0CE4B-FC57-454C-BAAE-12C09421B57B.
Run the Database Configuration Application
- Select Start | Programs | Microsoft Content Management Server | Database Configuration Application.
- On the splash screen, click Next.
- On the Choose the MCMS Content Server ASP compatibility mode page, select the ASP.NET Mode radio button and click Next.
- On the Please select a virtual site for hosting the Microsoft Content Management Server page, select the Read/Write Site radio button, and click Next.
- On the SCA Web Entry Point page, click Next.
- When prompted about a security warning, click Yes (as there are no means to further secure the SCA on Windows XP).
When Installing on Windows Server 2003 SP1
Select the additional Virtual Website created earlier in the Installing Internet Information Services section as the SCA Web Entry Point.
- On the MCMS System Account page, enter the account details as created in the Creating Service Accounts section earlier and click Next.
- On the Grant right? dialog, click Yes.
- On the Stop service? dialog, click Yes.
- On the Select MCMS Database screen, click the Select Database button.
- In the SQL Server Logon dialog, enter a period (.) in the Server textbox, and click Options. In the Database combo box, select TropicalGreen and click OK.
A period (.) is the Netbios/RPC alias for the local machine. If the SQL Server Client libraries can determine that SQL Server is on the local machine, applications will use shared memory rather than a network protocol to access SQL Server when it is installed on the same machine as the application. This configuration can also be controlled using the SQL Client configuration utility.
- On the Select MCMS Database page, click Next.
- On the Empty Database dialog, click Yes.
- On the Database Population page, click Next and wait while the MCMS Schema is installed.
- On the Select Initial MCMS Administrator page, enter the account details for the currently logged-on user, and click Next.
- Wait while the changes are committed, and on the MCMS Site Stager Access Configuration page, click Next.
- On the DCA dialog, click Finish to launch the Server Configuration Application, and verify your settings.
- Close the SCA.
This completes the configuration of MCMS.
Remove Visual Studio.NET 2003
If you intend to only develop with Visual Studio 2005, you can now remove Visual Studio.NET 2003 (if you installed it previously) as it is no longer required.
Known Issues with MCMS SP2 Installation
There are a few known issues related to the installation of MCMS SP2 for which hotfixes have been released.
- DCA complains about missing privileges when selecting a database when SQL authentication is being used. A hotfix for this has been released and can be requested from Microsoft Support as KB 913400.
- Developer tools for VS.NET 2003 disappear after installing MCMS 2002 Service Pack 2. A hotfix for this has been released and can be requested from Microsoft Support as KB 914195.
- Developer Tools for VS.NET 2003 do not work with some regional settings. A hotfix for this has been released and can be requested from Microsoft Support as KB 914195.
In addition if you have performed a fresh installation of MCMS SP2 and wish to move an existing database to your new installation, you need to obtain the KB913401 hotfix and follow the steps detailed in the Prepare the MCMS Database for SQL Server 2005 section under our discussion on upgrading to MCMS 2002 Service Pack 2 towards the beginning of this article.
The following section provides two tips for installations on different editions of Windows or across separate machines.
Installing MCMS SP2 on Windows Server 2003 X64 Edition
MCMS Service Pack 2 introduces support for 64-bit versions of Windows Server 2003. However MCMS requires IIS to be configured to run in 32-bit compatibility mode. This means that all IIS applications (not just MCMS ones) cannot take advantage of the additional addressable memory on the X64 platform. In order to install MCMS SP2 on this platform, the following extra steps are necessary:
- ASP.NET 2.0 must be manually registered with IIS by executing the aspnet_regiis utility.
- IIS must be configured to run in the 32-bit compatibility mode, using the following command from the c:\Inetpub\adminscripts folder:
cscript adsutil.vbs set w3svc/AppPools/Enable32bitAppOnWin64 1
Installing the Required SQL Server 2005 Components
When making use of SQL Server on separate machine from the one running MCMS SP2, there is a prerequisite for SQLDMO, also known as SQL Server Client Tools, on the MCMS machine. This can be installed from your SQL Server 2005 distribution by:
- Clicking the Advanced button on the Components to Install dialog.
- Expanding the Client Components item.
- Selecting the Legacy Components item.
We have completed either an upgrade to SP2 or a new installation. In addition, we have covered the necessary configuration steps to avoid common problems with MCMS installation, seen how to avoid installing Visual Studio.NET 2003, and some additional installation tips. We are now ready to explore the MCMS SP2 development environment.
If you have read this article you may be interested to view :
- Installation And Configuration of Microsoft Content Management Server: Part 1
- Getting Started with the Development Environment Using Microsoft Content Management Server
- Using ASP.NET Master Pages in your MCMS Applications
eBook Price: $22.99
Book Price: $37.99
About the Author :
Lim Mei Ying is a Senior Consultant at Avanade, a global technology integrator specializing in the Microsoft platform. Mei Ying has extensive experience in designing, implementing and supporting enterprise web applications as well as setting up Microsoft Content Management Server (MCMS) systems across the enterprise. An active contributor to the Microsoft newsgroup community, she has spent many hours figuring out the dos and don'ts of MCMS technologies, and thrives on the challenge of finding new ways to solve MCMS-related problems. Mei Ying, who has earned the prestigious title of Microsoft's Most Valuable Professional award for Content Management Server. Mei Ying lives on the sunny island of Singapore and blogs at meiyinglim.blogspot.com
Spencer, a MCSD for Microsoft .NET, MCSE and MVP for MCMS, has over twelve years commercial experience of architecture, design, development, deployment and operational support of Web based applications and hosting platforms for some of Europe's largest organisations.
Spencer maintains www.mcmsfaq.com - a MCMS resources portal, and is active in the public newsgroups. His experience of MCMS goes back to the days of NCompass Resolution and he has been involved in many enterprise implementations.
Currently working as an independent consultant, Spencer delivers enterprise content management and portal systems architecture, design, development and deployment solutions, application security best practices, threat modeling and the implementation of highly available Windows Server System based hosting platforms.
Product expertise includes MCMS, SharePoint Technologies, IIS, SQL Server, Commerce Server and BizTalk Server, Windows Security, PKI and High Availability.
Selected clients include Barclays Bank, Scottish Power plc, HBOS, Microsoft, The Royal Bank of Scotland, Scottish Enterprise, Centrica, Clifford Chance, The Automobile Association and BASF
Stefan Goßner works for Microsoft as an Escalation Engineer in the Developer Support department. He provides customers with technical solutions to problems related to Microsoft Internet Server Products. Stefan has breadth and depth in all areas of MCMS.
His contributions to the newsgroup have helped many people to implement MCMS solutions in corporations around the globe to the point where it has been said that if you don't know Stefan, then you're probably new to MCMS.
Stefan maintains a huge MCMS 2002 FAQ on the Microsoft Website and provides MCMS tips and tricks on his personal blog: http://blogs.technet.com/stefan_gossner.
He lives in Munich, Germany.