home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 February / CHIP_2_98.iso / doc / HOWTO / mini / StarOffice < prev    next >
Text File  |  1997-07-14  |  9KB  |  235 lines
  1.   StarOffice mini-HOWTO
  2.   Matthew Borowski, mkb@poboxes.com, http://www.jnpcs.com/mkb/linux
  3.   v0.7, July 7, 1997
  4.  
  5.   Information on installing the StarOffice Office Suite by StarDivision, GmbH.
  6.  
  7.   ------------------------------------------------------
  8.  
  9.   Table Of Contents:
  10.     1. Introduction
  11.      1.1 Motif info
  12.      1.2 History of this document
  13.     2. Obtaining the StarOffice suite   
  14.     3. Installation of StarOffice
  15.      3.1 Libc issues and fixes
  16.       3.1.1 Upgrading your libc
  17.      3.2 Installing from the tar files
  18.      3.3 Setup and configuration 
  19.      3.4 COL setup bug
  20.      3.5 Fixing the LANG variable problem
  21.     4. Running StarOffice
  22.     5. More Information
  23.     6. Contributions
  24.     7. Disclaimer and Copyright
  25.     
  26.   ------------------------------------------------------
  27.  
  28.   1.  Introduction
  29.   
  30.   The StarOffice Office Suite is a collection of office tools for Linux,
  31.   written in C using the Motif toolkit. StarOffice includes:
  32.   
  33.   - StarWriter, a word processor
  34.   - StarCalc, a spreadsheet
  35.   - StarImage, an image editor
  36.   - StarDraw, a draw program similar to Corel DRAW
  37.   - StarChart, a chart-making program
  38.   - StarMath, a math editor
  39.  
  40.   The StarOffice Office Suite for Linux is free for non-commercial use. 
  41.   Commercial use requires a license. The cost for a commercial license
  42.   seperate from Caldera's OpenLinux system is currently undecided.
  43.   
  44.   1.1  Motif info
  45.   
  46.   StarOffice is written using the commercial Motif 2.0 GUI toolkit. The
  47.   dynamically linked version will *not* work with Motif 1.2/LessTif.
  48.   
  49.   The static version (with Motif 2.0 linked in) will work regardless
  50.   of whether or not you have Motif. However, performance drops.
  51.   
  52.   I run StarOffice on a Pentium 100 with 48 megs RAM, running Redhat
  53.   4.1 and Motif 2.0. Dynamically linked StarOffice takes about a minute 
  54.   to load. However, it is noticable that, once it loads up, StarOffice
  55.   dynamically linked takes up much less resources than the static
  56.   version.
  57.   
  58.   1.2.  History of this document
  59.  
  60.   version 0.7 970707 - changed section 3.1.1, changed license
  61.   version 0.6 970609 - added fix for the LANG variable problem
  62.   version 0.5 970608 - updated info to StarOffice 3.1 final
  63.   version 0.1 970505 - the initial release.
  64.  
  65.   2.  Obtaining the StarOffice Office Suite
  66.  
  67.   The current release of StarOffice for Linux is 3.1 final. This
  68.   release is available for FTP at ftp://ftp.gwdg.de/pub/linux/staroffice
  69.   
  70.   The file README.StarOffice contains information on downloading
  71.   StarOffice 3.1 final. You will need to get three files: 
  72.   StarOffice31-english.tar.gz (english) or StarOffice31-german.tar.gz
  73.   (german) templates/demo docs, StarOffice31-dynbin (dynamically linked)
  74.   or StarOffice31-statbin.tar.gz (statically linked) binaries, and 
  75.   StarOffice31-common.tar.gz
  76.   
  77.   There is also version of StarOffice, available from Caldera. Check
  78.   there website at http://www.caldera.com/ for details on this. Caldera
  79.   also makes a StarOffice CD-ROM available for $7.99 US.
  80.   
  81.   3.  Installation of StarOffice
  82.   
  83.   Installation of StarOffice consists of:
  84.   - Untarring the distribution files as root in /usr/local
  85.   - running the setup program as a user
  86.   - sourcing the .sd.sh or .sd.csh
  87.   - reading section 3.5!!! (do this)
  88.   
  89.   3.1.  Libc Issues and Fixes
  90.   
  91.   StarOffice is linked with libc 5.4.4.
  92.   
  93.   StarOffice 3.1 *will* work on Libc 5.3.x. Unfortunately, the setup 
  94.   program requires 5.4.4 or higher. If you have libc 5.3.x, you might
  95.   be able to get around this by acquiring a copy of libc 5.4.4+ and 
  96.   adding it to your LD_LIBRARY_PATH environment variable before 
  97.   executing the setup script. I haven't tried this, however, so you're 
  98.   on your own.
  99.   
  100.   If you attempt to run the setup script on a libc older than 5.4.4,
  101.   you will get the following error message:
  102.   
  103.   line 1: Syntax error at token 'I' expected declarator;
  104.   i.e. File ...
  105.   
  106.   3.1.1  Upgrading your libc
  107.   
  108.   FTP to sunsite.unc.edu and look in the directory /pub/Linux/GCC for 
  109.   the file libc-5.4.33.bin.tar.gz (or whatever the latest libc is). 
  110.   Extract the contents of this file in a temporary directory. A new lib/ 
  111.   directory will be created. Su to root and copy the file libc.so.5.4.33 
  112.   from this directory to your /lib directory. Now, make the symlink from
  113.   libc.so.5 to 5.4.33 with the command:
  114.   
  115.   ln -sf /lib/libc.so.5.4.33 /lib/libc.so.5
  116.   
  117.   3.2.  Installing the tar Files
  118.   
  119.   After downloading StarOffice, su or login as root and place the 
  120.   archives in /usr/local/. Change directory to /usr/local/ and extract
  121.   the files. An example command to decompress a gzipped tar file
  122.   would be:
  123.   
  124.   tar -xzvf filename.tar
  125.   
  126.   Older systems may require you first use the gzip -d command to unzip
  127.   the file, then use the tar -xvf command to untar it.
  128.   
  129.   The files will extract to their locations within the newly created
  130.   /usr/local/StarOffice-3.1 tree.
  131.   
  132.   3.3  Setup and Configuration
  133.   
  134.   After you have extracted the StarOffice files as root, you will need 
  135.   to login with your userid. Change directory to /usr/local/StarOffice-3.1
  136.   and execute the setup program. This program will install non-shared 
  137.   files and symlinks needed for each individual user. The standard 
  138.   installation is recommended. There *could* be problems if you do not 
  139.   accept the default installation path.
  140.   
  141.   StarOffice makes use of environment variables. The files .sd.sh 
  142.   (formatted for the Bourne Shell) and .sd.csh (formatted for the C Shell) 
  143.   provide the environment variable settings for StarOffice. These files 
  144.   are located in your home directory.
  145.   
  146.   If you use bash, edit your .bashrc and add the line:
  147.   
  148.   source ~/.sd.sh
  149.   
  150.   After doing this, restart bash to bring the environment variables into
  151.   effect.
  152.   
  153.   If you use a different shell, consult that shell's man page for 
  154.   information on sourcing a file.
  155.   
  156.   3.4  COL (Caldera OpenLinux) setup bug
  157.  
  158.   Phil Reardon <pcr@busprod.com> says:
  159.  
  160.   "I found a bug in the setup script for StarOffice that came with my
  161.   Caldera COL standard release.   It produces // in a path where there
  162.   should only be one /.   To fix it, remove the first slash from this
  163.   line:
  164.  
  165.               exec ${pfad:='.'}/linux-x86/bin/$name;;
  166.  
  167.   There should be no / before linux-x86."
  168.   
  169.   3.5  Fixing the LANG variable problem
  170.  
  171.   The .sd.sh and .sd.csh files set the LANG variable. This causes 
  172.   problems with perl and man. Man will give the error message "Failed 
  173.   to open the message catalog man on the path NLSPATH=" Perl will 
  174.   give the error message "warning: setlocale(LC_CTYPE, "")..."
  175.  
  176.   The .sd.sh file contains a line that sets LANG=us and another
  177.   that exports a bunch of variables, including LANG.  Remove the LANG=us 
  178.   line and remove LANG from the list of variables, and this will be fixed.
  179.   
  180.   In the .sd.csh file (which is formatted for the c shell), you need
  181.   to remove the line that says "setenv LANG us".
  182.  
  183.   Thanks to Adam L. Klein <alklein@adelphia.net> for informing me of
  184.   this fix.
  185.  
  186.   4.  Running StarOffice
  187.   
  188.   The StarOffice binaries are located in the directory:
  189.   /usr/local/StarOffice-3.1/linux-x86/bin/
  190.   
  191.   The applications are: sdraw3, swriter3, scalc3, smath3, schart3, simage3
  192.   
  193.   The program svdaemon must be executed in order to use online help.
  194.   The program svportmap must be executed to enable application communication
  195.   features between StarWriter, StarCalc and StarDraw. 
  196.   
  197.   5.  More Information
  198.   
  199.   More information on StarOffice for Linux is available directly from
  200.   StarDivision. StarDivision maintains a website at 
  201.   http://www.stardivision.com/
  202.   
  203.   StarDivision runs a news server with support and user groups related
  204.   to StarOffice for linux. These newsgroups are the best place to find
  205.   up-to-date information on StarOffice and to ask for help. Using a
  206.   newsreader, connect to starnews.stardivision.com or follow the support
  207.   link on the StarDivision homepage.
  208.     
  209.   6.  Contributions
  210.  
  211.   If you can contribute any additional information for this mini-HOWTO, 
  212.   please contact me via internet e-mail. My address is located at the 
  213.   top of this document. You may also wish to take a look at my web 
  214.   page, located at http://mkb.home.ml.org/linux/ or 
  215.   http://www.jnpcs.com/mkb/linux/
  216.  
  217.   7. Disclaimer and Copyright
  218.   
  219.   This document is (C) 1997 by Matthew Borowski.
  220.   
  221.   Redistribution of this document in electronic form is permitted
  222.   under the condition that the document remains unchanged. If you
  223.   wish to include this document in a CD-ROM or book, please obtain
  224.   permission from me beforehand (I prefer requests to be sent via 
  225.   e-mail).
  226.   
  227.   The author claims no responsibility in anything that may occur directly 
  228.   or indirectly as a result of using this document. The author is not an 
  229.   employee of StarDivision, GmbH or Caldera, Inc.
  230.   
  231.   Comments and questions may be directed to the author at 
  232.   mkb@poboxes.com.
  233.  
  234.   <END>
  235.