M-Business Anywhere Version 571 Build 1016 for Solaris ================================================================= 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 ============================================================== Added "Fire and forget" functionality ===================================== New functionality, implemented natively by the client with a JavaScript API, for use when submitting a form request in online mode. This feature attempts to submit the form in online mode, and if the request fails (e.g., it times out or there is a communications error), the request will be placed in the Forms Manager as if the client were in offline mode. The next time the client is online and attempts an online forms submission, pending forms in the Forms Manager will be sent up to the server along with the current form. Bracketing of sync and online forms submissions by start and stop URLS will be supported. The standard full sync will continue to function as it does today and when initiated would override any retry strategy associated with the queued request. Errors will be processed and handled in the same manner that sync errors are handled today. If there is a non-connection related error, the sync should continue with its normal processing. The two new client-side preferences to use to implement this functionality are: - SaveSubmissionOnOnlineError The value of this preference is a boolean, and the default value is false. When set to true, if a connection error occurs during the online submission of a form, the submission will be saved to the forms manager just like an off line form submission. - FlushSubmissionsOnline The value of this preference is a boolean, and the default value is false. When the value set to true, all pending form submissions will be submitted during any online request. Start and stop URLs for forms submissions ========================================= -Sync and online forms submissions will be bracketed by defining start and stop URLs Additional minor fixes ====================== - A non-functioning sample channel hyperlink has been removed. - An updated version of the M-Business Anywhere Administrator Guide is included in this release. ================================================================= 2 - WHAT'S NEW IN THIS RELEASE: SERVER FEATURES ================================================================= On-device memory fix for high volume client device synchronizaitons =================================================================== Implemented server-side fix for on-device-database memory issues involving high numbers of client device synchronizations. ================================================================= 3 - DOCUMENTATION ================================================================= 3.1 - Accessing Release Documentation: ====================================== Download site ------------- http://www.ianywhere.com/downloads/software/mbus_solaris.html - Provides access to all available documentation, plus sample code. 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. 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 M-Business 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 200MB disk space (Note: Disk space and RAM requirements vary according to user population.) - SPARC Ultra with CD-ROM drive Server Operating System ----------------------- Solaris 2.8 with the following patches: 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.7: =============================== M-Business Anywhere supports upgrading M-Business Server from versions 4.0, 4.1, 4.2, 5.0, 5.1, 5.2, 5.3 and 5.5 to version 5.7. 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 M-Business 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 - Reviewing install.log file ================================= Installer does npt create an install.log file during installation on this plaform. ================================================================= 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 iAnywhere Solutions. 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.