Difference between revisions of "Documentation/Administration Guide/Linux"

From Apache OpenOffice Wiki
Jump to: navigation, search
(New page: {{Documentation/AdminGuideTOC/v2 |OS_type=block |ShowPrevNext=block |ShowPrevPage=none |NextPage=Documentation/Administration Guide/Using Custom Macros and Libraries }} {{DISPLAYTITLE:Linu...)
 
 
(62 intermediate revisions by 4 users not shown)
Line 2: Line 2:
 
|OS_type=block
 
|OS_type=block
 
|ShowPrevNext=block
 
|ShowPrevNext=block
|ShowPrevPage=none
+
|ShowPrevPage=block
|NextPage=Documentation/Administration Guide/Using Custom Macros and Libraries
+
|PrevPage=Documentation/Administration Guide/Solaris
}}
+
|NextPage=Documentation/Administration Guide/Windows
 +
}}  
 
{{DISPLAYTITLE:Linux x86}}
 
{{DISPLAYTITLE:Linux x86}}
<!--
+
__NOTOC__
== RPM Based (SUSE, RedHat, etc) ==
+
== RPM Based Linux distributions ==
The StarOffice setup uses RPM packages with a Java based front end. The [http://docs.sun.com/app/docs/doc/817-7351?a=load StarOffice 8 Getting Started Guide] describes the usage of the Java front end.
+
  
RPM package manager has powerful command line interface to install, update and remove RPM packages. The RPM manager has to be provided by the Linux distribution which is the case for Suse and Red Hat but not for Debian. Debian has to convert the RPM packages, which is described in the Debian section of this document.
+
The RPM package manager is a powerful tool you can use to deploy software packages both locally and throughout a network.
  
=== Installation ===
+
{{Note|These instructions assume you have downloaded and extracted the {{OOo}} installation files.}}
All RPM packages are located in the RPMS directory of the installation CD.  
+
  
Users of the download installation set has to unpack the package first. The easiest way to accomplish this is to execute the StarOffice installation file.  
+
=== Install ===
 +
<ol>
 +
<li>Become root if necessary
 +
<syntaxhighlight lang="text">
 +
su -
 +
</syntaxhighlight></li>
 +
<li>Change directory to:
 +
<syntaxhighlight lang="text">
 +
<OpenOffice.org_unzip-dir>/RPMS
 +
</syntaxhighlight></li>
 +
<li>The RPMS directory contains RPM packages for {{AOo}} as well as Gnome and KDE integration.
 +
* For users with KDE, you can remove the Gnome integration RPM:
 +
<syntaxhighlight lang="text">
 +
rm openoffice.org-gnome-integration-<version>.rpm
 +
</syntaxhighlight>
 +
* For users with Gnome, you can remove the KDE integration RPM:
 +
<syntaxhighlight lang="text">
 +
rm openoffice.org-kde-integration-<version>.rpm
 +
</syntaxhighlight></li>
 +
<li>Install into the standard <tt>/opt</tt> directory
 +
<syntaxhighlight lang="text">
 +
rpm -ivh *.rpm
 +
</syntaxhighlight>
 +
{{Note|If you prefer to install {{AOo}} in a different location, use the <tt>-prefix</tt> option.
 +
  rpm -ivh –prefix <install-dir> *.rpm}}
 +
</li>
 +
<li>To install the {{OOo}} in the menus:
 +
<syntaxhighlight lang="text">
 +
cd desktop-integration
 +
</syntaxhighlight>
 +
Find the RPM for your specific Linux distribution and install it:
 +
<syntaxhighlight lang="text">
 +
rpm -ivh openoffice.org-<distribution>-menus_<version>.rpm
 +
</syntaxhighlight></li>
 +
</ol>
  
* Become root if necessary
+
You can safely delete the {{AOo}} installation packages after the install is complete.
  
su -
+
=== Uninstall ===
{{Documentation/Note|The following steps are not necessary for download installation sets which are newer than June 2006. Those providing a new parameter -x to extract the packages.
+
Do not delete the {{AOo}} files from the file system. You must use either the {{AOo}} Java setup or the RPM package manager to uninstall {{AOo}}.
 +
<ol>
 +
<li>Become root if necessary
 +
<syntaxhighlight lang="text">
 +
su -
 +
</syntaxhighlight></li>
 +
<li>Create a file 'ooo_packages' with all {{AOo}} related RPM packages
 +
<syntaxhighlight lang="text">
 +
rpm -qa | grep openoffice > ooo_packages
 +
</syntaxhighlight></li>
 +
<li>Check the content of this file carefully. All packages in this list will be removed.  This list does not include the JRE package that was installed if you used the {{AOo}} installation set that includes JRE.</li>
 +
<li>To remove all {{AOo}} related packages:
 +
<syntaxhighlight lang="text">
 +
rpm -e 'cat ooo_packages'
 +
</syntaxhighlight></li></ol>
  
The command line for those installations sets looks like this :
+
== DEB Based Linux Distributions ==
 +
The APT or DPKG package manager is a powerful tool you can use to install, update and remove DEB packages, and is provided as part of some Linux distributions such as Debian and Ubuntu.
  
./so8-bin-linux-en-US_<Optional languages>.sh -x
+
{{Note | If you have the RPM package and do not want to download the DEB package, you can convert the RPM files to DEB files using the following command:
  
Skip the rest of the steps below}}
+
    sudo alien -d --scripts *.rpm }}
  
* Execute the installation package
+
{{Note|There are installation scripts written that may be useful for experienced users. For more information see the following:
 +
http://installation.openoffice.org/source/browse/installation/setup_native/scripts/}}
  
<nowiki>./so8-bin-linux-en-US_<Optional languages>.sh</nowiki>
+
=== Install ===
 +
<ol>
 +
<li>Become root if necessary
 +
<syntaxhighlight lang="text">
 +
su -
 +
</syntaxhighlight></li>
 +
<li>Change directory to:
 +
<syntaxhighlight lang="text">
 +
<OpenOffice.org_unzip-dir>/DEBS
 +
</syntaxhighlight></li>
 +
<li>The DEBS directory contains DEB packages for OpenOffice.org as well as Gnome and KDE integration.
 +
* For users with KDE, you can remove the Gnome integration DEB:
 +
<syntaxhighlight lang="text">
 +
rm openoffice.org-gnome-integration-<version>.deb
 +
</syntaxhighlight>
 +
* For users with Gnome, you can remove the KDE integration DEB:
 +
<syntaxhighlight lang="text">
 +
rm openoffice.org-kde-integration-<version>.deb
 +
</syntaxhighlight></li>
 +
<li>Install into the standard <tt>/opt</tt> directory
 +
<syntaxhighlight lang="text">
 +
dpkg -i *.deb
 +
</syntaxhighlight>
 +
{{Note|If you prefer to install {{AOo}} in a different location, use the <tt><nowiki>--instdir=<directory></nowiki></tt> option.
 +
<syntaxhighlight lang="text">
 +
dpkg -i --installdir=<install-dir> *.deb
 +
</syntaxhighlight>}}</li>
 +
<li>To install the {{AOo}} in the menus:
 +
<syntaxhighlight lang="text">
 +
cd desktop-integration
 +
dpkg -i openoffice.org-debian-menus_<version>.deb
 +
</syntaxhighlight></li>
 +
</ol>
  
* Following error message appears most likely
+
You can safely delete the {{AOo}} installation packages after the install is complete.
  
The Installation Wizard can't run in GUI mode.
+
=== Uninstall ===
Maybe the DISPLAY environment variable isn't set correctly.
+
Do not delete the {{AOo}} files from the file system. You must use either the {{AOo}} Java setup or the DEB package manager to uninstall {{AOo}}.
 
+
<ol>
* Due to the fact that we do not need the graphical installer we could leave this error message. In those cases where the graphic setup appears do not continue to install StarOffice but leave the installation dialog open.
+
<li>Become root if necessary
 
+
<syntaxhighlight lang="text">
* You will find the RPM packages in following directory :
+
su -
 
+
</syntaxhighlight></li>
/var/tmp/unpack_staroffice/RPMS
+
<li>To remove all {{OOo}} related packages:
 
+
<syntaxhighlight lang="text">
* Move all RPM packages in a directory of your choice.
+
apt-get remove openoffice.org*
* Go into this directory
+
</syntaxhighlight></li>
* Cancel the StarOffice setup now
+
</ol>
 
+
The RPMS directory contains RPM package for the Gnome and SUSE integration. Users which did not use a SUSE distribution or the Gnome desktop have to remove this files.
+
 
+
* Linux users with an other distribution than SUSE
+
 
+
rm staroffice-suse-menus-8.0.0-124.noarch.rpm
+
 
+
* Users which did not use the Gnome desktop
+
 
+
rm staroffice-gnome-integration-8.0.0-124.i586.rpm
+
 
+
To anticipate the installation of the Adabas D Database server, which is part of StarOffice installation set, remove following RPM package:
+
 
+
*  rm adabas-13.01.00-1.i586.rpm
+
 
+
The RPM command has a rich set of command line parameters. This technical note describes the most important parameters only. Make sure that you are in the directory where RPM packages are located.
+
 
+
For an installation into the standard /opt directory :
+
 
+
rpm -ivh *.rpm
+
 
+
If you prefer to install in another directory.
+
 
+
rpm -ivh –prefix /export *.rpm
+
 
+
Be careful with this. The Gnome and SUSE desktop integration won't work.
+
 
+
Remove the StarOffice installation packages :
+
 
+
rm -r /var/tmp/unpack_staroffice
+
 
+
=== Installing StarOffice Product Upgrades/Patches ===
+
Each Product Update has the same Java based installer front end as the StarOffice installation set. Just call the setup for applying the update. Anyhow, the Upgrade uses RPM packages as which could be applied by the upgrade command of RPM.
+
 
+
* Become root if necessary
+
 
+
su -
+
 
+
* Expand the TAR ball with the product update
+
 
+
tar xvf 120184-01.tar  <nowiki>[The name of the file could be different]</nowiki>
+
 
+
* Goto the RPMS directory
+
* To apply the Upgrade/Patch:
+
 
+
rpm -U *
+
 
+
=== Deinstallation ===
+
Previous release of StarOffice could be removed by simply deleting the StarOffice directory and the .sversionrc. Do not that with StarOffice 8, it makes your RPM repository inconsistent
+
 
+
Use the RPM package manager to de-install StarOffice. You have to determine the list of StarOffice 8 related packages.
+
 
+
* Become root if necessary
+
 
+
su -
+
 
+
* Create a file 'so_packages' with all StarOffice related RPM packages
+
 
+
rpm -qa | grep staroffice > so_packages
+
 
+
* Check the content of file carefully. All these packages get removed from the system. There are two packages which relating to StarOffice but they are not in this list.
+
rpm -qa | grep adabas-13 >> so_packages
+
rpm -qa | grep jre-1_5_0_03 >> so_packages
+
 
+
* To remove all StarOffice related packages:
+
 
+
rpm -e `cat so_packages`
+
 
+
== Debian Packages ==
+
=== Installation ===
+
StarOffice does not provide Debian packages. Debian users has to convert the RPM packages before they could start with the installation.
+
 
+
Owner of StarOffice CD has to go into the RPMS directory of their CD-ROM. Users of the download installation set have to extract the RPM packages first, which is described in the RPM section above.
+
 
+
* Become root if necessary
+
 
+
su -
+
 
+
* Remove the SUSE menu integration
+
 
+
rm staroffice-suse-menus-8.0.0-124.noarch.rpm
+
 
+
* The alien utility converts RPM packages into native Debian packages (.DEB). Few Debian based distributions does not have the installed or uses not the latest release . We recommend to install the latest release with:
+
 
+
apt-get install alien
+
 
+
:or by manually downloading from [http://packages.debian.org/alien http://packages.debian.org/alien]
+
* Convert the RPM packages into DEB packages
+
 
+
alien -k *.rpm
+
 
+
* Install the converted StarOffice packages into the /opt/staroffice8 directory
+
 
+
dpkg -i - force-overwrite *.deb
+
-->
+
  
 +
{{InterWiki Languages AdminGuide|articletitle=Documentation/Administration Guide/Linux}}
 
{{PDL1}}
 
{{PDL1}}

Latest revision as of 14:14, 1 February 2021


RPM Based Linux distributions

The RPM package manager is a powerful tool you can use to deploy software packages both locally and throughout a network.

Documentation note.png These instructions assume you have downloaded and extracted the Apache OpenOffice installation files.

Install

  1. Become root if necessary
    su -
  2. Change directory to:
    <OpenOffice.org_unzip-dir>/RPMS
  3. The RPMS directory contains RPM packages for Apache OpenOffice as well as Gnome and KDE integration.
    • For users with KDE, you can remove the Gnome integration RPM:
    rm openoffice.org-gnome-integration-<version>.rpm
    • For users with Gnome, you can remove the KDE integration RPM:
    rm openoffice.org-kde-integration-<version>.rpm
  4. Install into the standard /opt directory
    rpm -ivh *.rpm
    Documentation note.png If you prefer to install Apache OpenOffice in a different location, use the -prefix option.
     rpm -ivh –prefix <install-dir> *.rpm
    
  5. To install the Apache OpenOffice in the menus:
    cd desktop-integration

    Find the RPM for your specific Linux distribution and install it:

    rpm -ivh openoffice.org-<distribution>-menus_<version>.rpm

You can safely delete the Apache OpenOffice installation packages after the install is complete.

Uninstall

Do not delete the Apache OpenOffice files from the file system. You must use either the Apache OpenOffice Java setup or the RPM package manager to uninstall Apache OpenOffice.

  1. Become root if necessary
    su -
  2. Create a file 'ooo_packages' with all Apache OpenOffice related RPM packages
    rpm -qa | grep openoffice > ooo_packages
  3. Check the content of this file carefully. All packages in this list will be removed. This list does not include the JRE package that was installed if you used the Apache OpenOffice installation set that includes JRE.
  4. To remove all Apache OpenOffice related packages:
    rpm -e 'cat ooo_packages'

DEB Based Linux Distributions

The APT or DPKG package manager is a powerful tool you can use to install, update and remove DEB packages, and is provided as part of some Linux distributions such as Debian and Ubuntu.

Documentation note.png If you have the RPM package and do not want to download the DEB package, you can convert the RPM files to DEB files using the following command:
   sudo alien -d --scripts *.rpm 
Documentation note.png There are installation scripts written that may be useful for experienced users. For more information see the following:

http://installation.openoffice.org/source/browse/installation/setup_native/scripts/

Install

  1. Become root if necessary
    su -
  2. Change directory to:
    <OpenOffice.org_unzip-dir>/DEBS
  3. The DEBS directory contains DEB packages for OpenOffice.org as well as Gnome and KDE integration.
    • For users with KDE, you can remove the Gnome integration DEB:
    rm openoffice.org-gnome-integration-<version>.deb
    • For users with Gnome, you can remove the KDE integration DEB:
    rm openoffice.org-kde-integration-<version>.deb
  4. Install into the standard /opt directory
    dpkg -i *.deb
    Documentation note.png If you prefer to install Apache OpenOffice in a different location, use the --instdir=<directory> option.
    dpkg -i --installdir=<install-dir> *.deb
  5. To install the Apache OpenOffice in the menus:
    cd desktop-integration
    dpkg -i openoffice.org-debian-menus_<version>.deb

You can safely delete the Apache OpenOffice installation packages after the install is complete.

Uninstall

Do not delete the Apache OpenOffice files from the file system. You must use either the Apache OpenOffice Java setup or the DEB package manager to uninstall Apache OpenOffice.

  1. Become root if necessary
    su -
  2. To remove all Apache OpenOffice related packages:
    apt-get remove openoffice.org*
Content on this page is licensed under the Public Documentation License (PDL).
Personal tools
In other languages