______________________________________________________________________ RELEASE NOTES for Samsung Contact Server Version 8.5 March 2004 Edition 2.8 ______________________________________________________________________ Read these release notes before installing Samsung Contact as they provide important information about the 8.5 release of the Samsung Contact server on Linux(R), HP-UX and Sun Solaris. These release notes cover the following: o SUPPORTED PLATFORMS AND HARDWARE o PREREQUISITE SOFTWARE o SUPPORTED CLIENTS o LICENSING REQUIREMENTS FOR INSTALLATION o UPGRADING FROM HP OpenMail(R) o POST-INSTALLATION TASKS o NEW FEATURES AND CHANGES o CONFIGURING THE SAMSUNG CONTACT SERVER WHEN USING PIMS o KNOWN PROBLEMS AND RESTRICTIONS o SAMSUNG CONTACT DOCUMENTATION o CD-ROM STRUCTURE o NOTICES When you have read these release notes, print and read the "Samsung Contact Getting Started Guide." This is the file GETTING_STARTED.PDF in the DOCS directory on your distribution medium. The "Getting Started" guide gives an overview of the installation and components. It also gives detailed post-installation configuration instructions. You will also need the installation instructions in the DOCS directory on your distribution medium: o Samsung Contact Installation Instructions for Unix, UNIX_INSTALLATION.PDF, for installation on HP-UX and Sun Solaris. o Samsung Contact Installation Instructions for Linux, LINUX_INSTALLATION.PDF, for installations on Linux. For the latest product, support and licensing information, see the Samsung Contact web site: http://www.samsungcontact.com Conventions: In this document, ~ is used to refer to your Samsung Contact installation directory which is usually /var/opt/openmail. ---------------------------------------------------------------------- SUPPORTED PLATFORMS AND HARDWARE ---------------------------------------------------------------------- This version of the Samsung Contact Server is supported on the following platforms and hardware: o HP-UX 11.00 or 11.11i with the December 2001 patch or above on HP9000 series hardware. Requires 110 MB in /opt/openmail for the core server and all languages. High availability is supported on HP-UX systems using MC/ServiceGuard. o RedHat Linux 8 or 9 on Intel x86 compatible machines. Requires 150 MB in /opt/openmail for the core server and all languages. o Sun Solaris 8 (with December 2001 patch level) and 9 on Sun Solaris SPARC binary compatible machines. Note that Intel 386/486 Solaris is not supported. Requires 120 MB in /opt/openmail for the core server and all languages. ---------------------------------------------------------------------- PREREQUISITE SOFTWARE ---------------------------------------------------------------------- This section lists the required software: o The tk package is required by the Linux setup wizard. If it is not installed, the Linux wizard will fail with the following error: "/usr/bin/wish could not be found." For more information about obtaining the tk package, go to the Web site for your Linux distribution. o Sendmail To connect to other Samsung Contact systems or an Internet Mail Gateway, you need Sendmail as your message transport. Samsung Contact supports the versions of Sendmail provided with the supported base operating systems. o Web Server A Web Server is required for the Web Administration Tool and the Samsung Contact Web client. The Web server must support CGI 1.1. The minimum version of the Apache HTTP Server version 2 that the Samsung Contact server has been tested on with Red Hat Linux 8 and 9 is 2.0.40. The minimum version of the Apache HTTP Server version 1 that the Samsung Contact server has been tested on with all other supported platforms is version 1.3.22. For management using the Web Administration Tool from a remote Web server machine, Stunnel is supported. See the New Features section later in this document for more information. o Web Browser A Web browser is required to access the Web Administration Tool and the Samsung Contact Web client. You should be able to use any Web browser that supports JavaScript and cookies. The following Web browsers have been certified for use with the Web Administration Tool and the Web client: - Internet Explorer 5.01 and 5.5. - Netscape Communicator 4.73. The version 8.5 Web client also supports Mozilla version 1.1a or higher. ---------------------------------------------------------------------- SUPPORTED CLIENTS ---------------------------------------------------------------------- This version of the Samsung Contact server supports the 8.5 Samsung Contact Web client, Java client for Linux, and Java client for Windows. The 8.5 clients are not backwards compatible with Samsung Contact Server versions prior to 8.5. The Samsung Contact clients are available in a separate client download from the Samsung Contact Web site. To install the Java and Web clients, see the installation instructions provided in the Client download. This version of the Samsung Contact Server also supports the 8.0.0, 8.0.2 and 8.5 MAPI Service Providers. Samsung Contact is compatible with HP OpenMail clients. See the section "OpenMail features not supported by Samsung Contact". ---------------------------------------------------------------------- LICENSING REQUIREMENTS FOR INSTALLATION ---------------------------------------------------------------------- This version of Samsung Contact includes a 45-day evaluation license. Read this section to find out whether you need to purchase licenses before installing Samsung Contact. To purchase licenses directly, or to find your local sales office, see the Samsung contact Web site. For more information about the Samsung Contact licensing functionality, see the "Samsung Contact Licensing Guide". This is the file LICENSING_GUIDE.PDF in the DOCS directory on your distribution media. For licensing requirements for upgrading to Samsung Contact from OpenMail, see the section "UPGRADING FROM HP OpenMail" in this document. For licensing purposes, the issue date of the Samsung Contact 8.5 server software is 01-April-2004. This section covers the following topics: o New Samsung Contact Installation o Upgrading from a Previous Version of Samsung Contact o Running Samsung Contact in a Clustering Environment ----- New Samsung Contact Installation ------ If you are installing Samsung Contact for the first time, you do not need to purchase a license to install it. The software comes with a free evaluation license that allows you to install and run the software for 45 days while you purchase valid licenses. Note that it may take some time to raise orders and issue licenses, so allow sufficient time to get the licenses before the evaluation period expires. ----- Upgrading from a Previous Version of Samsung Contact ----- If you have purchased a maintenance agreement, you may be entitled to upgrade to this version of Samsung Contact without purchasing new licenses. On your current Samsung Contact system, run the sclicense command. o If the Latest valid Contact issue date is earlier than the software issue date, you will NOT be allowed to upgrade. Do not attempt to install the software. You must purchase support licenses for your existing servers before installing this version. o If the Latest valid Contact issue date is later than the software issue date, you will be able to upgrade to the new version without purchasing additional licenses. NOTE: Only customers who have purchased Support and Maintenance for Samsung Contact are entitled to upgrade to the next release of Samsung Contact, unless you intend to purchase an upgrade. If you did not purchase Support with your current version of Samsung Contact, your License file will not have an LVID (Latest Valid Installation Date) which is later than the release date of the new version. In fact it may not have an LVID date at all. If your license file does not have an LVID date that is later than the release date of the new version but you try to upgrade to the new version, your licenses will fail and Samsung Contact will not start. You have to purchase an upgrade to the new version or you have to restore the system to what it was prior to the upgrade. ----- Running Samsung Contact in a Clustering Environment ----- If you are running Samsung Contact in an clustering environment such as MC/ServiceGuard on HP-UX or Red Hat Advanced Server with High Availability support, you do not need separate licenses for each machine in the cluster. You must make sure that you have purchased sufficient licenses for all the server instances running on your main machines. These licenses are automatically available on each system in the cluster. ---------------------------------------------------------------------- UPGRADING FROM HP OpenMail ---------------------------------------------------------------------- Note: This section does not apply to SuSE Linux or Red Hat Linux Advanced Server. Read this section if you are upgrading from HP OpenMail version 6.0 or 7.0. This section covers the following topics: o Licensing requirements o Upgrading from OpenMail 6.0 o Before upgrading a system running OpenMail Instances (HP-UX only) o Changes to the Default Auto-Reply Configuration Options o Removing the setting for distributed licensing o OpenMail features not supported in Samsung Contact ----- Licensing requirements ------ You must purchase a valid Samsung Contact license before you can upgrade from OpenMail to Samsung Contact. Existing OpenMail licenses are not recognized by Samsung Contact. To obtain a license, you need to provide some information about your OpenMail server. Do the following: 1) Copy the program SCLICINFO from the appropriate platform directory on the SERVER CD-ROM. For example: a) cp /mnt/cdrom/SERVER/HPUX/SCLICINFO /tmp/sclicinfo b) chmod +x /tmp/sclicinfo 2) Run SCLICINFO to get a Samsung Contact serial number for your server. You must do this for each server that you want to license. This includes servers running on different machines and multiple servers (instances) running on a single machine. For multiple instances on a single machine, set OMCURRENT to the name of instance and then run SCLICINFO. Repeat this for each instance. 3) Record all the output of sclicinfo. You will be asked to provide this information when purchasing licenses. ----- Upgrading from OpenMail 6.0 ----- If you are upgrading from OpenMail 6.0, it is recommended that you also read the OpenMail 7.0 release notes before upgrading to Samsung Contact. The OpenMail 7.0 release notes are called OMNOTES.TXT on your distribution media in the OTHER/REL7.0 directory. Alternatively, you can obtain the release notes from http://www.openmail.com ----- Before Upgrading an OpenMail System Running Multiple Instances --- This note applies to HP-UX systems only. Before you upgrade from an OpenMail system running multiple instances, you must do the following additional step: 1) Open the configuration file for the Internet Services daemon /etc/inetd.conf 2) Delete the line that starts openmailpxy ----- Removing the Setting for Distributed Licensing ----- Distributed or virtual licensing is replaced by new license lending functionality. If you have set LML_USE_DIST_LIC=TRUE in ~/sys/general.cfg, sclicense reports that you have valid licenses but Samsung Contact fails to start correctly. You must do the following: 1) Remove the line LML_USE_DIST_LIC=TRUE from general.cfg 2) Restart your Samsung Contact server. ----- OpenMail Features Not Supported in Samsung Contact ------ omadmin The Web admin tool is the new graphical administration tool. advmail Text-only mail readers such as pine can be used to access the Samsung Contact Message Store. Also the PDA web client profile could be used in the open source web browser Lynx. This profile can be modified as required. See the "OpenMail Web Client Developers Guide". PC admin The web admin tool is the new graphical administration tool. Existing OpenMail customers wishing to continue using the PC admin client and who have a support contract can contact Samsung Contact support at: support@samsungcontact.com. X.400 Samsung Contact does not support X400 MTAs. Existing OpenMail customers could use an OpenMail system as an X400 gateway. HP Desk Samsung Contact does not support HP DeskManager. Existing OpenMail customers could use an OpenMail system as an HP DeskManager gateway. omgui These clients are not supported by Samsung SDS but may still function correctly against a Samsung Contact server. The old licensing commands have been retired and are replaced by new ones as described in the NEW FEATURES AND CHANGES section. ---------------------------------------------------------------------- POST-INSTALLATION TASKS ---------------------------------------------------------------------- ----- Edit the SMTP Relay Configuration File After Upgrading ----- After upgrading, make sure that the SMTP Relay configuration file, ~/sys/smtpd.cfg, has the following entries: RELAY accept .example.com RELAY reject all RECIPIENT reject *@*@* RECIPIENT reject *%* RECIPIENT reject *!* RECIPIENT reject *#*@* where .example.com is the name of your domain. ----- Automatic processing of meeting reponse by Local Delivery --- Automatic processing of meeting reponse by Local Delivery MUST be enabled by adding the following configuration option to general.cfg: "USE_CONTACT_PIMS=TRUE". If this option is not present, meeting responses will not be processed by the Samsung Contact clients and will remain in the InTray until they are removed by the user. ---------------------------------------------------------------------- NEW FEATURES AND CHANGES ---------------------------------------------------------------------- This section covers the new features and changes. In the 8.5 release: o SUBMIT and LMTP support in the SMTP relay o Administration from a remote web server o Problems fixed in this release ----- SUBMIT and LMTP support in the SMTP relay ------------------------- The SMTP Relay provides support for SUBMIT (RFC 2476) and LMTP (RFC 2033). By default SMTP is on and SUBMIT and LMTP are off. The smtpd.cfg configuration file details how to change this. This allows for better integration with postfix and sendmail. For example, if you want to run postfix on your incoming mail, but allow local users to authenticate, then add the following changes to smtpd.cfg: SMTP=NONE SUBMIT=587 LMTP=24 Then configure postfix to direct local mail to the LMTP port and configure clients to submit on the SUBMIT port. ----- Administration from a remote web server ------------------------ It is now possible to use the Web Admin Tool from a web server that is not physically located with the mail server. It is possible to configure the Web Admin Tool to allow the user to select the mail server to be administered. For more information see WEB_ADMIN_TECH_GUIDE.PDF. ----- Significant Problems Fixed in This Release ---------------------- The following problems were fixed in the 8.5 release of the Samsung Contact server: Removed sticky bits from files where possible (1159) Fixed simple omshowcda output (1127) webselect.cgi now includes the Samsung Contact web client (93) User specific ACL now over-rides all other ACLs (375) omlimit no longer adds multiple general.cfg lines (306) ommodu allows some modifications to logged in users (422) New mail notification ceases after user logged in for an undetermined length of time (1218) ---------------------------------------------------------------------- KNOWN PROBLEMS AND RESTRICTIONS ---------------------------------------------------------------------- ----- Known Problems ----- This section describes known problems and their solutions: o Running sclicense after a new installation (704) o Admin user created release 7.1 or earlier unable to give admin caps to other users (1248) o Migration of old SC PIM data in "other folders" o Old invitations in Inbox o Old birthdays and wedding dates ----- Running sclicense after a New Installation (704) ----- Before using "sclicense -i" to request a license, you must start Samsung Contact and create at least one user, otherwise sclicense reports the the following error: "This contact instance has never been started, please start it". ----- Admin user created 7.1 or earlier unable to give admin caps to others (1248) ---- When you run omshowu on a full admin user, the Capabilities lines should have the values shown below. User Name : John Doe ... Admin Capabilities : YES ... Capabilities: admin If an admin user is unable to assign admin capabilities to others, run omshowu on the admin user. If the second Capabilities line has a null value, you need to remove admin capabilities from the user then re-add them: As root: ommodu -o user -c -admin ommodu -o user -c admin omshowu -n user The Capabilities lines should now display the values shown above. ----- Migration of old SC PIM data in "other folders" ------ Old Samsung Contact PIM data in folders other than their designated ones, for example, a task in a BB or a business card in an Inbox, are not migrated. Viewing these items is supported, but you cannot modify or save them. ----- Old invitations in Inbox ------------------------------ Invitations in Inboxes received before server migration cannot be used for replying. ----- Birthdays and Wedding Dates ------------- Prior to Samsung Contact release 8.5, birthdays or wedding date could be any string. Now birthdays or wedding dates not in yyyymmdd format could be lost after server migration. ---------------------------------------------------------------------- Samsung Contact DOCUMENTATION ---------------------------------------------------------------------- The Samsung Contact server documentation is available in the DOCS directory on the Server CD-ROM. SERVER DOCUMENTATION o Samsung Contact Getting Started, GETTING_STARTED.PDF, covers overview of installation, configuration of server and clients and using the Web Administration Tool. o Samsung Contact Installation Instructions for Unix, UNIX_INSTALL.PDF, covers installation on Solaris and HP-UX. o Samsung Contact Installation Instructions for Linux, LINUX_INSTALL.PDF, covers installation on Linux. o Samsung Contact Licensing Guide, LICENSING_GUIDE.PDF, describes all aspects of licensing, including license lending and problem-solving. o Samsung Contact Application Link Technical Guide, APPLICATION_LINK.PDF, describes application to application messaging. o Samsung Contact Exchange Connector Technical Guide, EXCHANGE_CONNECTOR.PDF, describes Samsung Contact to Microsoft Exchange Server directory synchronization. o Samsung Contact MAPI Service Provider Technical Guide, MAPI_TECH_GUIDE.PDF, describes how to configure the MAPI Service Provider. o Samsung Contact Overview, OVERVIEW.PDF, describes how to configure your system after installation and gives an overview of concepts and components. Follow the instructions in this manual after installing Samsung Contact. o Samsung Contact Technical Guide, TECH_GUIDE.PDF, provides a detailed technical overview of components and features. o Samsung Contact MC/ServiceGuard Technical Guide, SERVICE_GUARD.PDF. Note that this book has not been updated. It provides a good introduction to the product. For more up to date examples, see the "How To: Service Guard". Log in to the Samsung Contact Web site, select "Support and Training", and then select "Support Documentation". o Samsung Contact WAP Client User's Guide, WAP_CLIENT_USER_GUIDE.PDF describes how to use the WAP client. o Samsung Contact Web Administration Tool Technical guide, WEB_ADMIN_TECH_GUIDE.PDF, describes how to set up the Web Administration Tool. Some OpenMail Documentation is also provided in the DOCS directory on the server CD-ROM. See the README.TXT file in the DOCS directory. On-line manual pages are provided with the installed Samsung Contact server software. ---------------------------------------------------------------------- CD-ROM STRUCTURE ---------------------------------------------------------------------- The Samsung Contact server release is available on a CD-ROM or from the Samsung Contact web site. The CD-ROM is organized as follows: Server CD-ROM | +-- DOCS -----+-- README.TXT -- List of manual titles and | | corresponding file names | | | +-- *.PDF-------- Adobe Acrobat PDF files for | printing and viewing the documentation | +-- OTHER ----+-- REL7.0 ------ OpenMail 7.0 release notes | | (OMNOTES.TXT). | | | +-- SOURCE.TAR -- Publicly available source files. | gzip, lynx, unzip, md5sum | +-- RELEASE_NOTES.TXT --------- This file | | +-- LICENSE.TXT --------------- A copy of the evaluation license | | +-- SERVER ---+-- HPUX -----+-- CONTACT-8.5.0.SD -- Server image | | | | | +-- SCLICINFO --------- License Key generator | | | +-- REDHAT ---+-- contact*.rpm ------ Core and language files | | | for server | | | | | +-- omwizard*.rpm ----- Wizard files | | | | | +-- SCLICINFO --------- License Key generator | | | +-- SOLARIS --+-- CONTACT-8.5.0 ----- Server image | | | +-- OMXTRACT ---------- Server install script | | | +-- SCLICINFO --------- License Key generator | | +-- wizard -------------------- Installation wizard for Linux ---------------------------------------------------------------------- NOTICES ---------------------------------------------------------------------- The information contained in this document is subject to change without notice. Samsung SDS Co., Ltd. makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Samsung SDS Co., Ltd. shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material. Linux is a registered trademark of Linus Torvalds. Microsoft and Windows are registered trademarks, and Windows NT is a trademark of Microsoft Corporation. OpenMail is a registered trademark of Hewlett-Packard Company in the UK, the USA and other countries. Red Hat is a registered trademark and RPM is a trademark of Red Hat Software Inc. Sun and Solaris are trademarks or registered trademarks of Sun Microsystems Inc, in the U.S. and other countries. Unix is used as a generic term covering all versions of the UNIX(R) operating system. UNIX is a registered trademark in the United States and other countries, licensed exclusively through The Open Group. Copyright (c) 2002-2004 Samsung SDS Co., Ltd.