Ensim Pro for Windows 2003 Installation Guide

Transcription

1 Ensim Pro for Windows 2003 Installation Guide Published: 14 December 2006

2 This document contains information proprietary to Ensim Corporation and its receipt or possession does not convey any rights to reproduce, disclose, manufacture, or sell anything it might describe. Reproduction, disclosure, or use without Ensim s specific written authorization is strictly forbidden. Ensim Corporation makes no representations or warranties with respect to the contents or use of this document. It also reserves the right to revise this publication and make changes to the content at any time, without the obligation to notify any person or entity of such revisions or changes. Further, Ensim Corporation assumes no responsibility or liability for any errors or inaccuracies, makes no warranty of any kind (express, implied or statutory) with respect to the contents or use of the information, and expressly disclaims any and all warranties of merchantability, fitness for particular purposes, and non-infringement of third party rights. Ensim and the Ensim logo are registered trademarks of Ensim Corporation. All other trademarks are the property of their respective owners Ensim Corporation. All rights reserved. CORPORATE HEADQUARTERS ENSIM CORPORATION 1366 Borregas Avenue Sunnyvale, California (408) ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 2

3 Contents About this guide 5 Introduction...5 Intended audience and required skills...5 Related documentation...5 Online Help...6 Document conventions...6 Support and feedback...6 Chapter 1 Preparing for the installation 8 Introduction...8 System requirements...8 Hardware requirements...8 Software requirements...9 Web browser requirements...10 Other requirements...10 Installation drive requirements...10 Ports used by Ensim Pro and other supported third-party applications...10 License requirement...11 Software included with Ensim Pro...11 Chapter 2 Installing Ensim Pro Introduction...12 Installation overview...12 Interactive installation instructions...12 Installing Ensim Pro Installing the online Help...20 Verifying successful installation...21 Troubleshooting...21 Post-installation tasks...21 Next steps...21 Chapter 3 Logging in as the server administrator 22 Introduction...22 Logging in as the server administrator...22 Appendix A Installing Microsoft SQL Server 2005 Express Edition 25 Introduction...25 Installation instructions...25 ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 3

4 CONTENTS Verifying successful installation...35 Post-installation tasks...36 Appendix B Installing add-ons for ColdFusion, Urchin, IMail, and MySQL 37 Introduction...37 Installing the ColdFusion add-on...37 Installing the Urchin add-on...38 Installing the IMail Server add-on...39 Known limitations of IMail Server Installing the MySQL add-on...40 Verifying the success of the add-on installation...42 Appendix C Silent installation of Ensim Pro Introduction...44 Silent installation overview...44 Installation instructions...44 Installing Ensim Pro and online Help...44 Installing the add-ons (optional)...46 Verifying the success of the installation...48 Troubleshooting...49 Appendix D Uninstalling and reinstalling Ensim Pro Introduction...50 Cancelling the Ensim Pro installation...50 Uninstalling Ensim Pro and its add-ons...50 Reinstalling Ensim Pro Glossary 52 Index 56 ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 4

5 About this guide Introduction This guide provides instructions for installing to Ensim Pro for Windows It also provides information about logging in as the server administrator and installing add-ons for ColdFusion MX 6.1, Urchin 5.x, IMail Server 8.21, and MySQL 4.1 or 5.0. Note: For simplicity, Ensim Pro for Windows 2003 is referred to as Ensim Pro throughout this document. Intended audience and required skills This guide is intended for those who need to set up and use Ensim Pro, including system administrators, technical support staff of Internet service providers (ISPs), or anyone who wants to host sites on a Microsoft Windows Server 2003 server using Ensim Pro. To use this guide, you need to be familiar with the Windows Server 2003 platform as well as general Internet applications. In addition, you should have some or all of the following skills. Using the Microsoft Windows Server 2003 operating system as a system administrator Experience with networking applications Understanding of system security Understanding of DNS Related documentation For a list of related documentation, see the Ensim Pro for Windows release notes. Documentation is also available in the Ensim Pro for Windows section of the Ensim Support site, All customers receive passwords that allow access to this site. If you do not have a password, contact your organization s liaison to Ensim. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 5

6 ABOUT THIS GUIDE Online Help The Ensim Pro control panel provides comprehensive online Help designed to answer questions and help you find the information you need, when you need it. To access online Help, log in to the control panel, then click the Help links on the lower left navigation panel. To get help for a specific page, click on the upper right side of forms. Document conventions Throughout this guide, specific fonts are used to identify user input, computer code, and user interface elements. The following table lists conventions used in this guide. Table 1. Document conventions Convention How it is used Bold text, serif font Used for information you type as well as for file names, path names, and CD names. Example: On the command line, type continue. Italic text Bold, italic text enclosed in angle brackets Bold text, sans serif font Non-proportional font Used for column names, field names, window names, and book titles. Example: The Select Installation Folder window is displayed. Used for variables you replace with the appropriate information. Example: Type <server_name> where <server_name> is the IP address or host name of your server. Used for items you click or press, such as buttons, menus, and command keys. Example: Click Start > Settings > Control Panel. Used for system messages, screen text, and code examples. Example: The following message is displayed: The server has been added. Note: In addition, key information is sometimes displayed using special headings and formats, such as this one, to make it stand out from regular text. Support and feedback For Ensim online support or feedback, use the following links: to create an Ensim Support account and access other documentation. to log in to Ensim Support using an existing account to search the knowledge base to provide feedback to Ensim ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 6

7 ABOUT THIS GUIDE Note: All customers receive passwords that allow access to the Ensim Support site. If you do not have a password, contact your organization s liaison to Ensim. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 7

8 C HAPTER 1 Preparing for the installation Introduction This section explains how to prepare for the Ensim Pro installation. In this section: System requirements...8 Other requirements...10 License requirement...11 Software included with Ensim Pro...11 System requirements The following sections list the minimum hardware, software, and Web browser requirements for installing and accessing Ensim Pro Hardware requirements The following table lists the minimum hardware requirements for Ensim Pro Important: While installing Ensim Pro , ensure that the server is connected to the Internet, since Ensim Pro needs to communicate with the Ensim License Manager to register its license. Table 2. System requirements Operating system Processor (recommended) Memory (RAM) Free Disk space File System Microsoft Windows Server 2003 Standard, Enterprise or Web edition Intel Pentium III 733 MHz or higher Minimum 256 MB of RAM; 1 GB of RAM is recommended 40 GB NTFS Note: Ensim Pro is compatible with the default installation of Microsoft Windows Server 2003 Service Pack1 (SP1). ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 8

9 PREPARING FOR THE INSTALLATION CHAPTER 1 Software requirements Ensure that you have obtained the following software required for the Ensim Pro installation: Microsoft Windows Server 2003 (Standard, Enterprise or Web edition) - English: You must install the operating system on the server used for installing Ensim Pro Ensim Pro also requires certain Windows components to be pre-installed on the server. For more information,refer to the server requirements ("Windows Server 2003 requirements" on page 9). Note: If you have installed Windows Server 2003 release 2 on the server used for installing Ensim Pro , you do not have to install the below-mentioned Microsoft Windows Server 2003 Service Pack1 (SP1). Microsoft Windows Server 2003 Service Pack1 (SP1): You must install Service Pack1 on the server before installing Ensim Pro Microsoft.NET 2.0: You must install.net 2.0 on the server before installing Ensim Pro Microsoft SQL Server 2005: You must install the database on the server before installing Ensim Pro Ensim Pro supports all editions of SQL Server If this database is not already on the Ensim Pro server, download the SQL Server 2005 Express Edition (SQL Server Express) installation file, SQLEXPR.exe from DCC397514B41&displaylang=en. For installing SQL Server Express refer to the installation instructions ("Installing Microsoft SQL Server 2005 Express Edition" on page 25). Optional: For installing the Ensim Pro add-ons, you need to install the following applications: ColdFusion MX 6.1 Urchin 5.x IMail Server 8.21 from Ipswitch Collaboration Suite MySQL 4.1 or 5.0, and MyODBC 3.51 Important: Before starting the Ensim Pro installation, ensure that ActivePerl, PHP, Webalizer, or Power Tools are not installed on the Ensim Pro server. If any of these software applications are installed, then you must uninstall them before installing Ensim Pro. Windows Server 2003 requirements This section describes the Ensim Pro requirements specific to Windows Server Before installing Ensim Pro , ensure that the following components and services of Windows Server 2003 are installed on the server. These components and services are accessible through the Add/Remove Windows Components section of the Add or Remove Programs utility. Domain Name System (located under Networking Services) ASP.NET Internet Information Services (IIS) Ensure the following components/services are present under IIS: Common Files File Transfer Protocol (FTP) Service FrontPage 2002 Server Extensions ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 9

10 PREPARING FOR THE INSTALLATION CHAPTER 1 Internet Information Services Manager SMTP Service World Wide Web Service Ensure the following components/services are installed under World Wide Web Service: Active Server Pages, Remote Administration (HTML), Server Side Includes, and World Wide Web Service. QoS Packet Scheduler (located under Local Area Connection Properties) Important: Ensim Pro is not compatible with Active Directory Services (ADS). Before installing Ensim Pro , ensure that the Active Directory Services component is not installed. However, Ensim Pro is compatible with Active Directory Application Mode (ADAM), and can be installed on a server pre-installed with ADAM. Web browser requirements To access the Ensim Pro interface (after installing Ensim Pro ), you need Microsoft Internet Explorer (IE), version 6.0 or later, with cookies enabled. Using earlier versions of IE or other browsers to access the control panel is not recommended. Note: The Ensim Pro interface is best viewed in Microsoft Internet Explorer, version 6.0 or later, with a 1024 X 768-pixel screen resolution (or higher) and 16-bit color (or higher). You must set the Web browser s security level to Medium, since the default High security level used in Windows Server 2003 prevents the use of certain Ensim Pro features. Other requirements Installation drive requirements Before installing Ensim Pro on a server, ensure that all the drives where the Ensim Pro program and site or domain data files are stored have the NTFS file system. Ports used by Ensim Pro and other supported third-party applications Ensure that the following ports used by Ensim Pro and other supported third-party applications are open. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 10

11 PREPARING FOR THE INSTALLATION CHAPTER 1 Table 3. Ports used by Ensim Pro and other supported third-party applications Name of the Ensim Pro service or supported third-party application Port used Ensim License Manager 80 or 8080 FTP service for name-based sites FTP site identifier Note: The FTP site identifier can be obtained by going to Start > Programs > Administrative Tools > IIS Manager, expanding the server name, and clicking FTP Sites. FTP service for IP-based sites 21 IIS Web service (Standard) 80 IIS Web service (SSL) 443 Imail Server 8383 Urchin 9999 (default) Note: This port number can be changed while installing Urchin. License requirement You need a valid license key before you can install Ensim Pro When you buy Ensim Pro from the Ensim Storefront ( you receive the license key in the order confirmation from Ensim. Ensim Pro requires a valid license for a pre-determined number of sites, for example, a 250- domain license. Software included with Ensim Pro Ensim Pro includes the following applications: ActivePerl PHP Webalizer 2.01 Power Tools ImageMagick ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 11

12 C HAPTER 2 Installing Ensim Pro Introduction This section explains how to install Ensim Pro on a server with Windows Server 2003 operating system. In this section: Installation overview...12 Interactive installation instructions...12 Verifying successful installation...21 Post-installation tasks...21 Next steps...21 Installation overview You can install Ensim Pro using either of the following two modes: Interactive installation. This mode uses a graphical user interface that requires you to oversee the entire installation process. This mode is recommended for users installing Ensim Pro for the first time on a single Ensim Pro server. For instructions on interactive installation of Ensim Pro , proceed to the next section. Silent installation. This text-based mode is executed using the Windows command line. In this mode, you must specify all the information required by the installer before starting the installation process. Silent installation does not require you to oversee the entire installation process. It is recommended for users installing Ensim Pro on multiple servers. For more information, see the silent installation instructions ("Silent installation of Ensim Pro " on page 44). Interactive installation instructions This section provides instructions for installing Ensim Pro using the graphical mode. Time required for complete installation: Minimum 30 minutes, depending on system configuration. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 12

13 INSTALLING ENSIM PRO CHAPTER 2 Installing Ensim Pro Before starting the Ensim Pro installation, ensure that the server where you are installing Ensim Pro meets all the requirements in the preparation section ("Preparing for the installation" on page 8). To install Ensim Pro : 1 Log in as the administrator to the server where you are installing Ensim Pro and run the Ensim Pro for Windows.msi file: If you have the Ensim Pro CD, insert the CD in the server s CD-ROM drive, browse to the ensimpropromo directory on the CD and run Ensim Pro for Windows.msi. If you do not have the Ensim Pro CD, download the Ensim Pro installation files from the location given in the purchase order from Ensim. Browse to the directory, where you have stored the Ensim Pro installation files, and run Ensim Pro for Windows.msi. The Welcome window opens. Note: The installation process brings up a number of windows. These windows contain the following buttons: Back Opens the previous installation window. You can use this button to change or view any information entered in the previous window. Next Opens the next installation window. Cancel Cancels the installation. For information about the effects of canceling the installation, see Canceling the Ensim Pro installation (page 50). ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 13

14 INSTALLING ENSIM PRO CHAPTER 2 2 Click Next. The License Agreement window opens. 3 Read the contents of the License Agreement window carefully. If you agree to the terms of the License Agreement, select I accept the terms in the license agreement, then click Next. The License Key Dialog window opens. If you do not agree with the license agreement terms, click Cancel. Important: You must accept the license agreement to continue with the installation. Clicking Cancel aborts the installation. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 14

15 INSTALLING ENSIM PRO CHAPTER 2 4 When you buy Ensim Pro from the Ensim Storefront, the 25-character license key for using Ensim Pro is ed to you. In the License Key Dialog window, type this 25-character license key, then click Next. 5 In the Customer Information window, enter your name, company name, and address in the text boxes User Name, Organization, and Contact respectively. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 15

16 INSTALLING ENSIM PRO CHAPTER 2 Note: All three text boxes are mandatory. The address entered in the Contact text box is used by Ensim Pro for notifications. 6 Click Next. The Destination Folder window opens. 7 In the Destination Folder window, select the location on the server where the Ensim Pro program files will be installed. This folder must be on an NTFS partition or drive. The default location is C:\Program Files\Ensim\WEBppliance. Click Change to select a new folder. In the Site Data location section, select the location on the server where the site data files will reside. This can be a folder on any NTFS drive. The default location is C:\Program Files\Ensim\WEBppliance\SiteData. Click Change to select a new folder. This location is also used to store the server administrator s and reseller administrator s customization data. Important: Do not remove this directory even if you change the site data location later from the Ensim Pro control panel. 8 Click Next to proceed with the installation. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 16

17 INSTALLING ENSIM PRO CHAPTER 2 The Customer Information window opens. 9 In the Customer Information window, enter a password for the default control panel administrator (called admin) in the Password text box. Ensure that the password contains at least six characters. Important: If you have enabled complex password policy settings on the Ensim Pro server, ensure that the password you specify meets the complexity requirements; otherwise the admin user creation will fail. Use the login name admin and the password you enter in the Customer Information window to log in as the server administrator later. For more information about logging in as the server administrator, see Logging in as the server administrator. 10 Enter the password again in the Re-type Password text box and click Next. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 17

18 INSTALLING ENSIM PRO CHAPTER 2 The Network Settings window opens. 11 In the Network Settings window, enter the network settings of the server where you want to install Ensim Pro Enter or select values in the following fields. IP address From the drop-down list, select an IP address from the list of available IP addresses, for example, This IP address is assigned to all name-based sites. Fully qualified domain name Enter the fully qualified domain name (FQDN) of the server, for example, servername.example.net. The FQDN consists of a host and domain name. If your server is not a part of any domain, you can enter only the host name in this text box. The FQDN must resolve to the above IP address through the Internet (and not only through your LAN or intranet). 12 Click Next to proceed with the installation. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 18

19 INSTALLING ENSIM PRO CHAPTER 2 The Ready to Install window opens. 13 In the Ready to Install window, click Install to start the installation. To review any of the settings, click Back. 14 When the Ensim Pro installation is complete, the Installation Completed window opens. Select from the following two options and click Finish to complete the installation. Launch Ensim Pro for Windows: Select this check box to open the control panel login window. You can log in to Ensim Pro as the server administrator from here. For instructions about logging in as the server administrator, see Logging in as the server administrator. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 19

20 INSTALLING ENSIM PRO CHAPTER 2 Show the readme file: Select this check box to open the readme file. This file contains information about the Ensim Pro installation. The Ensim Pro installation is complete. Installing the online Help This section includes instructions for installing the online Help for Ensim Pro To install the online Help: 1 Connect to the Ensim Pro server using the console or terminal services and log in as the administrator. 2 Locate and run the HelpInstaller.msi file: If you have the Ensim Pro CD, insert the CD in the server s CD-ROM drive, browse to the Help directory on the CD and run HelpInstaller.msi. If the HelpInstaller.msi file is present on your hard disk or on your local network, browse to that directory and run HelpInstaller.msi. The Welcome window opens. 3 Click Next. 4 In the Confirm Installation window, click Next. 5 In the Installation Complete window, click Close to complete the installation. The Ensim Pro online Help is installed. You can access the online Help from the Ensim Pro control panel by clicking General Help in the Help section on the left navigation bar. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 20

21 INSTALLING ENSIM PRO CHAPTER 2 Verifying successful installation After you complete the installation, verify whether the installation is successful using the following procedure. To verify that the installation is successful: 1 Log in to the Ensim Pro control panel. For instructions, see section on logging in. 2 On the left navigation bar, in the Help section, click About. 3 Verify that the control panel version is displayed as <build_no>. 4 Add a site and provision all the service components to it using instructions from the Ensim Pro online Help. If the site is created successfully, then the installation has been successful. Troubleshooting Throughout this chapter, tips and recommendations are provided to ensure the installation goes smoothly. If you need additional help troubleshooting an issue, see the self-help assets on the Ensim support site, Post-installation tasks After you have installed Ensim Pro, you should perform the following tasks: Ensure that the Startup type of the EnsimProvisionEngine service is set to Manual: a Log in to the Ensim Pro server as the administrator. b Click Start > Programs > Administrative Tools, then click Services. c In the Services window, right-click EnsimProvisionEngine, then click Properties. d In the EnsimProvisionEngine Properties window, ensure that the Startup type is set to Manual. If not, then select Manual and click OK. Next steps After installing Ensim Pro , you can log in to the Ensim Pro control panel, and add resellers and sites. You can provide more features to your resellers and sites by installing the add-ons (optional) for ColdFusion, Urchin, IMail Server, and MySQL. For instructions, see add-on installation section ("Installing add-ons for ColdFusion, Urchin, IMail, and MySQL" on page 37). ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 21

22 C HAPTER 3 Logging in as the server administrator Introduction This section includes information for logging in to the Ensim Pro control panel as the server administrator. In this section: Logging in as the server administrator...22 Logging in as the server administrator Once you install Ensim Pro , you can use your Web browser to access Ensim Pro , then log in as the server administrator and manage tasks at the server level. To log in as the server administrator: 1 Open an Internet Explorer (version 6.0 or later) window. Using other versions of Internet Explorer or other browsers to access the service provider control panel is not recommended. 2 In the Address field of your Web browser, type the URL: where <server_name> is the host name or IP address of the Ensim Pro server. If you are logging in to the Ensim Pro control panel for the first time, the EULA (End User License Agreement) page is displayed. If you have logged in before, skip the next step. 3 On the EULA page, click I Agree if you agree to the terms of the license agreement. The Log in page opens. 4 In the username text box, type admin. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 22

23 LOGGING IN AS THE SERVER ADMINISTRATOR CHAPTER 3 5 In the password text box, enter the password that you entered during the installation process. For more information, see the installation instructions (page 12). 6 Click Log In. If the Ensim Pro license registration failed, the browser displays a message stating the reason for the registration failure. The license registration fails for the following reasons: Invalid license key: To resolve this issue, specify the correct license key in the browser window, and click Submit. Communication problems with the Ensim License Manager: To resolve this issue, you can either click Continue in the browser window to use the product for an evaluation period, or click Register to specify the license key and register the license again. Important: If you click Continue to use the product for an evaluation period, you must register the license before the end of the evaluation period; otherwise Ensim Pro stops functioning when the evaluation period expires. To register the license, you can click Register, and specify the license key when you log in again to the Ensim Pro control panel. If you are already logged into the control panel, you can use the Update License page to specify the license key and register the license. After the license registration is successful, the Server Administrator home page opens. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 23

24 LOGGING IN AS THE SERVER ADMINISTRATOR CHAPTER 3 The Server Administrator home page includes shortcuts to some important tasks you will perform at the server level such as creating and managing resellers and sites. Use the home page to view and perform these tasks. You can also access these tasks from the top and left navigation bars. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 24

25 A PPENDIX A Installing Microsoft SQL Server 2005 Express Edition Introduction This appendix provides instructions for installing and configuring Microsoft SQL Server 2005 Express Edition (SQL Server Express) for the Ensim Pro server. Topics in this appendix include: Installation instructions...25 Verifying successful installation...35 Post-installation tasks...36 Installation instructions This section provides instructions for installing SQL Server Express on the Ensim Pro server. To install SQL Server Express: 1 Go to the link and download the file SQLEXPR.exe. To do this, either double-click the file SQLEXPR.exe or right click it and then click Run to start the installation on the Ensim Pro server. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 25

26 INSTALLING MICROSOFT SQL SERVER 2005 EXPRESS EDITION APPENDIX A 2 The Registration Information window opens. In this window, you must de-select the Hide advanced configuration options check box. Then click Next. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 26

27 INSTALLING MICROSOFT SQL SERVER 2005 EXPRESS EDITION APPENDIX A 3 The Feature Selection window opens. In this window, under the Database Services folder, select the option Entire Feature will be installed on local hard drive. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 27

28 INSTALLING MICROSOFT SQL SERVER 2005 EXPRESS EDITION APPENDIX A 4 In the Feature Selection window, under the Client Components folder, also select the option Will be installed on hard drive. Then click Next. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 28

29 INSTALLING MICROSOFT SQL SERVER 2005 EXPRESS EDITION APPENDIX A 5 The Instance Name window opens. Ensim Pro is configured to use the default database instance. So, select the option Default Instance and then click Next. 6 The Service Account window opens. The built-in System account is the maximum privilege account. Hence, in this window, select the option Use the built-in System account. Choose the value Local system from the drop down list. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 29

30 INSTALLING MICROSOFT SQL SERVER 2005 EXPRESS EDITION APPENDIX A In the Start services at the end of set-up section, select the check boxes SQL Server and SQL Browser. This will automatically start the services once the setup is complete. These services need to be running for the Ensim Pro installation to proceed successfully. Then click Next. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 30

31 INSTALLING MICROSOFT SQL SERVER 2005 EXPRESS EDITION APPENDIX A 7 The Authentication Mode window opens. In this window, select the option Mixed Mode (Windows Authentication and SQL Server Authentication). Enter the server authentication login password and then click Next. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 31

32 INSTALLING MICROSOFT SQL SERVER 2005 EXPRESS EDITION APPENDIX A 8 The Collation Settings window opens. In this window, ensure that the default setting is selected as shown. Then click Next. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 32

33 INSTALLING MICROSOFT SQL SERVER 2005 EXPRESS EDITION APPENDIX A 9 The User Instances window opens. Select the check box Enable User Instances to facilitate creation of a separate instance. Then click Next. 10 ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 33

34 INSTALLING MICROSOFT SQL SERVER 2005 EXPRESS EDITION APPENDIX A 11 The Error and Usage Report Settings window opens. Click Next. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 34

35 INSTALLING MICROSOFT SQL SERVER 2005 EXPRESS EDITION APPENDIX A 12 The Completing Microsoft SQL Server 2005 Setup window opens. Click Finish to complete the SQL Server Express setup. The SQL Server Express is now installed on the Ensim Pro server. Verifying successful installation After you complete the installation, verify whether the installation is successful by running the following command in the command prompt window of the Ensim Pro server: 1 net start This command displays a listing of all services started on the Ensim Pro server. If Microsoft SQL Server 2005 is already running on the server, it is displayed in the service list as one of the services running. 2 net start mssqlserver Run this command to start the Microsoft SQL Server 2005 service, if Microsoft SQL Server 2005 is not listed in the services list. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 35

36 INSTALLING MICROSOFT SQL SERVER 2005 EXPRESS EDITION APPENDIX A Post-installation tasks After you have installed SQL Server Express on Ensim Pro server, you should perform the following tasks: Ensure that SQL server is configured to allow access to the database across all network: a Click Start > Programs > Microsoft SQL Server 2005 > Configuration Tools > SQL Server Configuration Manager b Under SQL Server 2005 Network Configuration > Protocols for MSSQLSERVER: o Double-click the protocol name TCP/IP and set the property ENABLED to Yes o Double-click the protocol name Named Pipes and set the property ENABLED to Yes c To restart MS SQL 2005 service, run the following commands in the command prompt window of the Ensim Pro server: net stop mssqlserver net start mssqlserver ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 36

37 A PPENDIX B Installing add-ons for ColdFusion, Urchin, IMail, and MySQL Introduction This section includes instructions about installing add-ons for ColdFusion MX 6.1, Urchin 5.x, IMail Server 8.21, and MySQL 4.1 or 5.0. Important: You must install ColdFusion MX 6.1, Urchin 5.x, IMail Server 8.21 (from the Ipswitch Collaboration Suite), and MySQL 4.1 or 5.0 manually before you install the add-ons for them. Ensim does not include these applications with Ensim Pro ; it provides only the add-ons. After installing any add-on, restart the EnsimProvisionEngine service by clicking Start > Programs > Administrative Tools > Services, locating EnsimProvisionEngine, and clicking Restart. Installing the ColdFusion add-on This section provides instructions for installing the ColdFusion MX 6.1 add-on for Ensim Pro Important: Before installing the add-on for ColdFusion MX 6.1, ensure that you have installed ColdFusion MX 6.1 on your Ensim Pro server. For information about downloading and installing ColdFusion MX 6.1, go to If you have installed Microsoft Windows Server 2003 Service Pack 1 (SP1) on the Ensim Pro server, then the ColdFusion MX 6.1 installer fails. For instructions on resolving this issue, go to er/releasenotes_cfmx61_updater.html. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 37

38 INSTALLING ADD-ONS FOR COLDFUSION, URCHIN, IMAIL, AND MYSQL APPENDIX B Note: After installing ColdFusion MX 6.1, ensure that the Master Properties sheet in Internet Information Services (IIS) on your Ensim Pro server does not have ColdFusion script maps. To verify this, click Start > Run, type inetmgr, and click OK. The IIS Manager window is displayed. In the IIS Manager window, expand the local computer, right-click Web Sites, and then click Properties. In the Web Sites Properties window, click the Home Directory tab, and then click Configuration. In the Application extensions section, if.cfc,.cfm, or.cfml extensions are present, select them, and click Remove. This process prevents new sites created through the Ensim Pro interface from inheriting ColdFusion script maps automatically. Hence, you will be able to control provisioning of ColdFusion for new sites through the Ensim Pro interface. Failure to disable ColdFusion script maps for the IIS Master Properties sheet will result in all sites being automatically provisioned with ColdFusion. To install the ColdFusion MX 6.1 add-on: 1 Connect to the Ensim Pro server using the console or terminal services and log in as the administrator. 2 Locate and run the Coldfusion Addon.msi file: If you have the Ensim Pro CD, insert the CD in the server s CD-ROM drive, browse to the ColdfusionAddon directory on the CD and run Coldfusion Addon.msi. If the Coldfusion Addon.msi file is present on your hard disk or on your local network, browse to that directory and run Coldfusion Addon.msi. The Coldfusion Addon installation window opens. 3 Click Next. 4 Click Install. The progress bar in the window indicates that the add-on is being installed. 5 Click Finish to complete the installation. The ColdFusion MX 6.1 add-on is installed. An installation log named ColdfusionInstall.log is created and placed in the < install_dir >\Logs directory, for example, if you have installed Ensim Pro in the default location, then the path is C:\Program Files\Ensim\WEBppliance\Logs. You can view this log file to verify that the add-on has been installed and registered successfully. Installing the Urchin add-on This section provides instructions for installing the Urchin 5.x add-on for Ensim Pro Important: Before installing the add-on for Urchin 5.x, ensure that you have installed Urchin 5.x on your Ensim Pro server. For information about downloading and installing Urchin 5.x, go to To install the Urchin 5.x add-on: 1 Connect to the Ensim Pro server using the console or terminal services and log in as the administrator. 2 Locate and run the Urchin Addon.msi file: ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 38

39 INSTALLING ADD-ONS FOR COLDFUSION, URCHIN, IMAIL, AND MYSQL APPENDIX B If you have the Ensim Pro CD, insert the CD in the server s CD-ROM drive, browse to the Urchin5Addon directory on the CD and run Urchin Addon.msi. If the Urchin Addon.msi file is present on your hard disk or on your local network, browse to that directory and run Urchin Addon.msi. The Urchin Addon installation window opens. 3 Click Next. 4 Click Install. The progress bar in the window indicates that the add-on is being installed. 5 Click Finish to complete the installation. The Urchin 5.x add-on is installed. An installation log named UrchinInstall.log is created and placed in the < install_dir >\Logs directory, for example, if you have installed Ensim Pro in the default location, then the path is C:\Program Files\Ensim\WEBppliance\Logs. You can view this log file to verify that the add-on has been installed and registered successfully. Installing the IMail Server add-on This section provides instructions for installing the IMail Server 8.21 add-on for Ensim Pro Important: Before installing the add-on for IMail Server 8.21, ensure that you have installed IMail Server 8.21 from the Ipswitch Collaboration Suite on your Ensim Pro server. For information about downloading and installing the Ipswitch Collaboration Suite, go to In the Collaboration Suite installation window, ensure that you have selected Ipswitch IMail Server, then continue with the installation. Accept the default options except for the following: * SSL Keys window: Click No. * Service Start Options window: Select the IMail Web Service, IMail Queue Manager Service, IMail POP3 Server, IMail SMTP Server, and IMail IMAP4 Server check boxes. * User Creation window: Click No. To install the IMail Server 8.21 add-on: 1 Connect to the Ensim Pro server using the console or terminal services and log in as the administrator. 2 Open a command prompt window and change to the directory where RegisterMailAddon.exe is located. cd <install_dir >\cp\admin\bin\servicecomponents\mail where <install_dir > refers to the path where Ensim Pro is installed. For example, if Ensim Pro is installed in C:\Program Files\Ensim\WEBppliance, then this executable is located at C:\Program Files\Ensim\WEBppliance\cp\admin\bin\serviceComponents\mail. 3 Register the IMAIL add-on using RegisterMailAddon.exe. RegisterMailAddon.exe Ipswitch IMAIL 8.21 exe "" "" 4 Create a directory named mailapi in the directory where Ensim Pro is installed. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 39

40 INSTALLING ADD-ONS FOR COLDFUSION, URCHIN, IMAIL, AND MYSQL APPENDIX B mkdir <install_dir>\mailapi where < install_dir> refers to the path where Ensim Pro is installed. 5 Locate and run the IMAILPlugin.exe file that contains all the API calls: If you have the Ensim Pro CD, insert the CD in the server s CD-ROM drive, browse to the IMAILaddon directory on the CD and run IMAILPlugin.exe. If the IMAILPlugin.exe file is present on your hard disk or on your local network, browse to that directory and run IMAILPlugin.exe. The IMAILPlugin window opens. 6 In the directory name text box, type the location of the mailapi directory created in step 4, and click Extract. All the APIs are extracted to the mailapi directory. The IMail Server 8.21 add-on is installed. An installation log named register_mail.log is created and placed on the system drive, for example, C:\register_mail.log. You can view this log file to verify that the mail add-on has been installed and registered successfully. Known limitations of IMail Server 8.21 This section describes the known limitations of IMail Server While adding a site, if the site administrator's username is less than three characters long, IMail Server 8.21 cannot be implemented for that site. While adding a user to a site, if the username is less than three characters long, IMail Server 8.21 cannot be provisioned to that user. Installing the MySQL add-on This section provides instructions for installing the MySQL add-on for Ensim Pro Before installing the add-on, ensure that you have installed the following software on your Ensim Pro server: MySQL 4.1 or 5.0: For information about downloading and installing the latest version of MySQL, that is, version 5.0, go to While installing MySQL 5.0, ensure that you accept the default options in the installation wizard except for the following: MySQL Server Instance Configuration window: o Select the Server Machine option. o Select the Non-Transactional Database Only option. o Clear the Enable Strict Mode check box. o Select the Best Support For Multilingualism option. o Select the Include Bin Directory in Windows PATH check box. MyODBC 3.51: For information about downloading and installing MyODBC 3.51, go to Install MyODBC 3.51 using the default options. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 40

41 INSTALLING ADD-ONS FOR COLDFUSION, URCHIN, IMAIL, AND MYSQL APPENDIX B Note: Since the password encryption is different in MySQL 4.1 and 5.0 than its previous versions, you cannot access the database using phpmyadmin provided with Ensim Pro. To change this password encryption to support phpmyadmin 2.5.0: After installing MySQL 4.1 or 5.0 on the server, go to the directory where MySQL is installed. If you have installed MySQL in the default location, then the path is C:\Program Files\MySQL\MySQL Server < version_no >, where <version_no> is the version of MySQL. For example, C:\Program Files\MySQL\MySQL Server 4.1. Open the my.ini file present in this directory, type old-passwords in the [mysqld] section, save the file, and close it. Open a command window, and run the following commands: net stop mysql net start mysql PhpMyAdmin can now be used to access MySQL 4.1 or 5.0. You can now proceed to installing the MySQL add-on as described below. To install the MySQL add-on: 1 Connect to the Ensim Pro server using the console or terminal services and log in as the administrator. 2 Locate and run the Mysql Addon.msi file. If you have the Ensim Pro CD, insert the CD in the server s CD-ROM drive, browse to the mysqladdon directory on the CD and run Mysql Addon.msi. If the Mysql Addon.msi file is present on your hard disk or on your local network, browse to that directory and run Mysql Addon.msi. The Mysql Addon installation window opens. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 41

42 INSTALLING ADD-ONS FOR COLDFUSION, URCHIN, IMAIL, AND MYSQL APPENDIX B 3 Click Next. The Customer Information window opens. 4 While installing MySQL 4.1 or 5.0, if you have set the root password, ensure that you specify the same password in this window. If you have not set any root password for MySQL, then do not enter anything in the Password text box. 5 Click Next. 6 Click Install. The progress bar in the window indicates that the add-on is being installed. 7 Click Finish to complete the installation. The MySQL add-on is installed. An installation log named MysqlInstall.log is created and placed in the < install_dir >\Logs directory, for example, if you have installed Ensim Pro in the default location, then the path is C:\Program Files\Ensim\WEBppliance\Logs. You can view this log file to verify that the add-on has been installed and registered successfully. Verifying the success of the add-on installation After you complete the installation of the add-ons, verify that the installation for the add-ons is successful using the following procedure. To verify successful installation : 1 Log in to the Ensim Pro control panel. 2 On the left navigation bar, in the Server section, click List Services. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 42

43 INSTALLING ADD-ONS FOR COLDFUSION, URCHIN, IMAIL, AND MYSQL APPENDIX B 3 On the List Services page, verify that all the add-ons that you have installed are displayed. 4 Add a site and provision the add-ons to it. If the site is created successfully, then the add-on installation has been successful. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 43

44 A PPENDIX C Silent installation of Ensim Pro Introduction This section includes instructions for installing Ensim Pro in the silent installation mode. Silent installation overview Silent installation, a text-based mode, is executed using the Windows command line. In this mode, you must specify all the information required by the installer before starting the installation process. Silent installation does not require you to oversee the entire installation process. This method is recommended for users installing Ensim Pro on multiple Ensim Pro servers. Time required for complete installation: Minimum 30 minutes, depending on system configuration. Installation instructions This section provides instructions for installing Ensim Pro using the text-based mode. Installing Ensim Pro and online Help This section includes the instructions for installing Ensim Pro and online Help using the command line. To install Ensim Pro and online Help using the command line: 1 Connect to the Ensim Pro server using the console or terminal services and log in as the administrator. 2 Before installing Ensim Pro , ensure that you have installed Microsoft SQL Server 2005 on your Ensim Pro server. If not: 3 Download the SQL Server Express installation file, SQLEXPR.exe. from DCC397514B41&displaylang=en. Extract the contents of SQLEXPR.exe to a temporary directory on your server. Open a command prompt window and change to the directory where the contents of SQLEXPR.exe are extracted. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 44

45 SILENT INSTALLATION OF ENSIM PRO APPENDIX C Install SQL Server Express by typing the following command in the command prompt window. SQLEXPR.EXE /qn ADDLOCAL=All INSTANCENAME=MSSQLSERVER SQLBROWSERACCOUNT="NT AUTHORITY\SYSTEM" 4 After installing SQL Server Express, perform the following tasks: Ensure that the MSSQLSERVER service is running by going to Start > Programs > Administrative Tools, clicking Services, and verifying that the Status of the MSSQLSERVER service is Started. If not, click Start to start the service. Optional: If you want to enable access to SQL Server Express using a remote client such as Query Analyzer or Enterprise Manager, you may need to enable the network protocols. For more information, go to section 4.1 Service Account and Network Protocols of 5 If you have the installation files on the Ensim Pro CD-ROM or have downloaded them, locate and copy the following files to a temporary directory. Ensim Pro for Windows.msi HelpInstaller.msi 6 Open a command window and change to the directory where all the installation files mentioned above are located. 7 Install the Ensim Pro control panel using the following command. msiexec /l*v <full_path_of_log_file> /i "Ensim Pro for Windows.msi" /qn USERNAME="<username>" COMPANYNAME="<company_name>" CUSTOMER ="< _id>" INSTALLDIR="< install_dir>" LICENSEKEY="<license_key>" SITEDATADIR="<site_data_path>" ISPPWD="<password>" IP="<server_ip_address>" NETMASK="<server_netmask >" FQDN="<FQDN_of_the_server >" wwp="1" where: <full_path_of_log_file> is the location where you want to save the log file for the installation <username> is your name <company_name> is the name of your company < _id> is your address <install_dir> is the directory where you want to install Ensim Pro <license_key> is the license key for using Ensim Pro <site_data_path> is the directory where you want to store the site data <password> is your password for logging in to the Ensim Pro control panel as server administrator <server_ip_address> is the IP address of your Ensim Pro server <server_netmask> is the netmask of your Ensim Pro server <FQDN_of_the_server> is the Fully Qualified Domain Name (FQDN) of your Ensim Pro server Ensure that the parameters you specify in the above command are in the same format as specified in the example below, since the command does not validate the format or null value of the parameters. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 45

46 SILENT INSTALLATION OF ENSIM PRO APPENDIX C msiexec /l*v C:/ensimpro.log /i "Ensim Pro for Windows.msi" /qn USERNAME="xyz" COMPANYNAME="example.net" CUSTOMER ="xyz@example.net" INSTALLDIR="C:\Program Files\Ensim\WEBppliance" LICENSEKEY="A1B2C3D4E5F6G7H8I9J0K1L2M" SITEDATADIR="C:\Sitedata" ISPPWD="ensimpro" IP=" " NETMASK=" " FQDN="ensimpro.example.net" wwp="1" If your server does not meet the pre-requisites for installing Ensim Pro , the error message will be logged only in the WWP_prerequisite_error.log file. This log file is created only in case of pre-requisite errors, and is located in the <system_drive> of your server, where the operating system files are present. For more information on meeting the pre-requisites for installing Ensim Pro , see installation preparation ("Preparing for the installation" on page 8). 8 Install the online Help using the following command. msiexec /l*v <full_path_of_log_file> /i "HelpInstaller.msi" /qn where <full_path_of_log_file> is the location where you want to save the log file for the installation. For example, C:\helpinstaller.log. After the installation is complete, check the log file to verify that the online Help has installed successfully. The Ensim Pro and online Help installation is complete. If you want to install the add-ons, proceed to the next section; otherwise, in order to ensure that Ensim Pro has been installed successfully see the verification section ("Verifying the success of the installation" on page 48). Installing the add-ons (optional) This section includes the instructions for installing optional add-ons using the command line. To install the add-ons using the command line: 1 Connect to the Ensim Pro server using the console or terminal services and log in as the administrator. 2 If you have the installation files on the Ensim Pro CD-ROM or have downloaded them, locate and copy the following files in a temporary directory. Coldfusion Addon.msi Urchin Addon.msi Mysql Addon.msi IMAILPlugin.exe 3 Open a command prompt window and change to the directory where all the installation files mentioned above are located. 4 Before installing the add-on for ColdFusion MX 6.1, perform the following tasks: Ensure that you have installed ColdFusion MX 6.1 on your Ensim Pro server. For information about downloading and installing ColdFusion MX 6.1, go to Important: If you have installed Microsoft Windows Server 2003 Service Pack 1 (SP1) on the Ensim Pro server, then the ColdFusion MX 6.1 installer fails. For instructions on resolving this issue, go to er/releasenotes_cfmx61_updater.html. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 46

47 SILENT INSTALLATION OF ENSIM PRO APPENDIX C After installing ColdFusion MX 6.1, ensure that the Master Properties sheet in Internet Information Services (IIS) on your Ensim Pro server does not have ColdFusion script maps. For more information on ColdFusion script maps, see the note Installing the ColdFusion add-on (page 37). 5 Install the ColdFusion MX 6.1 add-on using the following command. msiexec /l*v <full_path_of_log_file> /i "Coldfusion Addon.msi" /qn where <full_path_of_log_file> is the location where you want to save the log file for the installation. For example, C:\coldfusioninstaller.log. After the installation is complete, check the log file to verify that the add-on installed successfully. 6 Before installing the add-on for Urchin 5.x, ensure that you have installed Urchin 5.x on your Ensim Pro server. For information about downloading and installing Urchin 5.x, go to 7 Install the Urchin 5.x add-on using the following command. msiexec /l*v <full_path_of_log_file> /i "Urchin Addon.msi" /qn where <full_path_of_log_file> is the location where you want to save the log file for the installation. For example, C:\urchininstaller.log. After the installation is complete, check the log file to verify that the add-on installed successfully. 8 Before installing the add-on for MySQL, ensure that you have installed the following software on your Ensim Pro server: MySQL 4.1 or 5.0: For information about downloading and installing the latest version of MySQL, that is, version 5.0, go to While installing MySQL 5.0, ensure that you accept the default options in the installation wizard except for the following: MySQL Server Instance Configuration window: o o o o Select the Server Machine option. Select the Non-Transactional Database Only option. Clear the Enable Strict Mode check box. Select the Best Support For Multilingualism option. o Select the Include Bin Directory in Windows PATH check box. MyODBC 3.51: For information about downloading and installing MyODBC 3.51, go to Install MyODBC 3.51 using the default options. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 47

48 SILENT INSTALLATION OF ENSIM PRO APPENDIX C Note: Since the password encryption is different in MySQL 4.1 and 5.0 than its previous versions, you cannot access the database using phpmyadmin provided with Ensim Pro. To change this password encryption to support phpmyadmin 2.5.0: After installing MySQL 4.1 or 5.0 on the server, go to the directory where MySQL is installed. If you have installed MySQL in the default location, then the path is C:\Program Files\MySQL\MySQL Server <version_no>, where <version_no> is the version of MySQL. For example, C:\Program Files\MySQL\MySQL Server 4.1. Open the my.ini file present in this directory, type old-passwords in the [mysqld] section, save the file, and close it. Open a command window, and run the following commands: net stop mysql net start mysql PhpMyAdmin can now be used to access MySQL 4.1 or 5.0. You can now proceed to installing the MySQL add-on as described below. 9 Install the MySQL add-on using the following command. msiexec /l*v <full_path_of_log_file> /i "Mysql Addon.msi" /qn ROOTPASSWORD="<MySQL_root_password>" where: <full_path_of_log_file> is the location where you want to save the log file for the installation. For example, C:\mysqlinstaller.log. <MySQL_root_password > is the root password set during MySQL 4.1 or 5.0 installation. If you have not set any root password for MySQL, then the value of <MySQL_root_password> should be null, that is, ROOTPASSWORD="" After the installation is complete, check the log file specified above to verify that the add-on installed successfully. 10 To install the IMail Server 8.21 add-on, see the installation instructions ("Installing the IMail Server add-on" on page 39). The add-on installation is complete. Verifying the success of the installation After you complete the installation, verify that the installation is successful using the following procedure. To verify successful installation: 1 Log in to the Ensim Pro control panel. For more information, see the login instructions. 2 On the left navigation bar, in the Help section, click About. 3 Verify that the control panel version is displayed as <build_no>. 4 If you have installed the optional add-ons, then verify that the add-ons are installed successfully: a b On the left navigation bar, in the Server section, click List Services. On the List Services page, verify that all the add-ons that you have installed are displayed. ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 48

49 SILENT INSTALLATION OF ENSIM PRO APPENDIX C 5 Add a site with the installed add-ons provisioned to it. If the site is created successfully, then the installation is successful. Troubleshooting Throughout this chapter, tips and recommendations are provided to ensure the installation goes smoothly. If you need additional help troubleshooting an issue, see the self-help assets on the Ensim support site, ENSIM PRO FOR WINDOWS 2003 INSTALLATION GUIDE 49