home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 August / PCWorld_1999-08_cd.bin / doc / HOWTO / mini / StarOffice < prev    next >
Text File  |  1998-07-03  |  12KB  |  463 lines
  1.   StarOffice 3.1 Mini-HOWTO
  2.   Matthew Borowski (mkb@poboxes.com )
  3.   v1.0, 2 June 1998
  4.  
  5.   Information on installing the StarOffice 3.1 Office Suite by StarDivi¡
  6.   sion.
  7.   ______________________________________________________________________
  8.  
  9.   Table of Contents
  10.  
  11.  
  12.   1. Introduction
  13.  
  14.      1.1 Motif info
  15.      1.2 History of this document
  16.  
  17.   2. Obtaining the StarOffice Office Suite
  18.  
  19.   3. Installation of
  20.  
  21.      3.1 Libc Issues and Fixes
  22.      3.2 Installing the tar Files
  23.      3.3 Setup und Configuration
  24.      3.4 COL (Caldera OpenLinux) setup bug
  25.      3.5 Fixing the LANG variable problem
  26.  
  27.   4. Running StarOffice
  28.  
  29.   5. StarOffice Tips
  30.  
  31.   6. More Information
  32.  
  33.   7. Contributions
  34.  
  35.   8. Disclaimer and Copyright
  36.  
  37.  
  38.  
  39.   ______________________________________________________________________
  40.  
  41.   1.  Introduction
  42.  
  43.   This document deals with installing StarOffice 3.1. The current
  44.   version of StarOffice is 4.0. Version 4.0 is considerably easier to
  45.   install and less buggy than version 3.1. In fact, in my opinion there
  46.   is no need for a HOWTO for version 4.0, since StarDivision has written
  47.   a fairly complete installation guide. The StarOffice mini-HOWTO was
  48.   useful while it lasted, but it is now being archived only for the few
  49.   who still wish to install StarOffice 3.1. For information about
  50.   StarOffice 4.0, check out my website at
  51.   http://mkb.home.ml.org/linux/sohowto.html.
  52.  
  53.  
  54.  
  55.   The StarOffice Office Suite is a collection of office tools for Linux,
  56.   written in C using the Motif toolkit.
  57.  
  58.   StarOffice includes:
  59.  
  60.   ╖  StarWriter, a word processor
  61.  
  62.   ╖  StarCalc, a spreadsheet
  63.  
  64.   ╖  StarImage, an image editor
  65.  
  66.  
  67.   ╖  StarDraw, a draw program similar to Corel DRAW
  68.  
  69.   ╖  StarChart, a chart-making program
  70.  
  71.   ╖  StarMath, a math editor
  72.  
  73.   The StarOffice Office Suite for Linux is free for non-commercial use.
  74.   Commercial use requires a license. The cost for a commercial license
  75.   seperate from Caldera's OpenLinux system is currently undecided.
  76.  
  77.  
  78.   1.1.  Motif info
  79.  
  80.   StarOffice is written using the commercial Motif 2.0 GUI toolkit. The
  81.   dynamically linked version will *not* work with Motif 1.2/LessTif.
  82.  
  83.   The static version (with Motif 2.0 linked in) will work regardless of
  84.   whether or not you have Motif. However, performance drops.
  85.  
  86.   I run StarOffice on a Pentium 100 with 48 megs RAM, running Redhat 4.1
  87.   and Motif 2.0. Dynamically linked StarOffice takes about a minute to
  88.   load. However, it is noticable that, once it loads up, StarOffice
  89.   dynamically linked takes up much less resources than the static
  90.   version.
  91.  
  92.  
  93.   1.2.  History of this document
  94.  
  95.  
  96.   ╖  Version 1.0 980602 - added information on StarOffice 4.0 and about
  97.      how this document is now outdated
  98.  
  99.   ╖  Version 0.8 971109 - added tips, installation w/o libc upgrade,
  100.      etc.
  101.  
  102.   ╖  Version 0.7 970707 - changed section 3.1.1, changed license
  103.  
  104.   ╖  Version 0.6 970609 - added fix for the LANG variable problem
  105.  
  106.   ╖  Version 0.5 970608 - updated info to StarOffice 3.1 final
  107.  
  108.   ╖  Version 0.1 970505 - the initial release.
  109.  
  110.  
  111.   2.  Obtaining the StarOffice Office Suite
  112.  
  113.   The current release of StarOffice for Linux is 3.1 final. This release
  114.   is available for FTP at
  115.  
  116.        ftp://ftp.gwdg.de/pub/linux/staroffice
  117.  
  118.  
  119.   The file README.StarOffice contains information on downloading
  120.   StarOffice 3.1 final. You will need to get three files:
  121.  
  122.  
  123.   ╖  StarOffice31-english.tar.gz (english) templates/demo docs or
  124.  
  125.   ╖  StarOffice31-german.tar.gz (german) templates/demo docs
  126.  
  127.   ╖  StarOffice31-dynbin.tar.tgz (dynamically linked) or
  128.  
  129.   ╖  StarOffice31-statbin.tar.gz (statically linked) binaries
  130.  
  131.   ╖  StarOffice31-common.tar.gz
  132.  
  133.   There is also version of StarOffice, available from Caldera. Check
  134.   their website at
  135.  
  136.        http://www.caldera.com
  137.  
  138.   for details on this. Caldera also makes a StarOffice CD-ROM available
  139.   for $ 7.99 US.
  140.  
  141.  
  142.   3.  Installation of StarOffice
  143.  
  144.   Installation of StarOffice consists of:
  145.  
  146.   ╖  Untarring the distribution files as root in /usr/local
  147.  
  148.   ╖  running the setup program as a user
  149.  
  150.   ╖  sourcing the .sd.sh or .sd.csh
  151.  
  152.   ╖  reading section 3.5!!! (do this)
  153.  
  154.  
  155.   3.1.  Libc Issues and Fixes
  156.  
  157.   StarOffice is linked with libc 5.4.4.
  158.  
  159.   StarOffice 3.1 *will* work on Libc 5.3.x. Unfortunately, the setup
  160.   program requires 5.4.4 or higher. If you have libc 5.3.x, you might be
  161.   able to get around this by acquiring a copy of libc 5.4.4+ and adding
  162.   it to your LD_LIBRARY_PATH environment variable before executing the
  163.   setup script. I haven't tried this, however, so you're on your own.
  164.  
  165.   If you attempt to run the setup script on a libc older than 5.4.4, you
  166.   will get the following error message:
  167.  
  168.  
  169.        line 1: Syntax error at token 'I' expected declarator; i.e. File ...
  170.  
  171.  
  172.  
  173.   To upgrade your libc, FTP to sunsite.unc.edu and look in the directory
  174.   /pub/Linux/GCC for the file libc-5.4.33.bin.tar.gz (or whatever the
  175.   latest libc is). Extract the contents of this file in a temporary
  176.   directory. A new lib/ directory will be created. Su to root and copy
  177.   the file libc.so.5.4.33 from this directory to your /lib directory.
  178.   Now, make the symlink from libc.so.5 to libc.5.4.33 with the command:
  179.  
  180.  
  181.        ln -sf /lib/libc.so.5.4.33 /lib/libc.so.5
  182.  
  183.   then run the ldconfig command.
  184.  
  185.  
  186.   Dr. Romano Giannetti (romano@iet.unipi.it ) says:
  187.  
  188.  
  189.  
  190.        ...I want only to add that I could install (like you
  191.        suggested) StarWriter in a redhat 4.2 system which has a
  192.        libc5.3, without doing the upgrade.
  193.  
  194.  
  195.        The exact steps are:
  196.  
  197.  
  198.  
  199.   1. get a libc.so.5.4.x. If you have a redhat rpm package (as
  200.   the one you find in the contrib directory), you can extract
  201.   the library by going in a scratch directory and doing:
  202.   rpm2cpio libc.so.5.4.x-y.rpm | cpio --extract --make-
  203.   directories The library will appear in ./lib subdirectory
  204.  
  205.  
  206.   2. move libc.so.5.4.x in your home directory. Then (assuming
  207.   a sh-like shell): ln -s libc.so.5.4.x libc.so.5 export
  208.   LD_LIBRARY_PATH=$HOME:/lib:/usr/lib
  209.  
  210.  
  211.   3. Now you can run setup.
  212.  
  213.  
  214.  
  215.   3.2.  Installing the tar Files
  216.  
  217.   After downloading StarOffice, su or login as root and place the
  218.   archives in /usr/local/. Change directory to /usr/local/ and extract
  219.   the files. An example command to decompress a gzipped tar file would
  220.   be:
  221.  
  222.  
  223.        tar -xzvf filename.tar
  224.  
  225.  
  226.   Older systems may require you first use the gzip -d command to unzip
  227.   the file, then use the tar -xvf command to untar it.
  228.  
  229.   The files will extract to their locations within the newly created
  230.   usr/local/StarOffice-3.1 tree.
  231.  
  232.  
  233.   3.3.  Setup und Configuration
  234.  
  235.   After you have extracted the StarOffice files as root, you will need
  236.   to login with your userid. Change directory to
  237.   /usr/local/StarOffice-3.1 and execute the setup program. This program
  238.   will install non-shared files and symlinks needed for each individual
  239.   user. The standard installation is recommended. There *could* be
  240.   problems if you do not accept the default installation path.
  241.  
  242.   StarOffice makes use of environment variables. The files .sd.sh
  243.   (formatted for the Bourne Shell) and .sd.csh (formatted for the C
  244.   Shell) provide the environment variable settings for StarOffice. These
  245.   files are located in your home directory.
  246.  
  247.   If you use bash, edit your .bashrc and add the line:
  248.  
  249.        source  /.sd.sh
  250.  
  251.  
  252.   After doing this, restart bash to bring the environment variables into
  253.   effect.
  254.  
  255.   If you use a different shell, consult that shell's man page for
  256.   information on sourcing a file.
  257.  
  258.  
  259.   3.4.  COL (Caldera OpenLinux) setup bug
  260.  
  261.   Phil Reardon (pcr@busprod.com ) says:
  262.  
  263.        " I found a bug in the setup script for StarOffice that came
  264.        with my Caldera COL standard release. It produces // in a
  265.   path where there should only be one /. To fix it, remove the
  266.   first slash from this line:
  267.  
  268.        exec ${pfad:='.'}/linux-x86/bin/$name;;
  269.  
  270.  
  271.   There should be no / before linux-x86."
  272.  
  273.  
  274.   3.5.  Fixing the LANG variable problem
  275.  
  276.   The .sd.sh and .sd.csh files set the LANG variable. This causes
  277.   problems with perl and man. Man will give the error message
  278.  
  279.  
  280.        " Failed to open the message catalog man on the path
  281.        NLSPATH="
  282.  
  283.   Perl will give the error message
  284.  
  285.        " warning: setlocale(LC_CTYPE, "")..."
  286.  
  287.  
  288.   The .sd.sh file contains a line that sets LANG=us and another that
  289.   exports a bunch of variables, including LANG. Remove the LANG=us line
  290.   and remove LANG from the list of variables, and this will be fixed.
  291.  
  292.   In the .sd.csh file (which is formatted for the c shell), you need to
  293.   remove the line that says "setenv LANG us".
  294.  
  295.   Thanks to Adam L. Klein (alklein@adelphia.net) for informing me of
  296.   this fix.
  297.  
  298.  
  299.   4.  Running StarOffice
  300.  
  301.   The StarOffice binaries are located in the directory:
  302.   /usr/local/StarOffice-3.1/linux-x86/bin/
  303.  
  304.   The applications are: sdraw3, swriter3, scalc3, smath3, schart3,
  305.   simage3
  306.  
  307.   The program svdaemon must be executed in order to use online help.
  308.   The program svportmap must be executed to enable application
  309.   communication features between StarWriter, StarCalc and StarDraw.
  310.  
  311.  
  312.   5.  StarOffice Tips
  313.  
  314.   Contributed by Patrick D'Cruze (pdcruze@netpal.com.au)
  315.  
  316.  
  317.   1.  Instead of sourcing the .sd.sh (or .sd.csh) file in my
  318.   .bash_profile script, I instead copied the .sd.sh script,  renamed it
  319.   to swriter and copied it to /usr/local/bin.  I then modified it by
  320.   adding a:
  321.  
  322.        #! /bin/bash
  323.  
  324.  
  325.   at the start of the script and a:
  326.  
  327.        exec swriter3 $*
  328.  
  329.  
  330.  
  331.   at the end of the script.  Now all I have to do is run swriter and it
  332.   automatically sets up the appropriate environment variables and then
  333.   runs StarWriter. Saves having those environment variables pollute
  334.   other applications/environments.
  335.  
  336.  
  337.   2.  I noticed that for a lot of people, StarOffice takes quite a while
  338.   to load (upwards of 60 seconds).  The consensus on usenet was that a
  339.   large chunk of this time was due to the symbol relocations that the
  340.   dynamic linker has to do. ie, for each new symbol the dynamic linker
  341.   has to locate the appropriate library.  StarOffice dynamically links
  342.   against quite a few libraries so the dynamic linker spends quite a bit
  343.   of time searching through lots of libraries.
  344.  
  345.  
  346.   There is a solution to this. I run StarOffice in a chroot'd jail.  In
  347.   the jail, I just put the binaries and libraries that StarOffice uses
  348.   (all the libs out of /usr/X11R6/lib, libc/libm and libg++/libstdc++).
  349.   StarWriter takes approximately 15 seconds to come up on my P133/32MB.
  350.   This is due to the fact that the only libraries present are the ones
  351.   needed by StarOffice and hence the dynamic linker spends
  352.   proportionately less time searching through all the libraries on the
  353.   system (ie, it doesn't search through all the useless libs in /usr/lib
  354.   etc looking to resolve symbols).
  355.  
  356.  
  357.   6.  More Information
  358.  
  359.   More information on StarOffice for Linux is available directly from
  360.   StarDivision. StarDivision maintains a website at
  361.   http://www.stardivision.com
  362.  
  363.   StarDivision runs a news server with support and user groups related
  364.   to StarOffice for linux. These newsgroups are the best place to find
  365.   up-to-date information on StarOffice and to ask for help. Using a
  366.   newsreader, connect to news://starnews.stardivision.com or follow the
  367.   support link on the StarDivision homepage.
  368.  
  369.  
  370.   7.  Contributions
  371.  
  372.   Thank you to Werner Klaus (wklaus@metronet.de ) for translating this
  373.   document to sgml.
  374.  
  375.   If you can contribute any additional information for this mini-HOWTO,
  376.   please contact me via internet e-mail. My address is located at the
  377.   top of this document. You may also wish to take a look at my web page,
  378.   located at http://mkb.home.ml.org/linux/ or
  379.   http://www.gslink.com/~mkb/linux/
  380.  
  381.  
  382.   8.  Disclaimer and Copyright
  383.  
  384.   This document is (C) 1997 by Matthew Borowski.
  385.  
  386.   Redistribution of this document in electronic form is permitted under
  387.   the condition that the document remains unchanged. If you wish to
  388.   include this document in a CD-ROM or book, please obtain permission
  389.   from me beforehand (I prefer requests to be sent via e-mail).
  390.  
  391.  
  392.   The author claims no responsibility in anything that may occur
  393.   directly or indirectly as a result of using this document. The author
  394.   is not an employee of StarDivision, GmbH or Caldera, Inc.
  395.  
  396.  
  397.   Comments and questions may be directed to the author at
  398.   mkb@poboxes.com.
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.