----------------------------------------------------------- StarOffice 5.1a ----------------------------------------------------------- Dear User: This file contains important program information. Please read these tips through carefully, before beginning to work with StarOffice 5.1! ----------------------------------------------------------- Tips for Successful Installation ----------------------------------------------------------- Login as usual with your user identification and run the "setup" program from the directory /cdrom/solaris/office51. Select the type of installation and an installation directory. You must have write-access to the installation directory. To carry out a network installation (multi-user installation), please start the setup with the /net option. After the network installation, it is necessary that each user who wants to work with StarOffice runs the setup from the bin directory of the network installation with the own user ID (WITHOUT/net). A workstation installation will be then available. This installs per user approximately 2 MB of data in the corresponding Home directory. A multi-user installation is only permitted with the respective number of licenses. ----------------------------------------------------------- Starting StarOffice ----------------------------------------------------------- StarOffice 5.1 is started by executing the "soffice" script, found in the subdirectory "bin" in the installation directory (e.g., "/home/joe/Office51/bin"). It is advisable to include the StarOffice "bin" directory in your path. ----------------------------------------------------------- Tip: Printing with StarOffice ----------------------------------------------------------- When printing with StarOffice you might encounter problems because of very big XPRINTER spool files. The cause is that StarOffice is not notified when a print job is done. Therefore, temporary print files will not be deleted. To avoid this problem, with the STAR_SPOOL_DIR environment variable you can specify a directory where the spool files can be stored: Using a Bourne-Shell (e.g. bash): export STAR_SPOOL_DIR=/tmp Using a C-Shell: setenv STAR_SPOOL_DIR /tmp ----------------------------------------------------------- Problems of the X-server installation ----------------------------------------------------------- An error message like "SalFontStruct::Load !XLoadQueryFont()" means that a font, that should exist on the X-server, could not be loaded. This might be a memory problem, but more likely the font has not been installed or is not installed any more. This can be verified with the commands xlsfonts, xfontsel and xfd. Any other error messages may be caused by a lack of memory of the X-server. Should those errors occur together with other errors in StarOffice even after rebooting the system, you should use the available support options. ----------------------------------------------------------- File locking ----------------------------------------------------------- In StarOffice file locking is disabled by default. The environment variable STAR_ENABLE_FILE_LOCKING enables you to switch on locking for NFS-mounted directories (e.g. setenv STAR_ENABLE_FILE_LOCKING 1). Please note: we are aware of problems with Solaris Sparc 2.5.1 and 2.7 in connection with Linux NFS 2.0. If this applies to your system environment, we strongly recommend not switching on locking for NFS-mounted directories. Otherwise, StarOffice might hang when trying to open a file on a NFS partition mounted from a Linux machine. In addition to setting the environment variable STAR_ENABLE_FILE_LOCKING, you should take a further step. Either you need to set the environment variable STAR_PROFILE_LOCKING_DISABLED. (Another way would be to remove the respective comment signs from the soffice and setup script files in the /bin directory.) Or you should set or mount the respective file system with the option "-o llock". (It is also possible to add this option to your mount configuration file /etc/vfstab.) ----------------------------------------------------------- Java Configuration in StarOffice ----------------------------------------------------------- In StarOffice, you have the possibility to reset the applied Java Runtime Environment at any time. To do so, complete the following steps: 1. In the Bookmarks folder, open the "StarOffice Bookmarks/Java/Java Setup" entry. A dialog will appear where you can select a Java Environment. 2. Close StarOffice, otherwise it will overwrite the new entries. 3. Select the Java Environment that StarOffice should use. 4. Close the dialog. 5. The new settings will be applied the next time you start StarOffice. It is also possible to complete these steps manually: 1. Close StarOffice, otherwise it will overwrite the new entries. 2. Open the soffice.ini file (Win32 and OS/2) or sofficerc (under UNIX) in a Text Editor Office directory. 3. Edit the Java section. In all entries, pay attention to all upper and lower case spellings and platform dependencies. Example for a Java section for UNIX: [Java] Java=1 RuntimeLib=/usr/local/jre1.1.7/lib/i386/native_threads/libjava.so SystemClasspath=/usr/local/jdk1.1.7/lib/classes.zip Definition: Java= Switchs the Java Support on (1) or off (0). RuntimeLib= Labels the Java DLL to be applied (with path). This DLL must contain all JNI functions necessary to initialize und start a Java Interpreter. SystemClasspath= Determine the search path for all Java classes necessary to start the Java Environment (for example: classes.zip, rt.jar or r18i.jar). Classes that do not belong to the Runtime Environment should be listed in the UserClasspath. 4. Save the modified INI file 5. The new settings will be applied the next time you start StarOffice. IMPORTANT : It is necessary to close StarOffice before saving all adjusted settings. If not, all changes will be lost. ------------------------------------------------------------ Personalizing StarOffice / Mail & News ------------------------------------------------------------ To use the mail and news functions in StarOffice, enter your name and e-mail address in the dialog under Tools/Options/General. To get the most out of the provided templates for letters, faxes, etc., complete the user data. This information is only for your personal use, and you can specify if the program should use it or not. The dialog for entering your personal data is displayed during the installation. IMPORTANT : Your name and e-mail address are automatically included in the header information of an e-mail. Remember that if no e-mail address is specified, you will not be able to send any mail. ----------------------------------------------------------- Address Book Conversion ----------------------------------------------------------- To transfer an address book from StarOffice 4.0, simply copy the address.dbf file from the StarOffice 4.0 DATABASE folder into the StarOffice 5.1 DATABASE folder. Then, select the menu command Edit - Address Book. The address book will be automatically converted. If an error message appears when activating the address book, the address.dbf file might still be open. Before the conversion, make sure that no dialogs relating to database functionality are open. In the case of an error message, restart StarOffice 5.1 and select Edit - Address Book again. ----------------------------------------------------------- Using Info-ZIP ----------------------------------------------------------- The installation program incorporates compression code from the Info-ZIP group. There are no extra charges or costs due to the use of this code, and the original compression sources are freely available on the Internet from http://www.cdrom.com/pub/infozip/ ftp://ftp.cdrom.com/pub/infozip/ ----------------------------------------------------------- StarOffice Help / User's Guide ----------------------------------------------------------- It may be possible that changes were made to parts of applications in the program after the User's Guide went to press. In any case, you can find the most up-to-date information in the StarOffice Help. ----------------------------------------------------------- Customer Support ----------------------------------------------------------- The recent acquisition of Star Division Corporation by Sun Microsystems, Inc. has brought some changes to the way support is being handled. At the time we printed this message, some of the details were still unknown. However, if you were formerly supported by Star Division GmbH, you can continue to contact them using the previously supplied information. If you were formerly supported by Star Division Corporation, you can call their number in the United States. For our new customers, please examine the web pages at http://www.sun.com/staroffice for updated information and new service offerings from Sun Microsystems. We hope you enjoy working with your new StarOffice !