Version 2.2.

3
Mozilla Thunderbird Confguration Guide

Copyright 2009-2014 Inverse inc. (http://inverse.ca) Permission is grante to copy! istri"#te an /or mo i$y this oc#ment #n er the terms o$ the %&' (ree )oc#mentation *icense! +ersion 1.2 or any ,ater version p#",ishe "y the (ree -o$t.are (o#n ation/ .ith no Invariant -ections! no (ront-Cover 0e1ts! an no 2ac3-Cover 0e1ts. P,ease re$er to http://....gn#.org/,icenses/$ ,-1.2.t1t $or the $#,, ,icense. +ersion 2.2.4 5 6pri, 2014

Contents

Chapter 1 Chapter 2 Chapter 3

About this Guide Introduction Installation 7o8i,,a 0h#n er"ir 7o8i,,a *ightning 3 4 4 4

-9%o Connector an -9%o Integrator Chapter 4 SOGo Integrator Customization C#stomi8ation Chapter 5 SOGo pdate Ser!er < < ; " 6

Insta,,ation Con=g#ration Chapter 6 Chapter $

Additional In#ormation 11 Commercial Support and Contact In#ormation 12

Chapter 1

1 About this Guide

0his g#i e .i,, .a,3 yo# thro#gh the insta,,ation an con=g#ration o$ 7o8i,,a 0h#n er"ir an its associate e1tensions so it can "e #se .ith the -9%o so,#tion. 0he instr#ctions are "ase on version 2.2.4 o$ -9%o. 0he ,atest version o$ this g#i e is avai,a",e at http://....sogo.n#/ o.n,oa s/ oc#mentation.htm,.

2009-2014 Inverse inc.

6"o#t this %#i e

Chapter 2

2 Introduction

-9%o is a $ree an mo ern sca,a",e gro#p.are server. It o$$ers share ca,en ars! a ress "oo3s! an emai,s thro#gh yo#r $avo#rite >e" "ro.ser an "y #sing a native c,ient s#ch as 7o8i,,a 0h#n er"ir an *ightning. -9%o is stan ar -comp,iant. It s#pports Ca,)6+! Car )6+! %ro#p)6+! i7IP an i0IP an re#ses e1isting I76P! -70P an ata"ase servers - ma3ing the so,#tion easy to ep,oy an interopera",e .ith many app,ications. -9%o $eat#res : -ca,a",e architect#re s#ita",e $or ep,oyments $rom o8en to many tho#san #sers ?ich >e"-"ase inter$ace that shares the ,oo3 an $ee,! the $eat#res an the ata o$ 7o8i,,a 0h#n er"ir an *ightning Improve integration .ith 7o8i,,a 0h#n er"ir an *ightning "y #sing the -9%o Connector an the -9%o Integrator e1tensions 0.o-.ay synchroni8ation s#pport .ith any 7icroso$t 6ctive-ync-capa",e evice! or 9#t,oo3 2014 -9%o is eve,ope "y a comm#nity o$ eve,opers ,ocate main,y in &orth 6merica an @#rope. 7ore in$ormation can "e $o#n on http://....sogo.n#/

2009-2014 Inverse inc.

Intro #ction

Chapter 4

3 Installation

0his section .i,, g#i e yo# thro#gh the insta,,ation o$ 0h#n er"ir an its associate e1tensions.

Mozilla Thunderbird
7o8i,,a 0h#n er"ir is the o$=cia, $ront en c,ient o$ -9%o. 7o8i,,a 0h#n er"ir version 2! 4.1! 10 @-? (@1ten e -#pport ?e,ease)! 1A @-?! an 24 are s#pporte an it is recommen e to #se version 24 o$ 0h#n er"ir . In or er to o.n,oa an insta,, 7o8i,,a 0h#n er"ir ! p,ease visit : https://....mo8i,,a.org/en-'-/th#n er"ir /organi8ations/a,,-esr.htm,

Mozilla Lightning
>hen #sing version 24 o$ 0h#n er"ir ! yo# can #se the ,atest version o$ 7o8i,,a *ightning. 'se the 6 -ons manager o$ 0h#n er"ir or visit : https://a ons.mo8i,,a.org/en-'-/th#n er"ir /a on/,ightning/

>hen #sing version 1A @-? o$ 0h#n er"ir ! yo# can #se 7o8i,,a *ightning version 1.9.1. In or er to o.n,oa the e1tension! p,ease visit : https://a ons.mo8i,,a.org/en-'-/th#n er"ir /a on/,ightning/versions/BpageC1Dversion-1.9.1

(or 0h#n er"ir 2 an 4.1! yo# nee the Inverse Edition o$ 7o8i,,a *ightning. It provi es "ac3 porte $eat#res! "#g =1es an sec#rity =1es $rom the c#rrent eve,opment version o$ 7o8i,,a *ightning. (or 0h#n er"ir 2! it is "ase on re,ease version 0.9 o$ *ightning. (or 0h#n er"ir 4.1! it is "ase on 1.0"2. In or er to o.n,oa an insta,, 7o8i,,a *ightning 5 Inverse @ ition $or 0h#n er"ir 2 or 4.1! p,ease visit : http://....sogo.n#/ o.n,oa s/$ronten s.htm, 2009-2014 Inverse inc. Insta,,ation 4

Chapter 4

SOGo Connector and SOGo Integrator

0he -9%o Connector an Integrator e1tensions are provi e to per$ect the integration o$ 7o8i,,a 0h#n er"ir 2! 4.1! 10 @-?! 1A @-? an 24 .ith the -9%o gro#p.are so,#tion. (irst o$ a,,! the -9%o Connector e1tension trans$orms 0h#n er"ir into a $#,, )6+ c,ient $or gro#p.are servers s#ch as -9%o! e%ro#p.are or Cita e,. It oes this "y a ing s#pport $or remote )6+ a ress "oo3s an "y a ing $eat#res to "e #se a,ong .ith the *ightning ca,en ar e1tension. 6mong s#pporte $eat#res o$ the -9%o Connector e1tension! .e have : (ree / 2#sy '?* =e, in the a ress "oo3 (ree / 2#sy $#nctiona,ity thro#gh E00P @vent organi8ers -ynchroni8ation o$ the a ress "oo3 #sing %ro#p)6+ Car )6+ imp,ementation $or the a ress "oo3 -#pport $or >e")6+ 6C* 9n the other han ! the -9%o Integrator e1tension trans$orms 0h#n er"ir into a p#re FheavyF c,ient $or -9%o. >hereas the -9%o Connector is meant $or porta"i,ity (hori8onta, integration)! the -9%o Integrator ma3es #se o$ the $eat#res an ,ayo#t on,y avai,a",e $rom -9%o (vertica, integration). 6mong the s#pporte $eat#res o$ the -9%o Integrator e1tension! .e have : ?emote a ministration o$ $o, er s#"scriptions ?emote a ministration o$ $o, er access contro, ,ists (6C*) 6#tomatic rep,ication o$ yo#r ,oca, an s#"scri"e $o, ers >hen correct,y con=g#re ! it han ,es the propagation o$ #p ates to chosen e1tensions $rom a ,oca, #p ate server 6#tomatic propagation o$ e$a#,t settings In or er to o.n,oa an insta,, the -9%o Connector an Integrator e1tensions! p,ease visit : http://....sogo.n#/ o.n,oa s/$ronten s.htm, Prior to insta,,ing the -9%o Integrator e1tension! yo# sho#, rea the $o,,o.ing chapter 5 SOGo Integrator Customization.

2009-2014 Inverse inc.

Insta,,ation

Chapter 4

SOGo Integrator Custo!ization

In this section! yo#G,, ,earn ho. to c#stomi8e the -9%o Integrator e1tension so it can "e #se a,ongsi e yo#r -9%o server.

Custo!ization
0he c#stomi8ation steps escri"e here invo,ves #n erstan ing o$ H7* an o$ te1t =,e e ition. I$ yo# o not have those s3i,,s! it is recommen e that yo# onGt try to #se this e1tension. 0here are act#a,,y t.o steps in the con=g#ration o$ a .or3ing environment $or -9%o Integrator. (irst o$ a,,! the Integrator .i,, #se the same #ser name #se to connect to the =rst emai, server con=g#re in 0h#n er"ir . It is a c#rrent ,imitation "#t it .i,, =t near,y a,, con=g#rations o#t there. (or testing p#rpose! yo# are strong,y recommen e to create an con=g#re an a itiona, #ser pro=,e $or 0h#n er"ir . 0his is $or t.o reasons. 0he =rst is "eca#se o$ the ,imitation mentione a"ove. 0he secon is "eca#se the Integrator .i,, synchroni8e yo#r persona, a ress "oo3 onto the -9%o server an then remove it so that on,y yo#r persona, a ress "oo3 on -9%o .i,, "e avai,a",e. I$ yo# are not a",e to o that! yo# may .ant to ma3e a copy o$ that a ress "oo3 "e$orehan . 0he secon part reI#ires e iting one =,e in the e1tension =,e s#" tree to speci$y .here the -9%o server is ,ocate . 0his is one "y han . In an enterprise environment! this step is on,y reI#ire once per re,ease since the #p ates are e1pecte to propagate a#tomatica,,y. 'ncompress (#sing a JIP or Kar too,) the -9%o Integrator HPI an ,ocate the $o,,o.ing =,e:
extensions.rdf

0his =,e is #se $or ,ocating the e1tension #p ate server an the -9%o server! .hich .e consi er to "e the same $or the moment. 0here is a ,ine starting .ith a F-eIF tag an .ith an attri"#te name Fisi:#p ate'?*F. ?ep,ace the host part o$ that #r, .ith the -9%o server yo# .ant to connect to. (or e1amp,e! one .o#, rep,ace :
<Seq about="http://inverse.ca/sogo-integrator/extensions" isi:updateURL="http://sogo-de o.inverse.ca/p!ugins/updates.php"p!ugin= #$%&'($)#*a p+version=#$%&'(,&RS$-.#*a p+p!atfor =#/L0%1-R'#"2

2009-2014 Inverse inc.

-9%o Integrator C#stomi8ation

Chapter 4 "y :
<Seq about="http://inverse.ca/sogo-integrator/extensions" isi:updateURL="https://sogo.ac e.co /p!ugins/updates.php"p!ugin=#$%&'($) #*a p+version=#$%&'(,&RS$-.#*a p+p!atfor =#/L0%1-R'#"2

i$ the -9%o server is accessi",e $rom the $o,,o.ing '?* :

https://sogo.ac e.co /S-3o

&ote that i$ yo# change the x-4ebob5ects-server-ur! con=g#ration setting $rom yo#r E00P server con=g#ration =,e $or -9%o! the va,#e must match the one yo# speci$y in Fisi:#p ate'?*F 5 even the port n#m"er. 7oreover! yo# must change the va,#e o$ the sogointegrator.autoco p!ete.server.ur!id pre$erence $rom defau!ts/preferences/site.5s to match the i enti=er o$ yo#r -9%o'ser-o#rces. 0his so#rce .i,, "e #se "y 0h#n er"ir $or a#tocomp,etion. 9nce yo#Gre one mo i$ying the con=g#ration =,e! save yo#r changes an reconstr#ct the HPI =,e. &o. start 0h#n er"ir an insta,, yo#r ne.,y mo i=e e1tension.

2009-2014 Inverse inc.

-9%o Integrator C#stomi8ation

Chapter :

" SOGo #$date Ser%er

In this section! yo# .i,, ,earn ho. to insta,, an con=g#re the -9%o 'p ate -erver. 0he -9%o 'p ate -erver can "e #se to a#tomatica,,y insta,, or #ninsta,, 7o8i,,a 0h#n er"ir e1tensions! p#sh #ser settings an more 5 a,, $rom a centra, p,ace manage "y system a ministrators.

Installation
Insta,,ation is re,ative,y straight$or.ar . Lo# nee to ma3e the updates.php script avai,a",e thro#gh yo#r E00P server at the '?* yo#Gve speci=e $rom the extensions.rdf =,e. 0he updates.php script can "e $o#n in the -9%o so#rces! #n er the Scripts irectory. 0he updateLin6 section o$ the 1m, pay,oa ret#rne to sogo-integrator is "#i,t ynamica,,y #sing the -C?IP0M'?I varia",e! .hich is on,y avai,a",e .hen r#nning .ith mo Mre.rite. It sho#, .or3 o#t o$ the "o1 as ,ong as the script is p,ace in the same irectory as the 1pi =,es. I$ it is not the case! then the ,in3 sho#, "e a K#ste to =t the act#a, =,e ,ayo#t:
<e :updateLin62<"php echo dirna e7getenv78S9R$/%(UR$8:: . 8/re!ative/path/to/8 . ;p!ugin<"fi!ena e"= "2</e :updateLin62

6n http reI#est simi,ar to the $o,,o.ing can "e #se to ma3e s#re that the generate ,in3 is correct :
http://sogo.host/path/to/updates.php"p!ugin=sogointegrator>inverse.ca*version=?.??

P,ease re$er to yo#r E00P server oc#mentation $or the insta,,ation an con=g#ration o$ PEP.

Con&guration
0o con=g#re the -9%o #p ate server! yo# nee to mo i$y the updates.php script irect,y. 6 ing an e1tension to "e p#she a#tomatica,,y "y the #p ate server reI#ire yo# to mo i$y Np,#gins array $rom updates.php an a,so a K#st accor ing,y -9%o IntegratorGs extensions.rdf =,e. 2009-2014 Inverse inc. -9%o 'p ate -erver <

Chapter : (or e1amp,e! to a#tomatica,,y insta,, -9%o Connector! -9%o Integrator an *ightning! yo# .o#, have :
;p!ugins = arra@7 "sogo-connector>inverse.ca" =2 arra@7 "app!ication" =2 "thunderbird"A "version" =2 "BC.?.C"A "fi!ena e" =2 "sogo-connector-BC.?.C.xpi" :A "sogo-integrator>inverse.ca" =2 arra@7 "app!ication" =2 "thunderbird"A "version" =2 "BC.?.C"A "fi!ena e" =2 "sogo-integrator-BC.?.C-sogo-de o.xpi" :A "DeBfdaEaC-FGBb-C?B?-bHad-aCEdfEIJJE?JK" =2 arra@7 "app!ication" =2 "thunderbird"A "version" =2 "B.G.B"A "fi!ena e" =2 "!ightning-B.G.C.xpi" ::+

0he synta1 is :
L<extension $)2M =2 arra@7 "app!ication" =2 "thunderbird"A "version" =2 "<exact version found in the extension8s insta!!.rdf fi!e2"A "fi!ena e" =2 "<exact fi!ena e on the fi!es@ste 2" :

0he path o$ the =,ename! speci=e in the "fi!ena e" parameter! is re,ative to the ,ocation o$ the updates.php script. (or e1tensions that are epen ant on the architect#re an operating system (7icroso$t >in o.s! 6pp,e 7ac 9- H! etc.)! they can "e p,ace in s#" irectories re,ative again to the updates.php script ("#t the =,ename m#st "e i entica, in a,, s#" irectories). (or e1emp,e! $or 7o8i,,a *ightning! .e co#, have :
)ar4in(xNG-gccJ/!ightning-B.G.C.xpi Linux(xNG-gccJ/!ightning-B.G.C.xpi Linux(xNG(GC-gccJ/!ightning-B.G.C.xpi O$..%(xNG- svc/!ightning-B.G.C.xpi

I$ yo# event#a,,y .ant to isa",e an e1tension! that is! .itho#t removing it $rom yo#r #sersG comp#ters! yo# can speci$y Odisab!edP as the version n#m"er. &e1t is to mo i$y the extensions.rdf =,e. 6gain! to a#tomatica,,y insta,, -9%o Connector! -9%o Integrator an *ightning! yo# .o#, have :
<!i2

<)escription e :id="DeBfdaEaC-FGBb-C?B?-bHad-aCEdfEIJJE?JK" e :na e="Lightning"/2 </!i2 <!i2 <)escription e :id="sogo-integrator>inverse.ca" e :na e="S-3o $ntegrator"/2 </!i2 <!i2

2009-2014 Inverse inc.

-9%o 'p ate -erver

Chapter :
<)escription e :id="sogo-connector>inverse.ca" e :na e="S-3o 9onnector"/2 </!i2

'sing -9%o Integrator! yo# can a,so p#sh #ser-settings $or any part o$ 0h#n er"ir or its e1tensions. 0here are t.o 3in o$ #ser-settings p#sh : -ettings that are p#she #ring the initia, con=g#ration o$ 0h#n er"ir -ettings that are p#she #pon every restart (ie.! $orce ) o$ 0h#n er"ir -ettings that p#she are p#she #ring initia, con=g#ration are contro,,e "y the
./defau!ts/preferences/site.5s =,e $rom -9%o Integrator. Eere is an e1amp,e : pref7"ca!endar.a!ar s.sho4 issed"A fa!se:+ pref7"ca!endar.ca!dav.sched.enab!ed"A true:+

Pre$erences that are $orce #pon every restart o$ 0h#n er"ir are contro,,e $rom the ./chro e/content/genera!/custo -preferences.5s con=g#ration =,e. Eere is an e1amp,e :
force(int(pref7"changequote.rep!@for at.for at"A ?:+ force(boo!(pref7"changequote.headers.4ithcc"A true:+

2009-2014 Inverse inc.

-9%o 'p ate -erver

10

Chapter ;

' Additional In(or!ation

(or more in$ormation! p,ease cons#,t the on,ine (6Qs ((reI#ent,y 6s3e Q#estions) : http://....sogo.n#/eng,ish/s#pport/$aI.htm, Lo# can a,so rea the mai,ing archives or post yo#r I#estions to it. (or etai,s! see : https://inverse.ca/sogo/,ists

2009-2014 Inverse inc.

itiona, In$ormation

11

Chapter A

) Co!!ercial Su$$ort and Contact

In(or!ation

(or any I#estions or comments! o not hesitate to contact #s "y .riting an emai, to : s#pportRinverse.ca Inverse (http://inverse.ca) o$$ers pro$essiona, services aro#n -9%o an (#nam"o, to he,p organi8ations ep,oy the so,#tion an migrate $rom their ,egacy systems.

2009-2014 Inverse inc.

Commercia, -#pport an Contact In$ormation

12