iAnywhere M-Business Anywhere Version 5.5 Build 142 for Linux ================================================================= TABLE OF CONTENTS ================================================================= 1 - WHAT'S NEW IN THIS RELEASE: CLIENT FEATURES 2 - WHAT'S NEW IN THIS RELEASE: SERVER FEATURES 3 - DOCUMENTATION 4 - SYSTEM REQUIREMENTS 5 - UPGRADING 6 - SUPPORTED/UNSUPPORTED CONFIGURATIONS 7 - PRE-INSTALLATION NOTES 8 - SECURITY NOTES 9 - CONTACTING IANYWHERE SOLUTIONS ============================================================== 1 - WHAT'S NEW IN THIS RELEASE: CLIENT FEATURES ============================================================== Windows XP ========== Windows XP is now supported as a client OS. The client has been specifically tested on Windows XP Tablet Edition, 2002 version, with service pack 1. ================================================================= 2 - WHAT'S NEW IN THIS RELEASE: SERVER FEATURES ================================================================= Changing Database passwords =========================== Changing database passwords is facilitated by scripts (ChangePassword.bat on Windows and ChangePassword on Unix) that automate more of the steps. Optional 400 Error override handling ==================================== Optional 400 Error override handling for group channels prevents pages that were previously downloaded to a user’s mobile device from being overwritten by an error page when the page is not available in a later sync. This is particularly important for mobile application pages that depend on the availability of JavaScript on the page to support special navigation and enforce application logic. Expanded Administrator Console user interface: ============================================== Information tab --------------- Information tab on Server Status page displays additional information on (Server Type, Syncs Today, and Average Sync Time Today). Reports tab ----------- Reports tab on Server Status page makes four reports on various sync statistics available: "Users who have not synced" in the time period you select, "Browse sync log" of sync info and errors for next number of entries you select, "Browse Webstats log" for web log statistics for for next number of entries you select, and "Useage History" of number of syncs and average sync time for last number of days you select. Log file enhancements: ====================== Retention period for log data ----------------------------- Retention period for log data may be specified via the SyncPref DaysOfLogDataToKeep property in the sync.conf file. Log data is automatically purged after reaching the age you specify. Default is 20 days. Fetch and reverse access log files ---------------------------------- Fetch and reverse access log files can be set up and configured to capture a line of data for every rover fetch. The fetch log, set up via FetchLog setting in sync.conf, records the fetched URL, the channel root URL, and the referring URL. The reverse access log, set up via ReverseAccessLog setting in sync.conf, records host address, user ID, date, status code, cache result, request time, and size. ================================================================= 3 - DOCUMENTATION ================================================================= 3.1 - Accessing Release Documentation: ====================================== Download site ------------- http://www.ianywhere.com/downloads/software/mbus_linux.html - Provides access to all available documentation, plus sample code. *** Requires a valid user name and password. Home page for M-Business Anywhere Product Manuals ------------------------------------------------- http://www.ianywhere.com/developer/product_manuals/index_mbus_anywhere.html - Provides access to available documentation only; no sample code. *** No user name/password are required. 3.2 - Available Documentation: =============================== Administrator Guide for M-Business Server ----------------------------------------- Provides instructions for installing, configuring, and optimizing M-Business Anywhere, including setting up and configuring the M-Business XML Conduit. User Guide for M-Business Client -------------------------------- Provides instructions for registering accounts, syncing channels, and using M-Business Client. Developer Handbook for Creating Applications Using M-Business Dynamic Mobility Model ------------------------------------------------------------------------------------ Provides an overview of the Dynamic Mobility Model concept for designing applications using M-Business Client, and discusses related development and deployment issues. M-Business Anywhere Channel Developer Guide ------------------------------------------- Provides detailed guidance on designing websites and individual pages for optimum usefulness on different types of mobile devices, with or without a wireless connection. Developer Guide for M-Business JavaScript Engine, M-Business Client Extension API, and M-Business Database API ------------------------------------------------------------------------------------ Includes introductory information, system architecture, reference tables, and sample code. Release Notes for M-Business Server and AvantGo Client ------------------------------------------------------ Provides information on late-breaking issues not covered in standard documentation. ================================================================= 4 - SYSTEM REQUIREMENTS ================================================================= 4.1 - M-Business Server Requirements: ====================================== Server Hardware --------------- - At least 256MB RAM and 160MB disk space (Note: Disk space and RAM requirements vary according to user population.) - At least a Pentium II 233 MHz Server Operating System ----------------------- Linux kernel 2.4.18 (as implemented in Redhat Linux 8.0) Internet Browser ---------------- One of the following JavaScript-enabled browsers (does not have to be on machine where M-Business Server is installed): - Internet Explorer 5.5 - Internet Explorer 6.0 - Netscape Communicator 4.75 - Netscape Navigator 6.1 Note: Internet Explorer is required, if you are using M-Business Server with RIM Wireless Handhelds. Valid license key ----------------- A valid license key looks like this: K8OhbcykViqiI1NnXlA/XywzFg+Fx6TZ 4.2 - System Requirements for use with RIM Handhelds: ====================================================== A valid SRP key from RIM is required. Note: This is NOT the same SRP key you received with your RIM device. You must request a second SRP key for exclusive use with M-Business Server. ================================================================= 5 - UPGRADING ================================================================= 5.1 - Upgrading to version 5.5: =============================== M-Business Anywhere supports upgrading M-Business Server from versions 4.0, 4.1, 4.2, 5.0, 5.1, 5.2, and 5.3 to version 5.5. For upgrade instructions, see Chapter 8, "Upgrading and installing on Unix," of the Administrator Guide for M-Business Server. 5.2 - Upgrading M-Business Server: ================================== When upgrading, you will be prompted to preserve your pre-existing database. If you choose No, all existing user and account data will be erased. If you choose Yes, M-Business Anywhere will preserve your existing user and account data. 5.3 - Upgrading OS & M-Business Server at the same time: ======================================================== If you upgrade your OS, you must reinstall M-Business Server software afterwards. Before upgrading your OS, save your M-Business Server database, then uninstall M-Business Server. 5.4 - Upgrading M-Business Client: ================================== If your users are using a previous version of M-Business Client, we recommend upgrading to the client included with this server. There may be incompatibilities between previous clients and this version of the server. You cannot use M-Business Client for RIM Wireless Handhelds with versions of M-Business Server lower than 4.0. ================================================================= 6 - SUPPORTED/UNSUPPORTED CONFIGURATIONS ================================================================= 6.1 - Collocation with Primary Domain Controller NOT Supported ============================================================== We do not support installation of M-Business Server onto machines configured as Domain Controllers. 6.2 - Collocation with Microsoft Exchange Server NOT Supported =============================================================== We do not support installation of M-Business Server on machines that host Microsoft Exchange Server. 6.3 - Installing JavaScript client over non-JavaScript client on Pocket PC ========================================================================== If you install a JavaScript-enabled client over a non-JavaScript client, you will need to restart M-Business Client before you will be able to use the JavaScript feature. ================================================================= 7.0 - PRE-INSTALLATION NOTES ================================================================= 7.1 - Locating installation instructions ======================================== For installation, setup, and configuration information, please refer to the "Getting Started Task Checklist" in Chapter 2, Introduction, of the Administrator Guide for M-Business Server. 7.2 - Obtaining gtar and gzip for installation =============================================== gtar and gzip are required to untar M-Business Server because Solaris tar does not support long file names. - You can find gtar at: http://www.sunfreeware.com - You can find gzip at: http://www.gnu.org 7.3 - Logging on as root ======================== All operations including installation and starting the servers must be done as root. 7.4 - Setting the UserFriendlyServerName parameter ================================================== The UserFriendlyServerName field in the sync.conf.default file allows you to set a server name that will appear in the list of servers AvantGo Connect on the device (and on the desktop). You must set this name BEFORE syncing; otherwise setting a name in this field has no effect. 7.5 - Installer doesn't create install.log file during installation ==================================================================== ================================================================= 8 - SECURITY NOTES ================================================================= 8.1 - Supported security level ============================== This product supports up to 128-bit encryption with SSL. 8.2 - Microsoft Internet Explorer proxy settings ================================================ If your users sync securely using Microsoft Internet Explorer proxy settings, you will need an RSA certificate. You can request an RSA certificate from a third-party vendor, such as Thawte or Verisign. See "Security on Windows" in the Administrator Guide for M-Business Server. 8.3 - Default proxy server ========================== If your users sync securely using the default proxy settings, you will need an ECC certificate from AvantGo. See "Security on Windows" in the Administrator Guide for M-Business Server. 8.4 - Problems with proxy servers & login cookies ================================================= If your M-Business Server accesses the Internet through a proxy server, it is possible that your users may experience difficulties with sites requiring login cookies. To avoid these problems, we advise turning off the proxy server's caching ability. ================================================================= 9 - CONTACTING IANYWHERE SOLUTIONS ================================================================= 9.1 - Technical Support ======================= corp_support@ianywhere.com 9.2 - Client Services ===================== If you need help with customizing iAnywhere software to better serve your enterprise, please contact iAnywhere Solutions Professional Services at contact_us@ianywhere.com. 9.3 - Technical Publications ============================ If you have questions or suggestions about this document or other iAnywhere technical publications, please contact iAnywhere Technical Publications at iasdoc@ianywhere.com. (C)iAnywhere Solutions, Inc. All rights reserved. All unpublished rights reserved. iAnywhere, M-Business Anywhere, and M-Business Server are registered trademarks or trademarks of Sybase, Inc. or its subsidiaries. The ® symbol indicates registration in the United States of America. All other company and product names mentioned may be trademarks of the companies with which they are associated.