-----------------------------------------------------------
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
-----------------------------------------------------------

StarOffice uses both the new glibc2 and the Linux-Kernel-Threads. It was tested with the versions libc-2.0.7.so and libthread-0.7.so (glibc-2.0.7-7-7.i386.rpm) Before beginning with the installation, check that the corresponding libraries are setup in your system.

Login as usual with your user ID and run the "setup" program from the /cdrom/linux/office51 directory. 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 (as user root). 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. 

------------------------------------------------------------
Do I  have to install the glibc2 Libraries ?
-------------------------------------------------------------

StarOffice uses the new glibc2 ( = libc6 ) in the 2.0.7 Version as well as the Linux Kernel Threads. Please check if your Linux system contains the appropiate libraries:

   ls -l /lib/ld-linux.so.2
   ls -l /lib/libc-2.*.so
   
The 'gldrinst force' mentioned in the following table is a command which can be executed within the installation script soprep.  Further information about installing glibc with soprep can be found below.

Linux         |   Based on       |  Installation of      |  'gldrinst force'
Distribution  |                  |  Glibc required       |   required
--------------+------------------+-----------------------+--------------------
RedHat 6.0    |   glibc          |   No                  |   No              
RedHat 5.1    |   glibc          |   No                  |   No              
RedHat 5.2    |   glibc          |   No                  |   No              
Delix DLD 6.0 |   glibc          |   No                  |   No              
Debian 2.0    |   glibc          |   No                  |   No              
Debian 1.3    |   libc5          |   Yes                 |   Yes
Caldera 2.2   |   glibc          |   No                  |   No
Caldera 1.2   |   libc5          |   Yes                 |   Yes
SuSE 6.1      |   glibc          |   No	                 |   No
SuSE 6.0      |   glibc          |   No                  |   No
SuSE 5.3      |   libc5          |   Yes                 |   Yes
SuSE 5.1      |   libc5          |   Yes                 |   Yes
Slackware 3.5 |   libc5          |   Yes                 |   Yes
Slackware 4.0 |   glibc          |   Yes	         |   No

In case these files can not be found, you must make these required libraries available to the StarOffice Setup and the StarOffice Program. Therefare, it is necessary to install the glibc2 libraries. You will find additional library installation information in the /linux/misc/glibc2 directory.

-----------------------------------------------------
Installation of glibc 2.0.7 Libraries
-----------------------------------------------------

StarOffice needs glibc 2.0.7 Libraries. In order to install StarOffice and to be able to work with it libraries need to be installed on your system.  If this is not the case you will find them in the file glibc.2.tar.gz in this directory on the installation CD. If this archive is not included in your installation record you can download it from our web server http://www.sun.com/staroffice. You can carry out the installation either automatically with Shell Script soprep or manually. We recommend using the Shell Scripts soprep which you will also find in this directory.

-----------------------------------------------------------
Installation via Shell Script soprep
-----------------------------------------------------------

Soprep is a Shell script which serves to prepare the StarOffice installation in a system which does not contain the glibc 2.0.7 libraries.

The glibc2 libraires can be installed most easily in the lib subdirectory of the expected StarOffice version. When installing your StarOffice, i.e., later on as /opt/office51 select, as directory for the glibc2 libraries, /opt/office51/lib.

Additionally, the relative ld-linux.so.2 dynamic loader will be installed in the /lib directory if this is not yet available.

NOTE: In systems in which another incompatible glibc2 version has already been installed, the ld-linux.so.2 dynamic loader must be changed in order to use the glibc2.0.7. This means a serious interference in the system which - in some cases - may cause the non-functionality of other programs using the glib2 version. Soprep recognizes this and aborts after a reference to a possible command which can be executed later on. Subsequently, with this command it is possible to force the installation of the loader.

1) Change to the directory containing the glibc2.tar.gz and soprep files.

2) Start a Bourne Shell with the command:

   /bin/sh

3) Enter the following command:

   . ./soprep

   The first dot must also be entered. In this way the script will be executed 
   in the current shell!

4) Follow the instructions and enter the destination path for the glibc2
   libraries. Example: /opt/office51/lib

5) If the soprep Program recognizes that ld-linux.so.2  dynamic link loader 
   already exists in an older version, it will be now possible to force the 
   installation of the loader by entering the following command:
   
   gldrinst force

6) After the installation of the glibc2 change to the directory with the 
   StarOffice installation files and execute the StarOffice Setup.

   ./setup

7) In you do NOT have selected the lib subdirectory of StarOffice as 
   destination directory for the glibc2, it is now necessary either to copy the 
   files there or to make available the glibc2.0.7 in your Linux System globally. 
   To carry out the last one, first enter the glibc2 path in the /etc/ld.so.conf 
   file and then start the ldconfig program.

-----------------------------------------------------------
Manual Installation
-----------------------------------------------------------

You can also install the glibc2 libraries manually. Go ahead in the following way:

1) Unpack the glibc2 libraries required, i.e., in the /tmp directory:
  
   cd /tmp
   tar zxvf glibc207.tar.gz

2) Remove a library loader (ld-linux.so.2) of a possibly still existing older 
   glibc2 version

   NOTE: the warning mentioned above in the installation via Shell Script 
         applies also here!             

   rm -f /lib/ld-linux.so.2

3) Copy as root the runtime Linker in the /lib directory

   cp /tmp/glibc2/ld-linux.so.2 /lib/ld-linux.so.2

4) Enter the path to the libraries in your LD_LIBRARY_PATH:

   export LD_LIBRARY_PATH=/tmp/glibc2:$LD_LIBRARY_PATH    for sh,bash
   setenv LD_LIBRARY_PATH /tmp/glibc2:$LD_LIBRARY_PATH    for csh,tcsh

5) Execute the StarOffice setup in the directory containing the installation 
   files: 

   ./setup

6) After the StarOffice installation has successfully occurred, please copy 
   the glibc2 libraries in the lib directory of your installation, i.e.,

   cp -d /tmp/glibc2/* /home/myuser/office51/lib

7) Delete the temporary files:
   
   rm /tmp/glibc2/*
   rmdir /tmp/glibc2

-----------------------------------------------------------
"Library GNU Public License"
-----------------------------------------------------------

The glibc 2.0.7 Libraries belong to the "Library GNU Public License" (LGPL).
You will find the sources of these Libraries under:

ftp://ftp.gnu.org/pub/gnu

-----------------------------------------------------------
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
-----------------------------------------------------------

In order to avoid that the X-Server freezes -in case you use a Xfree S3Virge driver- it is necessary to carry out a further step: to set the environment variable SAL_DO_NOT_USE_INVERT50 with the following syntax with the value «true»: 

Using a Bourne-Shell (e.g. bash):

    export SAL_DO_NOT_USE_INVERT50=true

Using a C-Shell:

    setenv  SAL_DO_NOT_USE_INVERT50 true

IMPORTANT NOTE:

Using the mentioned environment variable might cause various window elements being displayed inverted. In general we recommend using the related SVGA-Driver, because the Xfree S3Virge driver may originate X-Server problems even with any other program. With the SVGA-Driver it is unnecessary to set the environment variable.

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 it is more probable that 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, they should be solved by the Support.

-----------------------------------------------------------
StarOffice and Java in Linux
-----------------------------------------------------------

For Java, StarOffice requires a JVM (Java Virtual Machine) with "native Threads" and a complete JNI (Java Native Interface) connection. Meanwhile, ports of the JVM and the JNI are available for for Linux. However, a few adaptations need to be made prior to be able to use the Java support for StarOffice. You can find the respective information in the parent directory or in the rooot of the download directory.

For this reason at this point the Java console which is situated in the start menu and explorer in bookmarks/java will only function after you have made Java available for StarOffice.

-----------------------------------------------------------
Java for StarOffice under Linux Information
-----------------------------------------------------------

In StarOffice for Linux, it is now possible to use Java and JavaScript (internally runs under Java). Now with the new Java Lib in StarOffice, it is possible to support the required native threads for the glibc2. The Java version 1.1.7v3, however, is the exception and in its place you should use one of the following versions; jre-1.1.5v1a, rt-1.1.7v1a or jdk-1.1.7v1a. These all cover the "native threads support" required for StarOffice. These corresponding files can all be downloaded from http://www.blackdown.org.

To activate these new capabilities, the soffice start file must be edited within the StarOffice files. This can be found in a single-user installation in the office51/bin directory, and in the corresponding directory on the server with a network installation. In a network installation, only the user "root" has the right to edit this file. Also in StarOffice, you must activate Java under "Tools - Options - Browser - Other" and JavaScript under "Tools - Options - Browser - Scripting".

Java for StarOffice under Linux StarOffice for Linux uses the glibc native threads. These are available for the first time in the Java Library. The glibc native threads also support the required Java Native Interface (JNI).

Requirements:
The Java installation for glibc2 native threads can be taken from: 
   http:\\www.blackdown.org\java-linux.html

Select and load one of the three following packs, each of the packs containing two archive files. Please read each corresponding Readme file carefully! Closely following the Readme file instructions, install the archives in numerical order.

Java Runtime Environment
   1. jre_1.1.7-vla-glibc-x86.tar.gz
   2. jre_1.1.7-vla-glibc-x86-native.tar.gz
   
or the minimal Java Runtime Environment
   1. rt_1.1.7-vla-glibc-x86.tar.gz
   2. rt_1.1.7-vla-glibc-x86-native.tar.gz
   
or the Java Development Kit
   1. jdk_1.1.7-vla-glibc-x86.tar.gz
   2. jdk_1.1.7-vla-glibc-x86-native.tar.gz
   
Problems when using jdk:
The ../lib/classes.zip classes can not be read with the jdk117_v1a. The associated jar program can assist in packing and unpacking the classes. Also for installing the Development Kits in the /usr/jdk117_v1a directory:

   cd /usr/jdk117_v1a/lib
   unzip classes.zip
   mv classes.zip classes_old.zip
   /usr/jdk117_v1a/bin/jar -cvf classes.zip java sun sunw
   rm -r java sun sunw
   
It is not sufficient to only unpack the classes! The rt.jar jile from the rt117 or jre117 pack lib subdirectory can be used as an alternative.

The Java Installations based on the jre117 and the rt117 packs run without alterations.

-----------------------------------------------------------
Integration in the Window Manager
-----------------------------------------------------------

The StarOffice setup offers you the KDE integration possibility. This enables, among others, the installation of the icons for the StarOffice setup and program. If you work with another Window Manager, in the StarOffice directory you will find two icon files in the XPM format (L_soffice.xpm and S_soffice.xpm) which can be used (according to the instructions contained in your Window Manager documentation) in order to place an icon on the user interface to start StarOffice.

-----------------------------------------------------------
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 !
