MozUS
MozUS - Mozilla Update Server
MozUS is a server update for the Mozilla products.
MozUS was thought to install in complement of SOGo and was developed to allow a fast maintenance and fast deployments of a SOGo/Thunderbird solution.
Requirements
SOGo requires SME 8 (Final release available since May 2012)
Optionnal Requirements
MozUS can function without SOGo being installed on your server.
To install SOGo : SOGo.
It is not necessary to follow the procedure “Thunderbird Configuration”, this part is integrated in MozUS.
Principle of Operations
MozUS integrates two functionalities:
- Maintenance of the updates software Thunderbird and Firefox (ESR version only).
- Maintenance and deployments of the additional modules for Thunderbird (Firefox does not profit for the moment of this functionalitie).
Install
To complete
yum install smeserver-mozus
signal-event post-upgrade; signal-event reboot
Configuration
Once installed you will have access to a new section in the server-manager. This section comprises 3 new pages:
- Mozilla Update Server : You will be able to enable/disable MozUS, to authorize the updates for Thunderbird/Firefox, to authorize the major updates, the maintained versions and platforms.
- Planner of MozUS : Allows you to define the frequency of synchronization of “mirror” MozUS
- Complementary Modules: You allows to download the additional modules directly and to manage the modules to be maintained. The preset preferences via the module “sogo_integrator” are also defined here.
1.) Define your various parameters in the first panel.
2.) Define the interval of synchronization of “mirroir” - has interval regular where Mozus will check on the Mozilla servers if one or more new versions are available.
3.) Download the modules “sogo-integrator”, “sogo-connector” and “Lightnings” for the versions to be maintained here: Inverse Sogo Frontends En
4.) Download the additional modules that you wish deploy and define the parameters preset.
5.) Download Thunderbird ESR and/or Firefox ESR
Thunderbird
Import the certificate of your SME as an authority of certifications (If not the synchronization of the modules will not be done).
The certificate is downloadable here: https://servername.domainname/SOGo-plugins/servername.domainname.crt (ex: https://www.example.com/SOGo-plugins/www.example.com.crt).
Configure the default account email before installing the module “sogo_integrator”.
In the server-manager, download the module “sogo-integrator” modified by MozUS and install it in Thunderbird.
Start again Thunderbird and let make.
Firefox
Import the certificate of your SME as an authority of certifications (If not the synchronization of the modules will not be done).
The certificate is downloadable here: https://servername.domainname/SOGo-plugins/servername.domainname.crt (ex: https://www.example.com/SOGo-plugins/www.example.com.crt).
In Firefox, go in the editor of configuration (accessible via 'about:config').
Create/Modify the following parameters :
app.update.url.override=https://servername.domainname/moz-updates/updates/%PRODUCT%/%VERSION%/%BUILD_ID%/%BUILD_TARGET%/%LOCALE%/%CHANNEL%/%OS_VERSION%/%DISTRIBUTION%/%DISTRIBUTION_VERSION%/update.xml
app.update.auto=false
app.update.cert.checkAttributes=false
app.update.cert.requireBuiltIn=false
app.update.enabled=true
autoupdate.enabled=false
Command Line
MozUS is provided with two utilities :
/usr/bin/Mozmirup
Allows to manage the synchronization of the update and accepts two parameters :
/usr/bin/Mozmirup --update => Force a software research of the updates on the Mozilla servers. /user/bin/Mozmirp --delete-obsolete => removes the files of updates not answering the criteria (also accessible since the first panel)
/usr/bin/Mozaddons
Allows to manage the integration of the additional modules and accepts two parameters :
/usr/bin/Mozaddons --update_sogo => makes it possible to update the modules 'sogo-integrator present.
/usr/bin/Mozaddons --add_update /path/addon.xpi [new name] => allows the addition or update of a module. The module path is an obligatory parameter while the parameter “new name” is optional.
Optional Configuration
UseSSL
If your installation of SOGo does not comprise redirections HTTP towards HTTPS, you are likely to meet an error during the synchronization of the calendars/contact and additional module.
It is possible to modify the parameters of MozUS not to use “https”.
Disable the use of “https” and regenerate PHP files of Mozus:
db Mozus setprop Mozus UseSSL disabled expand-template /opt/mozilla-updates/mirror/updates expand-template /opt/mozilla-updates/SOGo-plugins/updates.php /usr/bin/Mozaddons --update_sogo
Appendices
How Mozus integrates a module
The integration of a module by MozUS is done in the following way:
1.) The modules “xpi” are with the format zip, the first stage thus consists with decompress
2.) Once decompressed, one treats the file “install.rdf” which comprises following information:
- Name and Identifier of the module.
- Version of the module.
- Compatible Mozilla Products.
- Versions of the compatible products.
- Compatible platforms.
3.) According to the module, we modify the file “install.rdf” to remove useless information
- For a simple module we leave only information relating to Thunderbird
- For the module “sogo-integrator” we modify his internal version (with an aim of managing a single version for each modification carried out by MozUS). The files “extensions.rdf”, “Site.js” and “custom-preferences.js” are regenerated and to integrate in the module.
So none the methods of parse tested before gave a conclusive result on the various modules.
4.) The module is then recomposed, a key east creates in the Mozus base. In same time, the module is copied in “/opt/mozilla-updates/Moz-AddOns” and symbolic links are created
in “/opt/mozilla-updates/SOGo-plugins” according to each supported platform (Windows/Mac/Linux 32 and 64 bits).
References
http://wiki.sogo.nu/TB-upgrade-service
https://developer.mozilla.org/en-US/docs/Mozilla/Setting_up_an_update_server
