unopkg

From Apache OpenOffice Wiki
Jump to: navigation, search



The unopkg executable offers another way to start the Extension Manager. It supersedes the pkgchk executable which was used in OpenOffice.org 1.1.0 and older versions and which no longer works.

In contrast to the Extension Manager in Apache OpenOffice unopkg can also manage shared extensions. For example:

 [<OfficePath>/program] $ unopkg add --shared my_extension.oxt

installs my_extension.oxt for all users.

unopkg offers a windowless mode in which all interactions occurs through the console. This is the default. If unopkg is started with the subcommand gui then the Extension Manager dialog appears which is exactly the same as the one in Apache OpenOffice.

 [<OfficePath>/program] $ unopkg gui

The difference is that in the dialog all items deployed under Apache OpenOffice Extensions can be modified and new items can be added there as well. All actions, that is, adding, removing, etc. can be done in the dialog. Therefore unopkg gui does not require any more parameters.

Following is a short overview of what can be done with unopkg. Since there are many more commands, have a look at the help text that can be obtained by calling unopkg -h.

First of all, open a console and change into the program directory of the office installation.

Adding an extension for a single user:

 [<OfficePath>/program] $ unopkg add my_extension.oxt

Adding an extension for all users:

 [<OfficePath>/program] $ unopkg add --shared my_extension.oxt

Removing a user extension is done via the identifier of the extension (see Extension Identifiers):

 [<OfficePath>/program] $ unopkg remove my.domain.my_extension-id

Remove a shared extension:

 [<OfficePath>/program] $ unopkg remove --shared my.domain.my_extension-id

Before you install an extension or other item for all users, make absolutely sure there are no running instances of Apache OpenOffice. unopkg cannot recognize if there are running instances of Apache OpenOffice from different users. Installing into a running office installation might cause inconsistencies and destroy your installation!

When a user starts Apache OpenOffice and then starts unopkg, then the Extension Manager from the office is used and unopkg terminates. Then, however, no shared extensions and other shared items can be modified.

Documentation caution.png Although it is now possible to deploy “live” into a running Apache OpenOffice process, there are some limitations you should be aware of: Removing a type library from a running process is not possible, because this may lead to crashes when the type is needed. Thus if you, for example, uninstall a package that comes with a UNO type library, these types will vanish upon next process startup, but not before.

There may also be problems with cached configuration data, because parts of the running process do not listen for configuration updates (for example, menu bars). Most often, those parts read the configuration just once upon startup.

Content on this page is licensed under the Public Documentation License (PDL).
Personal tools
In other languages