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