1 *b1cdbd2cSJim Jagielski================================================================================ 2 *b1cdbd2cSJim JagielskiInstallation information 3 *b1cdbd2cSJim Jagielski================================================================================ 4 *b1cdbd2cSJim Jagielski 5 *b1cdbd2cSJim JagielskiIn order to properly install the bundled extensions, such as dictionaries, it is 6 *b1cdbd2cSJim Jagielskinecessary that the files 7 *b1cdbd2cSJim Jagielski 8 *b1cdbd2cSJim Jagielskiinstalled 9 *b1cdbd2cSJim Jagielskiooo_bundled_extensions.xml 10 *b1cdbd2cSJim Jagielskisvc-ooo_bundled_extensions 11 *b1cdbd2cSJim Jagielski 12 *b1cdbd2cSJim Jagielskiare part of the Apache OpenOffice IPS package. They must be added to the package 13 *b1cdbd2cSJim Jagielskiafter all other files have been added. Those other files are the SVR4 packages 14 *b1cdbd2cSJim Jagielskiof OOo which can be imported by pkg (pkg import). 15 *b1cdbd2cSJim JagielskiThe files have to be uploaded this way: 16 *b1cdbd2cSJim Jagielski 17 *b1cdbd2cSJim Jagielskipkgsend -s url_to_pkg_server add file installed mode=644 owner=root group=bin path=${EXTENSIONPATH}/installed restart_fmri=svc:/application/ooo_bundled_extensions:default 18 *b1cdbd2cSJim Jagielskipkgsend -s url_to_pkg_server add file svc-ooo_bundled_extensions mode=744 owner=root group=bin path=/lib/svc/method/svc-ooo_bundled_extensions 19 *b1cdbd2cSJim Jagielskipkgsend -s url_to_pkg_server add file ooo_bundled_extensions.xml mode=644 owner=root group=bin path=/var/svc/manifest/application/ooo_bundled_extensions.xml restart_fmri=svc:/system/manifest-import:default 20 *b1cdbd2cSJim Jagielski 21 *b1cdbd2cSJim Jagielski 22 *b1cdbd2cSJim Jagielski--- 23 *b1cdbd2cSJim Jagielski 24 *b1cdbd2cSJim Jagielski${EXTENSIONPATH} must be replaced by the path to the folder containing the 25 *b1cdbd2cSJim Jagielskibundled extensions. This path changes with every major release of OOo because of 26 *b1cdbd2cSJim Jagielskithe version number which is part of a folder name. The 27 *b1cdbd2cSJim Jagielskicurrent value is: 28 *b1cdbd2cSJim Jagielski 29 *b1cdbd2cSJim JagielskiEXTENSIONPATH=/opt/openoffice3/share/extension/install 30 *b1cdbd2cSJim Jagielski 31 *b1cdbd2cSJim JagielskiThe service was tested with OpenSolaris release 2009.6 and may not work with a 32 *b1cdbd2cSJim Jagielskiprevious release. 33 *b1cdbd2cSJim Jagielski 34 *b1cdbd2cSJim Jagielski 35 *b1cdbd2cSJim Jagielski================================================================================ 36 *b1cdbd2cSJim JagielskiWhat do these files do 37 *b1cdbd2cSJim Jagielski================================================================================ 38 *b1cdbd2cSJim Jagielski 39 *b1cdbd2cSJim JagielskiThe three files constitute a SMF service. When this service is started, then it 40 *b1cdbd2cSJim Jagielskiinstalles the bundled extensions which are contained in 41 *b1cdbd2cSJim Jagielski/opt/openoffice3/share/extension/install. To install them, the service calls 42 *b1cdbd2cSJim Jagielski"unopkg add --shared ..." with the appropriate arguments. 43 *b1cdbd2cSJim Jagielski 44 *b1cdbd2cSJim JagielskiThe service is started initially after the installation of 45 *b1cdbd2cSJim Jagielskiooo_bundled_extensions.xml. At this time, all files of OOo, including the 46 *b1cdbd2cSJim Jagielskiextensions, have been copied to their destination. The service calls unopkg on 47 *b1cdbd2cSJim Jagielskibehalf of every extension and adds the path to that extension to the file 48 *b1cdbd2cSJim Jagielski'installed'. The file 'installed' is used to remember what extensions have 49 *b1cdbd2cSJim Jagielskialready been installed with unopkg. This will prevent to reinstall those 50 *b1cdbd2cSJim Jagielskiextensions whenever the service is restarted. 51 *b1cdbd2cSJim Jagielski 52 *b1cdbd2cSJim JagielskiWhen a new version of OOo becomes available, then the respective OOo package 53 *b1cdbd2cSJim Jagielskicontaines a new version of 'installed'. That is, it contains a version string, 54 *b1cdbd2cSJim Jagielskisuch as 3.2.0. The sole reason for that string is, to change the content of this 55 *b1cdbd2cSJim Jagielskifile in every release. Otherwise IPS would not replace the installed version of 56 *b1cdbd2cSJim Jagielski'installed' with the one contained in the package. 57 *b1cdbd2cSJim Jagielski 58 *b1cdbd2cSJim JagielskiThe update procedure of OOo will replace 'installed'. 'installed' is associated 59 *b1cdbd2cSJim Jagielskiwith a restart_fmri of the service ooo_bundled_extensions. That is after 60 *b1cdbd2cSJim Jagielskicopying 'installed' the service will be restarted. It then installes all 61 *b1cdbd2cSJim Jagielskiextensions contained in /opt/openoffice3/share/extension/install, because 62 *b1cdbd2cSJim Jagielskithe newly installed 'installed' file does not contain any entries yet, except 63 *b1cdbd2cSJim Jagielskifor the version string. 64 *b1cdbd2cSJim Jagielski 65 *b1cdbd2cSJim Jagielski 66 *b1cdbd2cSJim Jagielski================================================================================ 67 *b1cdbd2cSJim JagielskiKnown issues 68 *b1cdbd2cSJim Jagielski================================================================================ 69 *b1cdbd2cSJim Jagielski 70 *b1cdbd2cSJim JagielskiIf OOo, which contains this service, is uninstalled and later it is installed 71 *b1cdbd2cSJim Jagielskiagain, then the bundled extensions are not installed. That is, unopkg is not 72 *b1cdbd2cSJim Jagielskicalled to install them with OOo's Extensions Manager. The reasons is a bug in 73 *b1cdbd2cSJim JagielskiOpenSolaris: 74 *b1cdbd2cSJim Jagielski 75 *b1cdbd2cSJim Jagielskihttp://defect.opensolaris.org/bz/show_bug.cgi?id=5742 76 *b1cdbd2cSJim Jagielski 77 *b1cdbd2cSJim JagielskiTo work around this, one can call after uninstalling OOo 78 *b1cdbd2cSJim Jagielski 79 *b1cdbd2cSJim Jagielskisvccfg delete -f ooo_bundled_extensions 80 *b1cdbd2cSJim Jagielskisvccfg delete smf/manifest 81