Apache OpenOffice Extension Manager

From Apache OpenOffice Wiki
Jump to: navigation, search


You can use the Apache OpenOffice Extension Manager to add, remove, disable, enable, and export Apache OpenOffice extensions. For example, you can use the Extension Manager to add or remove the following types of extensions:

  • Configuration Data
  • Configuration Libraries
  • Extensions
  • Universal Network Objects (UNO) components
    These components represent compiled software packages. UNO is the interface-based component model for Apache OpenOffice. For more information on this model, go to the UNO Development Kit project web site.

Template:Documentation/Note

You can manage extensions from a dialog box or from the command-line.

Using the Extension Manager Dialog Box

Extensions can be installed so that they are available to only the current user (single user installation), or to all users (shared user installation). Before you start installing an extension.

To install an extension that will be used by only the current user, open the Extension Manager dialog box from the Tools menu in any Apache OpenOffice program and install the extension. The extension will be installed and be immediately available to the current user. The extension will not be available to other users on that computer.

To install an extension that can be used by all users, you must install the extension with root or Administrator privileges. Open the Extension Manager dialog box from the command line, or use the unopkg --shared command-line syntax.

To Add an Extension for All Users

  1. Become root.
    • In UNIX and Linux, open a terminal window, and type su.
    • In Windows, open a command prompt.
    • In Windows Vista, right-click the icon for the command prompt and select Start as Administrator.
  2. Change to the install-dir/program directory.
  3. Type unopkg gui.
    The Extension Manager dialog box appears.
  4. In OpenOffice.org 2.x:
    1. Select the extension category to which you want to add the extension.
    2. Click the Add button.
    3. Locate the extension that you want to add, and then click OK.
  5. In OpenOffice.org 3.x:
    1. Click the Add button.
    2. Locate the extension that you want to add, and then click OK.

To Remove an Extension for All Users

  1. Become root.
    • In UNIX and Linux, open a terminal window, and type su.
    • In Windows, open a command prompt.
    • In Windows Vista, right-click on the icon for the command prompt and select Start as Administrator.
  2. Change to the install-dir/program directory.
  3. Type unopkg gui.
    The Extension Manager dialog box appears.
  4. In the list of extensions, select the extension that you want to remove.
  5. Click the Remove button.

Using the unopkg Command to Manage Extensions

You can manage packages from the command line. The syntax for the unopkg command is:

unopkg add {-v, -f, --log-file, --shared} 
       extension-path | remove {-v, -f, --log-file, --shared}
       extension-name | list {-v, -f, --log-file, --shared} 
       extension-name | reinstall {-v, -f, --log-file, --shared} | gui | -V | -h
add
Adds extensions to an Apache OpenOffice installation.
remove
Removes extensions from an Apache OpenOffice installation.
list
Displays information about the deployed extensions.
reinstall
Reinstalls the deployed extensions.
gui
Opens the Extension Manager dialog box.
–V, – –version
Displays the version information for the unopkg command.
–h, – –help
Displays the help for the unopkg command.
-v, --verbose
Runs the command in verbose mode.
-f, --force
Overwrites existing extensions that have the same names.
--log-file filename
Creates a log file. The default file name path for the log file is cache-dir/log.txt
--shared
Expert feature: operate on shared installation deployment context; run only when no concurrent processes are running
Content on this page is licensed under the Public Documentation License (PDL).
Personal tools