Difference between revisions of "Documentation/FAQ/Installation"
m (Added links to "StarOffice" ...)
m (FAQ:Installation moved to Documentation/FAQ/Installation: Restructure Documentation part of the wiki)
Revision as of 11:28, 9 July 2007
- 1 What are the system requirements?
- 2 Where can I get the downloads for my platform?
- 3 Can I download only parts of the OpenOffice.org suite?
- 4 What is the best way to download such a large file?
- 5 How do I find the file I just downloaded?
- 6 It's too large to download. What other choices do I have?
- 7 How do I buy an OpenOffice.org CD?
- 8 Where do I download dictionaries for other languages?
- 9 Where can I get documentation on installation?
- 10 How do I install OpenOffice.org on Windows?
- 11 I've installed OpenOffice.org, now what do I do?
- 12 Is it possible to install OpenOffice.org without the user having to input data?
- 13 How can I install OpenOffice.org so that it can be used by multiple users on the same machine?
- 14 How do I perform a silent install?
- 15 How does OpenOffice.org work over NFS?
- 16 How do I setup SAMBA to get the best performance with OOo?
- 17 When trying to install OpenOffice.org I get a message about a missing library. How can I solve this?
- 18 How do I uninstall OpenOffice.org?
- 19 Why does the OOo install ask for Unicows.dll?
- 20 Can I install OpenOffice.org on a Terminal Server?
- 21 The installer is looking for Java. Does it really need it to work correctly?
- 22 The installer is looking for Java. Where do I find it?
- 23 Which version of Java do I need?
- 24 Java is installed, but why isn't it recognized?
- 25 Can I install Java after I install OpenOffice.org?
- 26 How do I fix the internal error, Get Storage: No Content?
- 27 How to convert files created with SRC680 snapshot builds, prior to m64, to the 2.0beta and later format?
- 28 How to fix FC3 error error while loading shared libraries: /<path_to_openoffice.org_install_directory>/program/libicudata.so.26: cannot restore segment prot after reloc: Permission denied?
- 29 Why is Java needed in OpenOffice.org?
What are the system requirements?
Generally, 64-128 MB of RAM is recommended, with a minimum of 32 MB present under the Windows and Linux installation. 64MB is suggested to be the bare minimum as more memory improves start-up speed and overall performance. On Windows and Linux, a minimum of 115MB of hard disk space is required (this can go up to about 240 MB), while on Mac OS X, you require about 450 MB of disk space.
For full details, see the main site.
Where can I get the downloads for my platform?
The best place to look for the latest, greatest releases and related information is at OpenOffice.org's Download Central, which can also be accessed via the Download tab at the top of most pages at the OpenOffice.org web site.
Most operating systems will run the latest stable release, but there are exceptions:
- The porting project and its members are the maintainers of the latest stable release for Mac OS X.
- The legacy release for Win95 is 22.214.171.124.
Can I download only parts of the OpenOffice.org suite?
No, this is not possible at this time. OpenOffice.org is an application suite. A suite is one application with several different faces. Most of these faces use the same set of libraries. Although the download size of the entire application may be around 70 MB, the download for the core components needed to enable only the word processor module would probably be over 50 MB. This is not much of a saving compared to the loss of extra functionality included in the other modules of the office suite.
What is the best way to download such a large file?
Use a download manager. This allows you to start, suspend, and resume the download. There is information about various download mangagers at OpenOffice.org's Download Central web page.
How do I find the file I just downloaded?
You can use the Search utility if you cannot remember where you placed the file during the download process. If you just downloaded the Windows version of OOo, then the file should be called something like OOo_1.1.3_Win32Intel_install.exe or OOo_126.96.36.199_Win32Intel_install.zip.
To use the search utility in Win98, click on the Start button, choose Find > Files or Folders, type OOo into the Named field, then click the Find Now button. This will bring up a list of all files on your system that contain OOo, and it will show where they live.
To use the search utility in WinXP or Win2000, click on the Start button, choose Search > Files or Folders, type OOo into the Search for files or folders named field, then click the Search Now button.
The path to the search utility will not be exactly the same on every operating system, but it will be similar. (If you can provide exact steps to the search utility on your operating system, please do!)
It's too large to download. What other choices do I have?
You can order OpenOffice.org on CD from various distributors.
How do I buy an OpenOffice.org CD?
If downloading the software is not feasible, you are always welcome to purchase a CDROM from one of the distributors that make them available in your country. More information about this is available at the OpenOffice.org CDROM Project.
It is also interesting to note that Ubuntu, Red Hat Linux, Mandrake Linux, and SUSE distribute OpenOffice.org with their Linux distributions. Mandrake Club (Silver Membership) also provides a copy of StarOffice as an alternative product.
Where do I download dictionaries for other languages?
The default dictionary is English. The Spelling, Hyphenation and Thesaurus Dictionaries: Download/Installation page at http://lingucomponent.openoffice.org/download_dictionary.html OpenOffice.org will be of help. Here they have localised dictionaries as well.
Where can I get documentation on installation?
Installation documentation can be found in the OpenOffice.org Setup Guides which are available at the documentation project.
How do I install OpenOffice.org on Windows?
If you have downloaded the binary file for Windows from OpenOffice.org, it may be in ZIP, TAR, or EXE format.
- If the file is in the ZIP or TAR format, decompress it into a temporary folder (with a program such as WinZip or Pkzip).
If the file is in the EXE format, simply double-click the file to decompress it.
- Double-click the Install icon that you find in the Install Folder; or, double-click the file named setup.exe. A guided installation dialog will begin and will step you through the installation process.
I've installed OpenOffice.org, now what do I do?
Simply start the OpenOffice.org application. After the installation, an entry for OpenOffice.org is listed in the Programs menu. After OpenOffice.org has started, an icon will be available on the system tray. (It looks like flying seagulls on a blue and white background.) Click on the icon with the right mouse button to quickly start the various different components of the office suite. This quick-launcher will automatically start when you log in.
Is it possible to install OpenOffice.org without the user having to input data?
Yes. The StarOffice 6.0 Software Responsefile Installation Guide explains how to do it.
How can I install OpenOffice.org so that it can be used by multiple users on the same machine?
Use the multiuser installation mechanism: As administrator call the setup program with the -net parameter. For example, when the setup command is used, type: ./setup -net. Then when each user runs the application for the first time, they will be asked for setup information specific to their own account. Only per user configuration files will be kept in a directory specific to each user.
How do I perform a silent install?
In corporate environments, when rolling out OpenOffice.org to many machines, the easiest way to do it is via a silent install. In a Windows environment, the following guide seems to be useful:
- Let Windows install the package from a network drive by N:\OpenOffice\program\setup.exe -r:N:\OpenOffice\response.txt
where N:\ can be whatever it is the network drive has been mapped to, and it contains the install files of OpenOffice.org created by running setup.exe with the /net option.
- The response.txt file can contain:
[Environment] InstallationMode=INSTALL_NORMAL InstallationType=STANDARD DestinationPath=C:\Program Files\OpenOffice StartProcedure=MyStartProc Migration=Yes [Java] JavaSupport=preinstalled_or_none [Procedures] Sub MyStartProc SetUserCompanyName("None") HideSetupEnd Sub [Windows_Desktop_Integration] Register4MSWord=True Register4MSExcel=True Register4MSPowerPoint=True RegisterAsDefaultHTMLEditor=True
Apparently, Sun for its StarOffice package provides some fairly good documentation in PDF files with regards to silent installs. Another good resource is the section within the user installation documentation entitled Windows in a Multiple User Environment.
How does OpenOffice.org work over NFS?
To get OpenOffice.org to export over NFS and perform the install, the server needs to have the link_relative option during NFS export. Without it, the links that the setup program creates are all absolute, which breaks the setup program when it crosses file systems.
How do I setup SAMBA to get the best performance with OOo?
(Here is what Xavier Poirier did to improve performance of OOo clients running from a SAMBA share):
We have an installation of OOo1.1 on a network with a SAMBA share (for the clients) - a 10M network, so not the fastest.
For SAMBA I have found this (thanks to O'REILLY Online Catalog): (Appendix B) B.2 Samba Tuning.
Tuning options used:
- We have a share with READONLY mode (which is 5-10% faster for OOo).
- Put OPLOCKS "ON": this permits the client to "cache" the files.
- Put LOGLEVEL to "1" instead of "0" by defaut.
- Put BLOCSIZE to 2048 instead of 1024.
Later I will try others, (like IPTOS_LOWDELAY) if anyone tries it, I'm interested ...
The clients: for better performance, it seems that they must run the quickstarter of OOo: soffice.exe -quickstart.
The result is GOOD! The clients are much faster for opening OOo! We won about 30-40% performance I think with these parameters.
When trying to install OpenOffice.org I get a message about a missing library. How can I solve this?
This message generally means that you have a file which got corrupted during download. To verify this you can use the md5sum utility as described on the download page. This tool generates a checksum that you can cross check with the value on the download server.
How do I uninstall OpenOffice.org?
On Windows, you can use the Add/Remove Programs option in the Control Panel. On Linux, you can use ./setup and choose the Remove option. If you installed OpenOffice.org through another method (an RPM, or a Debian package), using the appropriate package removal tool is best.
Why does the OOo install ask for Unicows.dll?
The Unicows.dll file is a library needed for Windows95, Windows98, and Windows ME operating systems to work with international characters. It was needed for a time with early versions of OpenOffice 1.1 development series (1.1beta1, 1.1beta2, 1.1rc1 and 1.1rc2 ). It is included in the download for OpenOffice 1.1 and later versions. You do not need this DLL file if you have Windows NT or Windows XP.
Can I install OpenOffice.org on a Terminal Server?
Yes, use the install.exe -net command to do the initial server install.
Then use the installed OpenOffice.org setup.exe program to set up Workstation installations for each individual user. This can be a long process. It is possible to create a response file so that the installation is done automatically through a logon profile next time your users log into the system.
For more information:
The installer is looking for Java. Does it really need it to work correctly?
Java is not needed for OpenOffice.org to work correctly. However there will be some features which will not be available without it. For example, with 1.1 you will not be able to use the XSLT functionality, JDBC, applets, form generators, and Java Application Programming Interfaces (APIs) for 3rd party modules, if no Java is installed.
For more information:
The installer is looking for Java. Where do I find it?
Which version of Java do I need?
The release notes should be able to tell you that information.
Java is installed, but why isn't it recognized?
Are you sure that you have the right version of Java installed? Please check the release notes for the version of OpenOffice.org you have installed.
When you have verified that you do have the right version of Java on your system, and it is still not recognized, you can manually insert the path in the relevant Java dialog during OOo installation.
After installation of OpenOffice.org, if Java is still not recognized, click Tools > Options > OpenOffice.org > Java. The OpenOffice.org Java window will open. In the box under "Java is already installed", highlight the version of Java installed. Click Add. Java will now be recognized by OpenOffice.org. You may have to repeat this step when you update Java Runtime Environment.
Can I install Java after I install OpenOffice.org?
Yes, you can run the program jvmsetup which can be found in the program folder of your OpenOffice.org installation.
How do I fix the internal error, Get Storage: No Content?
OpenOffice.org fails to start, and the following error message appears:
OpenOffice can not be started due to an error in accessing the OpenOffice.org configuration data. Please contact your system administrator. The following internal error has occurred: Get Storage: "No Content".
The message often occurs because a file named Common.xcu becomes corrupted. In most cases, this file becomes filled with 0s. The problem seems to occur most often in Windows, possibly as a result of a crash or an improper exit while OpenOffice.org was open. Windows systems:
It is easiest to use the Find function (sometimes called Search) in the Windows Explorer to locate this file in Windows.
Where OpenOffice.org is installed as multi-user under Windows NT/W2k/XP, this file is likely to be in a special system user directory. Therefore, one must have administrator rights and enable the option to view system directories in Explorer before using the Find function. This particular file should be found in the following path:
C:\Documents and Settings\<user>\Application Data\OpenOffice.org\<user>\registry\data\org\openoffice\Office\Common.xcu
where user is an actual user name.
Once the file is located, simply rename the file (for example, to something like Common.xcu.old) and restart OpenOffice.org. A new Common.xcu file is created, and the problem should disappear.
Where OpenOffice.org is installed for a single user, this file is likely to be in the following path:
If the OS is NT/W2k/XP, this file may be in a special system user directory, so use administrator rights and enable the option to view system directories in Explorer before using the Find function. In Windows 95/98/ME, the location will likely be in the suggested path. Again, once the file is located, simply rename the file (for example, to something like Common.xcu.old) and restart OpenOffice.org. A new Common.xcu file will be created and the problem should disappear.
Note: There may be shared files called Common.xcu under paths, such as the following:
Do NOT delete these shared files! UNIX systems:
The default location for this file under a UNIX installation (single or multi-user) is the following path:
where $HOME is the user's home directory. As above, simply rename the file (for example, to something like Common.xcu.old) and restart OpenOffice.org. A new Common.xcu file will be created and the problem should disappear.
Where <release> is the release number of the OpenOffice.org you have installed and <user> is the user namme of the particular user installation.
How to convert files created with SRC680 snapshot builds, prior to m64, to the 2.0beta and later format?
Documents saved with SRC680 builds, prior to m64, cannot be opened by 2.0Beta or later. This especially applies to Writer documents. To be able to open them, files need to be coverted. Convert each file using the following procedure:
- Create a backup of the document.
- Rename the document to a file with the same name but an extensions that has the 2nd "o" replaced with a "d". For instance, test.oot becomes test.odt. For drawing documents, use the extension "odg". For templates,only the extension of drawing templates has to be changed to "otg".
- Unzip the sub documents "mimetype" and "META-INF/manifest.xml" from the document using an arbitrary zip tool.
- Within the unzipped "mimetype" and "META-INF/manifest.xml" files, replace all occurencies of "x-vnd.oasis.openoffice" with "vnd.oasis.opendocument".
- Add the "mimetype" file uncompressed to the document.
- Add "META-INF/manifest.xml" to the document.
- Load the document into OpenOffice.org and resave it.
For example, you have a file called 'test.oot' on Unix/Solaris. Use the following commands to convert the file: $ cp test.oot test.odt $ unzip test.odt mimetype META-INF/manifest.xml $ mv mimetype mimetype.bak $ sed -e"s/x-vnd\.oasis\.openoffice/vnd.oasis.opendocument/" mimetype.bak >mimetype $ zip -0 test.odt mimetype $ mv META-INF/manifest.xml META-INF/manifest.xml.bak $ sed -e"s/x-vnd\.oasis\.openoffice/vnd.oasis.opendocument/" META-INF/manifest.xml.bak >META-INF/manifest.xml $ zip test.odt META-INF/manifest.xml $ [start OpenOffice.org, load file and save it again]
See also: 1.9 m65 Snapshot Release Notes
- cd into /etc/selinux/targeted/contexts/files
- Create a backup of file_contexts. NOTE: do not overwrite file_contexts.rpmnew
- Download the patch and only use it as a model as SELinux under FC3 is being updated too frequently for the patch to be used as is. The contents are correct for installs in /opt and /usr/local. NOTE: you may have to edit file_contexts if OOo is not installed in either /opt or /usr/local.
- Execute setfiles -l -vv -F file_contexts /usr/local/OpenOffice.org*/program/ for /usr/local/ installations.
- Execute setfiles -l -vv -F file_contexts /opt for OOo installations.
- Reboot if necessary.
- If all else fails, disable SELinux and reboot.
Why is Java needed in OpenOffice.org?
Java is necessary for use of the following in OpenOffice.org:
- JDBC drivers
- Using the XSLT, flat XML filters
- Using Java applets in OpenOffice.org
- Using Java-based languages in the scripting framework
- Java Application Interface (API) programs for 3rdparty modules
- Autopilot/wizard form generators
- All accessibility functions
- The OpenOffice.org testtool and QaTestDev programs