ServerXchange 2.5 Release Notes

ServerXchange 2.5 Release Notes Published November 05, 2001

Important Notice Customer acknowledges and agrees that the occurrence of any of the following without the express, prior consent of an authorized Ensim representative will automatically void the warranty and discharge Ensim from any further obligation to provide the customer with warranty services or support hereunder: (a) changing the password to Ensim ServerXchange or Ensim ControlCenter from the password originally provided by Ensim, (b) starting Ensim ServerXchange or Ensim ControlCenter in single user mode, or (c) gaining root user access to Ensim ServerXchange or Ensim ControlCenter. The following portions of Ensim ServerXchange software code are subject to, and may be distributed under, the terms and conditions of the GNU General Public License: Modified version of insmod Generic patches to Linux kernel for supporting memory limits Loopback device driver Red Hat Linux 6.0 and 6.1 To obtain the source code for these portions of Ensim ServerXchange code, send a stamped, selfaddressed envelope large enough to accommodate a CD-ROM and sufficient postage. Send to: Ensim Corporation Attn: Legal Department 1366 Borregas Avenue Sunnyvale, California 94089 This document contains proprietary information of Ensim and its receipt or possession does not convey any rights to reproduce, disclose its contents, manufacture, use, or sell anything it may 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. This product includes software developed by Digital Creations for use in the Z Object Publishing Environment (www.zope.org). Ensim is a registered trademark of Ensim Corporation. Ensim ServerXchange and Ensim WEBppliance are trademarks of Ensim Corporation. Netscape is a registered trademark of Netscape Communications Corporation. Windows is a registered trademark of Microsoft Corporation. Java, Solaris, SPARC are registered trademarks of Sun Microsystems. Linux is a registered trademark of Linus Torvalds. All other trademarks and copyrights are the property of their respective owners. Copyright 1999 2001 Ensim Corporation. All rights reserved. Published November 2001. TP125-01-01. Ensim ServerXchange 2.5 Release Notes

Contents Product compatibility 1 Ensim ServerXchange 2.5 1 Ensim WEBppliance 2.5 (Windows) 1 Ensim WEBppliance 2.3 (Linux) 1 System requirements 2 For the Windows environment 2 For the Linux environment 3 For the Solaris environment 4 Web browser requirements 5 For Ensim WEBppliance 2.5 (Windows) 5 For Ensim WEBppliance 2.3 (Linux) 5 New features 6 Ensim ServerXchange 2.5 6 Ensim WEBppliance 2.5 (Windows) 8 Ensim WEBppliance 2.3 (Linux) 10 Resolved product issues 12 Ensim ServerXchange 2.5 12 Ensim WEBppliance 2.3 (Linux) 13 Known issues 15 Ensim ServerXchange 2.5 15 Ensim WEBppliance 2.5 (Windows) 19 Ensim WEBppliance 2.3 (Linux) 21 Ensim ServerXchange 2.5 Release Notes iii

Application-specific issues 25 Ensim WEBppliance 2.5 (Windows) 25 Ensim WEBppliance 2.3 (Linux) 26 Ensim ServerXchange 2.5 Release Notes iv

Product compatibility This document covers product compatibility, system requirements, new features, resolved product issues, known issues, and application-specific issues of the following: Ensim ServerXchange 2.5 Ensim ServerXchange 2.5 is the hosting operations environment. Ensim WEBppliance 2.5 Ensim WEBppliance 2.5 is the new Microsoft Windows based Web hosting environment offered on Ensim ServerXchange. Ensim WEBppliance 2.3 Ensim WEBppliance 2.3 is the Red Hat Linux based Web hosting environment offered on Ensim ServerXchange. Product compatibility This section describes the product compatibility for Ensim ServerXchange 2.5, Ensim WEBppliance 2.5, and Ensim WEBppliance 2.3. Ensim ServerXchange 2.5 Ensim ServerXchange 2.5 supports Microsoft Windows 2000, Red Hat Linux 6.1, and Solaris 7 Release 11/99 operating environments. Ensim WEBppliance 2.5 (Windows) Ensim WEBppliance 2.5 is compatible with Microsoft Windows 2000 Physical Servers. Ensim WEBppliance 2.3 (Linux) Ensim WEBppliance 2.3 is compatible with Red Hat Linux 6.1 Private Servers. Ensim ServerXchange 2.5 Release Notes 1

System requirements System requirements This section describes the minimum system requirements for ServerXchange to manage the Windows, Linux, and Solaris environments. For the Windows environment The Windows environment includes a Physical Server to run Ensim WEBppliance Suite 2.5. Physical Server requirements To run Ensim WEBppliance Suite 2.5 on your Windows Physical Server, you need the following: Operating System Microsoft Windows 2000 Server, Windows 2000 Server Resource Kit, Windows 2000 Server Service Pack 1 Processor Intel Pentium III 500 MHz or higher Memory 128 MB of RAM; 512 MB of RAM is recommended Disk Space 4 GB Ensim ServerXchange 2.5 Release Notes 2

For the Linux environment System requirements The Linux environment includes a Physical Server and a Private Server installed on that Physical Server to run Ensim WEBppliance Suite 2.3. Physical Server requirements To have ServerXchange manage your Linux Physical Server, you need the following: Operating System Red Hat Linux 6.1 Processor Class 500 MHz Memory 256 MB of RAM Private Server requirements To run Ensim WEBppliance Suite 2.3 on your Private Server you need the following: Operating System Red Hat Linux 6.1 Private Server based on Ensim ServerXchange 2.2 Processor Intel x86 Memory 128 MB of RAM Disk Space 500 MB (based on a Private Server with Ensim WEBppliance 2.3 installed) Important: Ensim WEBppliance 2.3 must have at least 20 MB of free disk space available. If you do not provide this free disk space, and you overallocate quotas to virtual sites, Ensim WEBppliance will not be able to write to configuration files, and the system may go down. Ensim ServerXchange 2.5 Release Notes 3

System requirements For the Solaris environment The Solaris environment includes a Physical Server. Physical Server requirements To have ServerXchange manage your Solaris Physical Server, you need the following: Operating System Solaris 5.7 Generic_106541-08 (11/99) Processor Ultra SPARC (64-bit) Memory 128 MB of RAM Disk Space 4 GB Ensim ServerXchange 2.5 Release Notes 4

Web browser requirements Web browser requirements This section describes Web browser requirements to access Ensim WEBppliance 2.5 and Ensim WEBppliance 2.3. For Ensim WEBppliance 2.5 (Windows) To access your Physical Server running Ensim WEBppliance 2.5, you need one of the following: Microsoft Internet Explorer, version 5.0 and later or Netscape, version 4.7 and later Other versions and browsers have either not been tested, or are incompatible with Ensim WEBppliance. For Ensim WEBppliance 2.3 (Linux) To access your Private Server running Ensim WEBppliance 2.3, you need one of the following: Microsoft Internet Explorer, version 5.0 and later or Netscape, version 4.7 and later Other versions and browsers have either not been tested, or are incompatible with Ensim WEBppliance. Ensim ServerXchange 2.5 Release Notes 5

New features New features This section describes the new features for Ensim ServerXchange 2.5, Ensim WEBppliance 2.5, and Ensim WEBppliance 2.3. Ensim ServerXchange 2.5 This section covers the new features in Ensim ServerXchange 2.5. See the Ensim ServerXchange 2.5 User s Guide for more information. Ensim ServerXchange 2.5 is the new hosting operations environment that supports Windows, Linux, and Solaris operating environments. New support for the Windows operating environment Ensim ServerXchange 2.5 now supports the Microsoft Windows 2000 operating environment in addition to Red Hat Linux 6.1, and Solaris7 Release 11/99 operating environments. New OpCenter OpCenter 2.5.0 incorporates the user interface changes required to bring the new Windows environment into the existing Linux and Solaris-based ServerXchange hosting operations environment. OpCenter 2.5.0 is backwards compatible with prior versions of Ensim ServerXchange, so you can use it to manage other versions of Ensim ServerXchange that you may have. Ensim ServerXchange 2.5 Release Notes 6

New features New Ensim WEBppliance for Windows See Ensim WEBppliance 2.5 (Windows) on page 8 for information. New Ensim WEBppliance for Linux See Ensim WEBppliance 2.3 (Linux) on page 10 for information. Windows-specific applications upload The Windows-specific applications upload feature allows you to upload Windows-specific applications such as Microsoft Access 2000 (SR-1) and Allaire ColdFusion Server 4.5 Professional to the ControlCenter before deploying them through the Ensim ServerXchange OpCenter user interface. Network installation of the operating system The Network installation of the operating system feature allows you to install the required operating system on your Physical Server from ServerXchange before registering it on the network. Ensim ServerXchange 2.5 Release Notes 7

Ensim WEBppliance 2.5 (Windows) This section covers the new features in Ensim WEBppliance 2.5. See the Ensim WEBppliance 2.5 User s Guide for more information. Ensim WEBppliance 2.5 is the new Microsoft Windows-based Web hosting environment offered on Ensim ServerXchange. New features Ensim WEBppliance Suite 2.5 is a versatile suite (or a set of applications) that, when installed, transforms an Ensim ServerXchange-managed Physical Server into a powerful, virtual Web hosting appliance. Ensim WEBppliance Suite 2.5 comes bundled with the following applications. Analog Web Log Analyzer BIND/DNS Name Server Ensim Mail Server Ensim Virtual Web Hosting Tools Perl POP3 + IMAP Server Python Vacation Auto-Responder Supported applications Ensim WEBppliance Suite 2.5 supports the following applications. Allaire ColdFusion Microsoft Access Microsoft IIS FTP server Microsoft IIS Web server Microsoft IIS Secure Web server Microsoft Open DataBase Connectivity (ODBC) Ensim ServerXchange 2.5 Release Notes 8

New features Administrative management The administrative management feature allows administrators to manage tasks at three levels, namely the appliance level, the site level, and the user level. It also offers control panels at the appliance and site level to manage installed services. See Service management for more information. Service management The Service management feature allows Appliance and Site Administrators to manage installed applications. Appliance Administrators can manage the following services. Allaire ColdFusion DNS/BIND Microsoft IIS Web server Microsoft IIS Secure Web server Microsoft ODBC Site Administrators can manage the following services. Ensim Mail Server Microsoft Internet Information Server (IIS) FTP server Microsoft IIS Web server Microsoft IIS Secure Web server Microsoft ODBC Ensim ServerXchange 2.5 Release Notes 9

Ensim WEBppliance 2.3 (Linux) This section covers the new features in Ensim WEBppliance 2.3. See the Ensim WEBppliance 2.3 User s Guide for more information. New features Ensim WEBppliance 2.3 is the Red Hat Linux-based Web hosting environment offered on Ensim ServerXchange. Ensim WEBppliance Suite 2.3 is a versatile suite (or a set of applications) that, when installed, transforms an Ensim ServerXchange-managed Physical Server into a powerful, virtual Web hosting appliance. E-commerce component The e-commerce component feature allows you to integrate Miva Merchant into the existing Ensim WEBppliance Web hosting solution. Auto log on The auto log on feature allows you to access the Appliance Administrator user interface, click on a listed site, and directly log on as Site Administrator for that site. Navigation Bar customization The WEBppliance Navigation Bar customization feature allows you to add custom Navigation Bar menu items at the three entry points Appliance Administration, Site Administration, and User Administration. Apache configuration file management The Apache configuration file management feature allows Appliance Administrators to manage name-based site entries in the Apache configuration file. The configuration file is now more tolerant of DNS errors, and site CGI scripts can be viewed before creating and transferring the DNS entry for the new site. Ensim ServerXchange 2.5 Release Notes 10

New features Service updates OpenSSL New service version 0.9.6, which replaces Ensim Secure Web Server. Apache Web Server Includes fixes for Microsoft FrontPage subwebs, an increase in the number of servers in the file conf, and an upgrade to version 1.3.14. Analog Web Log Analyzer Includes changes for combined log generation, and an upgrade to version 4.03. DNS/BIND Name Server Includes security fixes in an upgrade to version 8.2.3. Ensim Virtual Web Hosting Tools Includes an upgrade to version 2.3.0. Majordomo Mailing List Server version 1.94.5. Microsoft FrontPage Server Extensions Includes changes for creating subwebs, and an upgrade to version 4.0. mod_perl for Apache Includes an upgrade to version 1.24. mod_php for Apache Includes MySQL connectivity, and an upgrade to version 4.0.3pl1. POP3 + IMAP Server - Includes security fixes in an upgrade to version 2000.2.6. ProFTPD - Includes changes to security fixes, and an upgrade to version 12.0rc2. Python version 1.5.2. Sendmail SMTP Server Includes changes to security fixes, and an upgrade to version 8.11.1. Vacation Auto-Responder Includes an upgrade to version 1.1.1. Ensim ServerXchange 2.5 Release Notes 11

Resolved product issues Resolved product issues This section describes the resolved product issues of Ensim ServerXchange 2.5 and Ensim WEBppliance 2.3. Ensim ServerXchange 2.5 The numbers in parentheses refer to the Ensim Problem Report (PR). ControlCenter The ControlCenter now provides Command Line tools for the Red Hat Linux operating environment. (5763) OpCenter The correct screen now opens when you click New Physical Server through the Install Private Server wizard. (3576) You do not have to refresh the screen after moving a Private Server to see the results. (3563) Physical Server Registering a Solaris Physical Server using the Install option is now supported. (3643) Private Server The Private Server load average now reflects the number of processes on the Private Server run queue. (3721) The shutdown -r command now shuts down and restarts a Private Server. (3869, 4523) The Private Server startup scripts for Linux now allow you to enable quotas by default. (3957) Private Server Administrator Private Server Administrator now cleanly uninstalls from the system. (3737) Ensim ServerXchange 2.5 Release Notes 12

Ensim WEBppliance 2.3 (Linux) The numbers in parentheses refer to the Ensim Problem Report (PR). You can now view Web and FTP logs. (6033) You can now view site log updates. (5864) There is no traceback at the Site Administrator level if the file /etc/opcenter/webhost/appliancemenu.dtml is there, but the file /etc/opcenter/webhost/sitemenu.dtml is missing. (5675) Resolved product issues The customization script is now executed after the templates are created. (5347) You can now add a virtual site even if the file /etc/named.conf has been altered. (6062) The virtual DNS related records created in the directory /var/named now include a period at the end of the host name. (6504) There is no longer a time lag when Ensim WEBppliance is shut down. (5609) The frontend no longer times out when large error messages are generated by the backend. (5677) Email now functions for sites with site names entered with upper and lowercase characters. (5579, 5671) You can now have your customers contact you directly rather than Ensim. (5520) The virtual site is no longer deleted from the file httpd.conf when Apache Web service is removed. (6288) The File Manager now displays the correct directory when traversing back. (5622, 6365) Ensim ServerXchange 2.5 Release Notes 13

Resolved product issues You can now back up and restore the following customization files. (6547) /usr/lib/opcenter/base/rollout/startscreen.dtml /usr/lib/opcenter/base/rollout/welcome.dtml /usr/lib/opcenter/published/webhost/rollout/startscreen.dtml /usr/lib/opcenter/published/webhost/rollout/welcome.dtml /usr/lib/opcenter/published/logout.dtml /usr/lib/opcenter/images/splash.gif /usr/lib/opcenter/images/logo.gif /etc/virtualhosting/templates/*gif /etc/virtualhosting/templates/index.*html Ensim ServerXchange 2.5 Release Notes 14

Known issues Known issues This section describes the known issues of Ensim ServerXchange 2.5, Ensim WEBppliance 2.5, and Ensim WEBppliance 2.3. Ensim ServerXchange 2.5 The numbers in parentheses refer to the Ensim Problem Report (PR). ControlCenter If you change the IP address of a ControlCenter, you must restart the Physical Server that the ControlCenter is on in order to access the ControlCenter with the new IP address, and to restart Apache. You must also verify that the new IP address is correct, and that it is not duplicated elsewhere on the network. (5499) Network installation KickStart process The Microsoft Windows 2000 Server product license key is not validated until install time. If you enter the wrong key, the KickStart process will stall. (5802) Solution: Type in the correct product license key and click Next. The KickStart process will resume shortly. If the Physical Server contains a Network Interface Card (NIC) that is not supported by standard Microsoft Windows 2000 Server distribution, the Physical Server will not have the network interface configured after the KickStart process. (6147) Solution: Add a network driver and configure the network manually. Ensim ServerXchange 2.5 Release Notes 15

Known issues The KickStart process has hardware limitations, and will work only if the NICs and/or disk controller card drivers on your Physical Server match the list of drivers on the Microsoft Windows 2000 CD-ROM or the Red Hat Linux CD-ROM that you load on the ControlCenter. Solution: Before you start the KickStart process, make sure that the Ethernet card is supported by Microsoft Windows 2000 and Red Hat Linux 6.1. You can access a list of supported or known unsupported network and storage device drivers at the following URL. http://www.ensim.com/docs/public/sxc/2_5/hl/hl.html OpCenter OpCenter 2.1.0 is incompatible with the final release of ServerXchange 2.5.0. You must download and install OpCenter 2.5.0. Note: OpCenter 2.5.0 is backwards compatible with prior versions of Ensim ServerXchange, so you can use it to manage other versions of Ensim ServerXchange that you may have. OpCenter times out during operations that take longer than 90 minutes. (5340) Solution: 1 Telnet to ControlCenter to restart the Physical Server. 2 Reregister the Physical Server, making sure not to reinstall the ServerXchange operating environment. After upgrading a Physical Server, you may have to restart OpCenter for the Alarm Viewer to receive messages again. (5090) Ensim ServerXchange 2.5 Release Notes 16

Known issues Physical Server There is no network connectivity between a Private Server and the Physical Server on which it resides. If you attempt to access a Private Server from its Physical Server, the operation will fail accompanied by a host unreachable or a no route to host message. (7711) You cannot simultaneously install multiple instances of the same Service on a newly registered Physical Server. (3819) If you have trouble performing operations on the Physical Server, make sure the scroll lock on your keyboard is turned off. (3535) If you do not provide free disk space on a Physical Server, and you perform an operation that involves writing to the disk, such as a service installation, the operation will fail. (7108) Do not assign the user ID number 65520 to any user. Doing so will void the Ensim warranty. Private Server When adding a Private Server, in the Install Location field, you must enter the full path of an existing directory on the Physical Server - for example, </usr/serverxchange>. If you only enter a forward slash (/), it will generate an error when adding the Private Server. When adding a Solaris NFS Private Server, you must have a disk quota size approximately 100 MB larger than the size of the package option. (5256) When assigning an IP address to a Private Server, do not use the ControlCenter IP address. ControlCenter currently does not check for this conflict, and it may cause problems. (5331) When installing a Private Server using the Command Line Interface (CLI), using the install_private command alone will not start the Private Server. You must also use the start_private command. (6843) Ensim ServerXchange 2.5 Release Notes 17

Known issues Services If a Service is missing from Ensim AppXchange, the download error message notifies you that the specification file may be corrupted. (2879) Certain Services require more than the minimum 64 MB of memory to run. Check the specific Service s memory requirements by running top. Apache, mod_php, mod_perl, and Microsoft FrontPage extensions are dependent Services. When you upgrade any one of these Services, you must also upgrade the others. You must restart Apache after upgrading it. You must restart the Physical Server to complete the installation of Ensim VirtualHosting Tools, ColdFusion, and BIND. (5859) For Windows 2000 Physical Servers with Ensim WEBppliance Suite 2.5 installed, the OpCenter Service Status window will indicate that FTP and POP are not running, since these services are not available at the Physical Server level. (5855) The Microsoft Access 2000 package requires a large amount of disk space. If you do not provide free disk space and try to install the service, the service installation will fail and the error message [1107] Cannot push Service to the Physical Server will display. (6289) If this happens, provide free disk space and retry the installation process. Private Server Administrator Private Server Administrator does not automatically allow secure http connections after Ensim Secure Web Server service is installed. To enable secure http connections on Private Server Administrator, remove the file /etc/opcenter/nohttpd and restart Private Server Administrator. You can then access Private Server Administrator using the following URL: https://<yourprivateserverhostname>:19638/psadmin If you already have a Details window open, and you perform another operation that attempts to open another Details window, a Java script error message displays. Close the Details window before performing another operation. (5319) Ensim ServerXchange 2.5 Release Notes 18

Ensim WEBppliance 2.5 (Windows) The numbers in parentheses refer to the Ensim Problem Report (PR). Browser issues Known issues Microsoft Internet Explorer 4.0 sometimes has problems opening a dialog box when downloading files through the Web Server Manager or the File Manager. (2887, 4771) Solution: 1 In the Internet Explorer main toolbar, click. 2 In the Actions column of the Log Files window, right-click Download, and select Save Target As. 3 In the dialog box, enter the file name where you want to download. Microsoft Internet Explorer 4.0 has problems with caching, and on certain pages, will fail to notify Ensim WEBppliance to carry out tasks. Microsoft Internet Explorer 4.0 also has problems with cookies and redirection, which Ensim WEBppliance uses in several instances. Documentation Ensim WEBppliance 2.5 User s Guide - For Windows, page 3-8 (blue Tip: box) indicates that you can preview a virtual site s Web pages by typing the URL http:<site>/admin where <site> is the host name of a name-based virtual site or the host name or IP address of an IP-based virtual site. However, this URL takes you to the Ensim WEBppliance welcome page, not to virtual site s Web pages. Please disregard this URL. (11630) Sites If you create a virtual site with the same Fully Qualified Domain Name (FQDN) as your Physical Server, the virtual site will process all incoming Web requests directly. Ensim ServerXchange 2.5 Release Notes 19

Known issues Services Services display if installed after Ensim Webppliance Suite 2.5, but you must restart Ensim VirtualHosting Tools within Ensim Webppliance Suite 2.5 for changes to take effect. (5951) ODBC boundary check is not supported. In the Data Source window, Scan Rows field, typing a value outside the specified limit of 1-16 does not display an error message. (5967) Responders and Majordomo are not supported. (5836, 5997, 6040, 6041) File Manager does not allow you to edit file permissions. (6048) Virtual users do not have FTP access to their sites. (5871) Web server is always on for a site. You can toggle the Web server options, not the Web server. (5944) Site Reports display Web usage logs, but you must ensure that the log file formats for Web and FTP remain unchanged. (5884) The log file formats for Web and FTP are as follows: Web W3C Extended Log File Format FTP Microsoft IIS Log File Format Ensim ServerXchange 2.5 Release Notes 20

Ensim WEBppliance 2.3 (Linux) The numbers in parentheses refer to the Ensim Problem Report (PR). Browser issues Microsoft Internet Explorer Known issues Microsoft Internet Explorer 4.0 has problems with caching, and on certain pages, will fail to notify Ensim WEBppliance to carry out tasks. Microsoft Internet Explorer 4.0 also has problems with cookies and redirection, which Ensim WEBppliance uses in several instances. Microsoft Internet Explorer 4.0 sometimes has problems opening a dialog box when downloading files through the Web Server Manager or the File Manager. (2887, 4771) To correct the problem: 1 In the Internet Explorer main toolbar, click Back. 2 In the Actions column of the Log Files window, right-click Download, and select Save Target As. 3 In the dialog box, enter the location where you want to download. Netscape Netscape 4.61 and earlier has problems with SSL. If you are using Netscape 4.61 and earlier, disable SSL v3; otherwise, when connecting to the Ensim WEBppliance appliance, you will see the error message Netscape has encountered bad data from the server. This is a known browser bug. To correct the problem: 1 In the Netscape window, click at the bottom left of the browser window. 2 In the Security Info window, click Navigator. 3 In the Navigator window, clear the Enable SSL (Secure Sockets Layer) v3 check box. Ensim ServerXchange 2.5 Release Notes 21

Known issues Services You must upgrade all Private Servers hosting Ensim WEBppliance Suite 2.1 or Ensim WEBppliance Suite 2.2 to Ensim WEBppliance Suite 2.3. You can upgrade in one of the following ways. New installation If this is a new installation of Ensim WEBppliance Suite 2.3, you must use the Ensim AppXchange portal to first download Ensim WEBppliance Suite 2.3 and Miva E-Commerce for WEBppliance Add-on 2.13. Once you register them, you can use the Ensim ServerXchange OpCenter user interface to deploy them onto a Private Server. Within Ensim WEBppliance Suite 2.3, you must first install the OpenSSL Service, then install the Sendmail SMTP Server Service. This is because Sendmail is dependent on OpenSSL. If OpenSSL is not already installed, the Sendmail installation will fail, impacting the installation of Ensim WEBppliance Suite 2.3. Upgrade to Ensim WEBppliance Suite 2.3 If you are upgrading to Ensim WEBppliance Suite 2.3, after the upgrade you must restart Ensim Virtual Web Hosting Tools and Sendmail, or restart the Private Server hosting Ensim WEBppliance Suite 2.3. When upgrading a large number of virtual sites, you may encounter a timeout issue. The virtual sites are successfully upgraded, but the ControlCenter user interface times out on the action. This will be addressed in a future release. Ensim ServerXchange 2.5 Release Notes 22

Known issues The upgrade mechanism backs up and restores the customization files, causing the following issues. The file /usr/lib/opcenter/base/rollout/welcome.dtml displays the Support link pointing to support@ensim.com, even though it has been taken out of this release. It also displays the old RSA logo instead of the new OpenSSL logo. The file /etc/virtualhosting/templates/index.html displays the old Adobe Fireworks instead of the new Macromedia Fireworks. The upgrade reconstructs the Apache configuration file httpd.conf, so you may lose any customizations made to a virtual site s VirtualHost container. However, before the reconstruction, a backup of the file httpd.conf is made to the file /etc/httpd/conf/httpd.conf.domains.bak. If the Ensim WEBppliance server file /etc/resolv.conf is edited, the virtual site file /etc/resolv.conf must be updated as well. (6430) To correct the problem, as root user, type the following command. cat /etc/resolv.conf > /home/virtual/filesystemtemplate/etc/ resolv.conf This command will automatically update all existing sites, and all new sites will now use the new file /etc/resolv.conf. If you install the POP3 + IMAP Server service after you install Ensim Virtual Web Hosting Tools, Ensim WEBppliance will not be able to retrieve the status of the IMAP service. To correct the problem: 1 As root user, access the file /etc/serverxchange/services/imap. 2 Replace status= with status=/etc/virtualhosting/imap_status.sh Ensim ServerXchange 2.5 Release Notes 23

Known issues Miva E-Commerce for WEBppliance Add-on is an optional Service Suite that contains Miva Empresa and Miva Merchant for WEBppliance Add-on services. If you try to install any one of these services, and not the other, you will get a service dependency failure. When you install the Suite, you must install Miva E-Commerce for WEBppliance Add-on Suite, not Miva E-Commerce Suite. Installing the Miva E-Commerce Suite will install PS Admin, and cause Ensim WEBppliance to break. You can add aliases, external email addresses, and virtual users to Majordomo Mailing Lists; however, you should not add a responder (or an alias that points to a responder). Mails generated by Majordomo and sent to the responder will bounce back, and the ensuing mail cycle will bring down the system. Vacation does not work for virtual users on name-based sites, or virtual users with any option other than Telnet enabled. (5990) When creating a new virtual site, Ensim WEBppliance does not automatically create a reverse zone file for the virtual site. (6588) If you do not create the reverse zone before you create the virtual site, Ensim WEBppliance will not append any records to the reverse zone; however, if you created the reverse zone before you create the virtual site, Ensim WEBppliance will attempt to add the site to the reverse zone. Ensim ServerXchange 2.5 Release Notes 24

Application-specific issues Application-specific issues This section describes the application-specific issues of Ensim ServerXchange 2.5, Ensim WEBppliance 2.5, and Ensim WEBppliance 2.3. Ensim WEBppliance 2.5 (Windows) The numbers in parentheses refer to the Ensim Problem Report (PR). ColdFusion On the ColdFusion Server Administrator window, the Example Applications or Test your Installation options will work only if you access ColdFusion from a local machine. (6107, 6109, 6878) Microsoft FrontPage For virtual sites that have Microsoft FrontPage enabled, the user s name and password are the same as the virtual site owner s name and password. The Site Administrator may have to specify the host name of the Physical Server as part of the user name. Example: Username: <Physical Server>\<SiteAdmin> where <Physical Server> is the name of the Physical Server hosting Ensim WEBppliance Suite 2.5 and <SiteAdmin> is the Site Administrator s user name. Ensim ServerXchange 2.5 Release Notes 25

Ensim WEBppliance 2.3 (Linux) The numbers in parentheses refer to the Ensim Problem Report (PR). Application-specific issues Apache, mod_php, mod_perl, and FrontPage Server Extensions Apache, mod_php, mod_perl, and Microsoft FrontPage Server Extensions are closely related. When you upgrade any one service, you must upgrade the others. You must also stop and restart Apache after the upgrade process. Note: When you upgrade Apache, you may have to upgrade other services that rely on Apache as well. For sites that have Microsoft FrontPage enabled, the user s name and password are the same as the site owner s user name and password. Apache and SSL If you delete the main Secure Sockets Layer (SSL) certificate and restart Ensim WEBppliance, the application runs in a nonsecure mode. To connect to the Ensim WEBppliance server, type the following URL. http://<webppliance host name>:19638/webhost/rollout/ To run the server in a secure mode again, generate and import a new SSL certificate. See the Ensim WEBppliance 2.3 User s Guide for procedures. If you generate and import a new SSL certificate, you must restart Ensim Virtual Web Hosting Tools to re-enable the usual entry point of http://<webppliance host name>/. Ensim ServerXchange 2.5 Release Notes 26

Application-specific issues Apache is compiled with suexec support, which is sensitive to security issues and does not run CGI scripts that do not conform to its standards. When you create a script in your script alias directory, make sure that it is owned by the Site Administrator, and that it is write-protected. To write-protect a file, use the chmod command. Example: chmod 755 myscript.cgi generates the following permission setting: -rwxr-xr-x 1 <u1401> <u1401> 102 Sep 8 05:19 myscript.cgi chmod 700 myscript2.cgi generates the following permission setting: -rwx------ 1 <u1401> <u1401> 102 Sep 8 05:19 myscript2.cgi where <u1401> refers to the site owner. Backup or Restore You should not restore any files in version 2.2 or version 2.1 that were backed up in version 2.0. You can, however, restore files existing before the upgrade. (4700) Since the Restore process requires a substantial amount of browser CPU and memory, restoring large backup archives may cause your Web browser to become unresponsive. FTP To correct the problem, use FTP to transfer files, and use the tar utility to manually restore your archive. When editing a virtual site, disabling FTP and then enabling it will cause the FTP server name to be set to not.enabled, regardless of what is entered in the FTP server name field. This does not affect the functionality of the FTP service. (5060) To change the FTP server name: 1 Edit the virtual site, and type enabled in the FTP server name field. 2 Edit it again, and set the FTP server name to what it should be, for example, ftp.mydomain.com. Ensim ServerXchange 2.5 Release Notes 27

CORPORATE HEADQUARTERS Ensim Corporation 1366 Borregas Avenue Sunnyvale, California 94089 www.ensim.com November 2001