> ## Appendix A
> Installing add-ons for ColdFusion, Urchin, IMail, MySQL, and Ensim Ignite services

> ## Introduction

> This appendix includes instructions about installing add-ons for ColdFusion MX 6.1,
> Urchin 5.x, IMail Server 8.13, MySQL 4.0.12, and Ensim Ignite services.

> You must install ColdFusion MX 6.1, Urchin 5.x, IMail Server 8.13 (from the Ipswitch Collaboration Suite), and MySQL 4.0.12 manually before you install the add-ons for them. Ensim does not include these applications with Ensim Pro; it provides only the add-ons.

> Topics include:

> - Installing the ColdFusion MX 6.1 add-on
> - Installing the Urchin 5.x add-on
> - Installing the IMail Server 8.13 add-on
> - Installing the MySQL 4.0.12 add-on
> - Installing the Ensim Ignite services add-on

> After installing any add-on, restart the EnsimProvisionEngine service by clicking Start > Programs > Administrative Tools > Services, locating EnsimProvisionEngine, and clicking Restart.

> ## Installing the ColdFusion MX 6.1 add-on

> This section provides instructions for installing the ColdFusion MX 6.1 add-on for Ensim Pro.

> 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, visit http://www.macromedia.com/software/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 on as the administrator.
> 2. Locate and run the Coldfusion Addon.msi file.
> - If you have the Ensim Pro CD, insert it in your CD-ROM drive, click
>   Start > Run, enter the path of Coldfusion Addon.msi file on the CD, and click OK. For example, D:\Coldfusion Addon.msi, where D: is the CD-ROM drive.
> - If the Coldfusion Addon.msi file is present on your hard disk or on your local network, click Start > Run, enter the path of the Coldfusion Addon.msi file, and click OK. For example, C:\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.

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

> ## Installing the Urchin 5.x add-on

> This section provides instructions for installing the Urchin 5.x add-on for Ensim Pro.

> 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, visit
> http://www.urchin.com/download/urchin5/.

> To install the Urchin 5.x add-on:

> 1. Connect to the Ensim Pro server using the console or terminal services and log on as the administrator.
> 2. Locate and run the Urchin Addon.msi file.
> - If you have the Ensim Pro CD, insert it in your CD-ROM drive, click
>   Start > Run, enter the path of Urchin Addon.msi file on the CD, and click OK. For example, D:\Urchin Addon.msi, where D: is the CD-ROM drive.
> - If the Urchin Addon.msi file is present on your hard disk or on your local network, click Start > Run, enter the path of the Urchin Addon.msi file, and click OK. For example, C:\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.

> ## Installing the IMail Server 8.13 add-on

> This section provides instructions for installing the IMail Server 8.13 add-on for Ensim Pro.

> Before installing the add-on for IMail Server 8.13, ensure that you have installed IMail Server 8.13 from the Ipswitch Collaboration Suite on your Ensim Pro server. For information about downloading and installing the Ipswitch Collaboration Suite, visit http://www.ipswitch.com/Products/collaboration/index.html.
> 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.13 add-on:

> 1. Connect to the Ensim Pro server using the console or terminal services and log on 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 resides 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.13 exe "" ""

> 4. Create a directory named mailapi in the directory where Ensim Pro is installed.

> mkdir <install_dir>\mailapi

> where <install_dir> refers to the path where Ensim Pro is installed.

> 5. Locate IMAILPlugin.exe that contains all the API calls, either on the Ensim Pro CD, your hard disk, or on your local network.
> 6. Run IMAILPlugin.exe. The IMAILPlugin window opens.
> 7. 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.13 add-on is installed.

> ### Known limitations of IMail Server 8.13

> This section describes the known limitations of IMail Server 8.13.

> - While adding a site, if the site administrator's username is less than three characters long, IMail Server 8.13 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.13 cannot be provisioned to that user.

> ## Installing the MySQL 4.0.12 add-on

> This section provides instructions for installing the MySQL 4.0.12 add-on for Ensim Pro.

> Before installing the add-on for MySQL 4.0.12, ensure that you have installed MySQL 4.0.12 and MyODBC 3.51.06 on your Ensim Pro server. For information about downloading and installing MySQL 4.0.12, visit
> http://downloads.mysql.com/archives.php?p=mysql-4.0&v=4.0.12. For information about downloading and installing MyODBC 3.51.06, visit
> ftp://mirror.services.wisc.edu/mirrors/mysql/Downloads/MyODBC3/. Install MyODBC 3.51.06 using the default options.
> Before installing the MySQL 4.0.12 add-on for Ensim Pro, ensure that you have not set the root password for MySQL, otherwise you cannot provision a site with MySQL. If you have freshly installed MySQL with default settings, its root password is empty.

> To install the MySQL 4.0.12 add-on:

> 1. Connect to the Ensim Pro server using the console or terminal services and log on as the administrator.
> 2. Locate and run the Mysql Addon.msi file.
> - If you have the Ensim Pro CD, insert it in your CD-ROM drive, click
>   Start > Run, enter the path of Mysql Addon.msi file on the CD, and click OK. For example, D:\Mysql Addon.msi, where D: is the CD-ROM drive.
> - If the Mysql Addon.msi file is present on your hard disk or on your local network, click Start > Run, enter the path of the Mysql Addon.msi file, and click OK. For example, C:\Mysql Addon.msi.

> The Mysql 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 MySQL 4.0.12 add-on is installed.

> After installing the MySQL 4.0.12 add-on for Ensim Pro, ensure that you set the root password for MySQL to secure your database. For instructions, visit
> http://dev.mysql.com/doc/mysql/en/Default_privileges.html.

> ## Installing the Ensim Ignite services add-on

> This section includes instructions about installing the Ensim Ignite services add-on for Ensim Pro.

> Ensim Ignite is a suite of online services that provide cutting-edge business solutions to extend your business reach and enhance your business efficiencies with minimal investment and turn-around time. For more information, refer to the Ensim Pro 4.0.1 for Windows 2003 Release Notes at http://www.ensim.com/support/pro/win2003/index.html.

> To install the Ensim Ignite services add-on:

> 1. Connect to the Ensim Pro server using the console or terminal services and log on as the administrator.
> 2. Locate and run the Ensim Ignite Service Add-on.msi file.
> - If you have the Ensim Pro CD, insert it in your CD-ROM drive, click
>   Start > Run, enter the path of Ensim Ignite Service Add-on.msi file on the CD, and click OK. For example, D:\Ensim Ignite Service Add-on.msi, where D: is the CD-ROM drive.
> - If the Ensim Ignite Service Add-on.msi file is present on your hard disk or on your local network, click Start > Run, enter the path of the Ensim Ignite Service
>   Add-on.msi file, and click OK. For example, C:\Ensim Ignite Service Add-on.msi.

> The Ensim Ignite Service Add-on 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 Ensim Ignite services add-on is installed.

Ensim Corporation www.ensim.com Contact Ensim www.ensim.com/about/contact.html