Create Your Own Server
Content
H O W - TO
W rit e n by D anie l am b t L
CREATE YO UR O W N SERV R - P rt 1 E a
Th is guide w ilbe gin at t e v ry s t , ins t l ion, and t e you t rough alt e s t ps t e v nt l h av l h e art al at ak h lh e o e ual y ing your ow n f l w ork ing ul y Ubunt s e rv r w h ich coul be us e d in your h om e or f a bus ine s s of any s ize . u e d or
W
e w ils t by l art dow nl oading Ubunt u 7.10 f rom h t p:/ w w w .ubunt t / u.com / t ge ubunt u/ dow nl and s e lct oad e f or 'St andard pe rs onal com put r' and e ch os e t e m os t appropriat m irror h e f you f or rom t e drop dow n m e nu. h
s upport of m os t m ode rn h ardw are and it w ilalo s upport t e ne w e s t l s h Raid s ys t m s and Gigabit ne t ork e w cards w h ich curre nt y 6.06 L (L l TS ong T rm Support doe s not h ow e v r e ) , e w it v rs ion 8.04 L t is s h oul be h e TS h d re -as s e s s e d. Af e r dow nl t oading Ubunt 7.10 u Se rv r you ne e d t w rit t e im age e o e h t CD us ing your f orit CD burning o av e program , if you are on w indow s you can l at us ing Inf ook rare corde r w h ich can be dow nl oade d f rom h t p:/ inf t / rare corde r ource f .s orge .ne t . / O nce you h av w rit e n t e im age e t h t CD pl your Ubunt Se rv r CD o ace u e int your driv and boot f o e rom it , e ns ure t at your s ys t m is s e t t h e o boot f rom CD . Y w ilt e n s e e t is ou lh h s cre e n (abov righ t e ).
Ch oos e 'Ins t lo t e h ard alt h dis k '. Th e ins t l ion w ilnow s t . al at l art F t you w ilh av t ch oos e your irs l e o l anguage , t e n s e lct your h e l ion. Ne xt ch oos e a k e yboard ocat l ayout you w ilne e d t pre s s a , l o f w k e ys s o t e ins t lr can e h al e de t ct your k e yboard l e ayout bas e d on t e k e ys you pre s s e d, h
I am ch oos ing Ubunt 7.10 u (Gut y Gibbon) f v s or arious re as ons but t e m ain re as on is h
22
or you can m anual ch os e w h at l y k e yboard you h av . e Th e ins t lr ch e ck s t e al e h ins t l ion CD , your h ardw are , al at and conf igure s t e ne t ork w it h w h D H CP if it is conne ct d t t e e o h ne t ork , or you can conf w igure t is h m anual l y. Now e nt r t e 'h os t e h nam e '. M y s ys t m is cal d e l e 's e rv r e .dom ain.l ', s o I e nt r ocal e 's e rv r'. e
O pe nSSH , print and SAM BA s e rv rs . Se lct t e dif e re nt e e h f s e rv rs us ing t e s pace k e y t e n e h h cont inue .
W h e n you are re ady, h it 'Y s ' t e o 'W rit t e ch ange s t dis k s ? Now e h o ' your part ions w ilbe cre at d and it l e f orm at e d. t Se t t e s ys t m cl . Norm al up h e ock l y UTC is a s af ch oice . e Ne xt cre at a ne w us e r, I us e t e e h nam e 'Adm inis t or' w it t e us e r rat h h nam e 'adm inis t or'. D on't us e t e rat h us e r nam e 'adm in' as t at is a h s ys t m nam e in Ubunt e u.
Th e GRUB boot l oade r w ilnow l be ins t ld. al e Th e ins t l ion is now al at f h e d. Re m ov your CD f inis e rom t e driv and h it 'Cont h e inue ' t o re boot t e s ys t m . h e
Now you w ilne e d t part ion l o it your dis k , lt t e s e t cre at t e e h up e h part ions (s w ap and root it ) aut at l unls s you are om ical y e conf nt on doing t is m anual ide h l y.
Th e bas e s ys t m w ilnow be e l ins t ld. al e Now w e ge t t e opt h ion of w h at e xt s of w are ge t ins t ld, w e are ra t s al e going t ch oos e D NS, m ailL P, o , AM
Th at is t e f t part of t e h irs h Ubunt s e rv r ins t ld. Ne xt u e al e is s ue , w e w ilcov r updat s , l e e ins t l t e Xubunt de s k t al ing h u op and alo t e w e bm in ins t l s h al .
23
H O W - TO
W rit e n by D anie l am b t L
CREATE YO UR O W N SERV R - P rt 2 E a
Now t e Ubunt s e rv r ins t l ion is com plt w e w ilins t l ce de s k t h u e al at e e l alXf op, W e bm in and alo s of w are updat s f s t e rom t e com m and h l as w e las w it t e updat m anage r w h ich w ilbe builint t e Xubunt de s k t ine l h h e l t o h u op.
A
f e r re boot t ing t e PC af e r h t t e ins t ll h al ogin us ing your , ch os e n us e r nam e and pas s w ord. Th e f t it m t be addre s s e d is irs e o conf iguring of t e s ource s . W e w il h l re m ov t e CD re pos it e h ory (w h ich aut at l ge t adde d t t e om ical y s o h s ource s ) and add w e b bas e d s ource s . T do t is w e w ilus e nano, m y o h l pe rs onalav e , if you h av a f orit e pre f rre d t xt e dit plas e us e e e or e t at T h . ype int t e com m and l : o h ine sudo nano /etc/apt/sources.list Y w ilne e d t s uppl t e ou l o y h pas s w ord you s e t as your us e r pas s w ord as you are running a
com m and as root Add a h as h (# ) in . f ront of t e CD e nt and re m ov t e h ry e h h as h e s f rom t e f h ront of t e ot e r h h e nt s . Af e r com plt rie t e ing t is s t p h e pre s s CTRL X t e n pre s s 'Y' or t + h ype 'ye s ' t s av ch ange s . o e
Af e r com plt t e ing t is , t h ype : sudo apt-get update Th is w ilupdat t e apt s ource s l e h and apt w ilt e n k now w h at s of w are lh t it can ge t Now t . ype : sudo apt-get upgrade T ins t lh e l e s t updat s t your o alt at e o s ys t m . Th is m ay t e a lt e w h il e ak it l e de pe nding on h ow m any updat s are e ne e de d f your s ys t m , you m igh t or e w ant t put t e k e t l on now . o h te
Af e r t e updat s are f h e d, t h e inis re s t your m ach ine . L in and art og run t e s am e com m and j t in h us cas e t e re are any ot e r updat s h h e t at w e re m is s e d, al ough apt h t h is unl e l t m is s any. Af e r t is ik y o t h is f h e d, w e is s ue w h at w ilbe inis l our l t com m and f t is t is as or h h is s ue : sudo apt-get install xubuntu-desktop Ans w e r 'ye s ' t 'D o you w ant o: t cont o inue '. Go and re ad t e h
13
re s t of t is is s ue , and h av a nice h e cup of t a. e Af e r t is h as com plt d, re boot t h e e your m ach ine . O nce t e m ach ine h h as s t e d up you w ilbe art l pre s e nt d w it t e e h h l ogin s cre e n. L in us ing your pre v og ious l y ch os e n us e r nam e and pas s w ord and you w ilbe pre s e nt d w it t e l e h h Xubunt de s k t u op, you now ne e d t run t e updat s by righ t o h e cl ing on t e orange icon in t e ick h h t righ t h and corne r and cl op ick 'Ins t l l alalupdat s ', t e n s uppl e h y your pas s w ord t al t e o l h ow updat s t run. Al rnat e l you e o t e iv y, can pre s s Ct + Al F2 and l rl t + ogin us ing your us e r nam e and pas s w ord again and run t e h updat s f e rom t e com m and l . h ine Af e r t is is f h e d re s t your t h inis art m ach ine . O nce l ogge d in, ope n F f and brow s e t ire ox o h t p:/ w w w .w e bm in.com /(abov t / e righ t and in t e m e nu on t e lf , ) h h e t cl 'D e bian P age '. ick ack W h e n t e .de b f e h as f h e d h il inis dow nl oading, righ t cl on it and ick
Ful Circl is l e l ing f ook or proof re ade rs . Can you s pare a f w days e ach m onth to e proof re ad articls f us ? e or If you can, plas e e m ail e : ronnie @ f l e m agazine . ul circl org f m ore de tail. or s
or j oin our IRC ch anne l : l on t irc.f e node .ne t and og o re j oin # f l e m agazine ul circl O r, you can v it v our is ia w e bIRC cl nt at ie irc.f l e m agazine .org ul circl W e alo h av a f s e orum at : h t p:/ ubunt orum s .org/ orum t / uf f dis pl ay.ph p?=270 f
ch oos e t ope n w it o h and cl O K. Th e 'P age Ins t lr' w il ick ack al e l t e n ope n and you can s im pl cl h y ick 'Ins t l ack age '. Th e pack age alP m anage r w ilalo ins t l lh e l s alalt ne e de d de pe nde ncie s f W e bm in. or O nce W e bm in h as ins t ld, go t al e o: h t ps :/ l h os t t /ocal :10000 and l in og us ing your us e r nam e and pas s w ord.
,
w w w .f l e m agazine .org ul circl
14
H O W - TO
W rit e n by D anie l am b t L
CREATE YO UR O W N SERV R - P rt 3 E a
W
e now h av a w ork ing e s e rv r w it t e bas e e h h s ys t m , Sam ba, SSH , e Xubunt de s k t and W e bm in al u op l ins t ld;w e w ilnow ins t l al e l al D H CP, and conf igure D H CP and Sam ba. W e 'ls t of w it D H CP l art f h . L int W e bm in by going t og o o h t ps :/ l h os t t /ocal :10000 Go t “ Se rv rs ” , t e n “ D H CP” . o e h Cl on " ick Add a ne w s ubne t , and " f l t e de s cript ilin h ion of t e h s ubne t F ne t ork addre s s , us e . or w t e s am e IP as t e int rnal h h e addre s s , but us e 0 as t e e nding h oct t f e xam pl, if your int rnal e ; or e e NIC is 19 2.168.1.1, t e n us e h 19 2.168.1.0 f your ne t ork or w addre s s . F addre s s range s , us e or t e range of addre s s e s t be h o as s igne d by D H CP F ne t as k , . or m us e t e s am e as your s ubne t h ; m os t are 255.255.255.0. Cl ick " at " Cre e . Now t conf o igure Sam ba f e il s h are s . O nce cre at d, cl t e ne w icon e ick h t at w as j t cre at d (w it t e h us e h h ne t ork addre s s you ch oos e unde r w it Scroldow n t t e bot om , and ). l o h t cl " ick Edit Cl nt O pt ie ions " F l t e . ilin h Subne t m as k w it t e s ubne t t e h h ;h D e f t rout rs and D NS s e rv rs w it aul e e h your int rnal and t e Broadcas t e IP; h addre s s w it t e int rnal - but w it h h e IP h 255 at t e e nd. Cl " e "t e n h ick Sav h s t t e s e rv r art h e . F t of al cre at a f de r on irs l , e ol your s e rv r I w oul norm al e . d l y cre at one w it in a s t e h andard us e r's h om e f de r, s o t e ol h dire ct ory l t is ing w oul be d / om e / s h are -nam e . L t s t H / e 's art by cal one “ Sh are d” ;brow s e l ing t t e m ain H om e f de r, and o h ol t e n dow n t t e f de r nam e d h o h ol w it your e xis t h ing us e rnam e ; righ t cl , and ch oos e “ Cre at ick e F de r” . Nam e t e ne w f de r ol h ol “ Sh are d” , and e ns ure t at t e h h
18
pe rm is s ions of t e ne w f de r h ol al re ad and w rit acce s s by al l ow e l us e rs - as s h ow n be l . ow
Now cl on F e pe rm is s ions , ick il and ch ange t e Ne w Unix f e h il m ode t 777 and t e Ne w Unix o h dire ct ory m ode t 777. Cl o ick " e" Sav . Re s t Sam ba, and you art s h oul now be abl t w rit t d e o e o your s h are .
Sam ba w ilnow h av a s h are d l e f de r t at you can brow s e t ol h o. H ow e v r, you w ilnot be abl t e l e o acce s s it unt you cl on t e s h are , il ick h s e lct Se curit and Acce s s cont , e y rol ch ange t e s h are t W rit e , e nabl h o abl e Gue s t acce s s , and t e n cl " e " h ick Sav .
NEXT M ONTH :
SP CI LBI TH D AY I SUE! E A R S
w h e re w e dis cus s t e birt of h h , h ow w e m anage d t ov r com e s om e of our bigge s t h urdls in o e e cre at ing and organizing FCM and s om e ge e k y dow nl s t s . oad at - Th e GIM P . incl s cre at ude ing a ne w im age , dpi and t e m os t im port h ant t s ne e de d f our ool or f ure GIM P s e s s ions . ut
Now go back t W e bm in, go t o o “ Se rv rs ” , and t e n “ Sam ba e h W indow s F e s h aring” . Se lct il e “ Cre at a ne w f e Sh are ” ;nam e e il t e f e s h are “ Sh are d” and s e lct h il e t e dire ct h ory you w is h t s h are . o F l a Sh are Com m e nt if you ilin w is h , and cl “ Cre at ” . ick e
19
W rit e n by D anie l am b t L
H O W - TO
CREATE YO UR O W N SERV R - P rt 4 E a
Brow s e t o ,t en h . F t w e w ilcre at our irs l e PPP (P oint o-P -t oint P ocol rot ) account , s o cl on s ick ;add a ne w us e r cal d l e , w it a pas s w ord of h ;t e n h cl ick and cl ick . W it in t e inde x of t at m odul, cl h h h e ick on ;f l t e ilin h box w it t e cl nt e nd IP h h ie addre s s ;and f l ilin w it t e IP h h addre s s e s t be as s igne d t t e o o h cl nt m ach ine com ing in v t e ie ia h V PN. Cl ick . Th e n, ope n ;ch ange t o ;ch ange t o ; ch ange t o ; dis abl e and ;and t e re s t can s t on de f t Cl h ay aul ick . , and cl ick . W e w ilnow s e t up m onit l oring f or t e s ys t m . W it in h e h , go t o , and . Cl on ick ;s e lct e f or ; ch ange t te o h f q ue ncy f ch e ck ing t e re or h s e rv r - e v ry 5 m inut s is a e e e good t e f im ram e , j t in cas e us t e re are any problm s or any h e s e rv ice f t . Se t aul s t o 0 s o t at it runs e xact y e v ry 5 h l e m inut s . M ak e s ure alt e h ours e lh and days are s e lct d - t s e lct e e o e m ore t an one , us e t e 'Ct ' k e y h h rl w h il you s e lct t e m . e e h Ch ange t o
N
ow t at w e h av Sam ba, h e D H CP and W e bm in ins t ld and w ork ing, w e al e w ils e t up a V s e rv r t l PN e o m onit t e v or h arious running s e rv s . ice O ur f t s t p is s e t ing up a irs e t V (V ual riv e Ne t ork ) PN irt P at w us ing (P oint o-P -t oint T unne l P ocolprov d by l ing rot ) ide t e popt t am . Th is can alo be h op e s conf igure d by . T st o art of , w e w ilne e d t ins t lh e f l o alt PPTP s e rv r, as f l s : e ol ow sudo apt-get install pptpd (or us e your pack age m anage r and s e arch f popt or ppt or op p) W h e n prom pt d, h it e nt r, and e e apt t w ilins t l -ge l al and al l it de pe nde ncie s . s Now , act at W e bm in by going iv e t o: h t ps :/ l h os t t /ocal :10000
or w h ich e v r you f e l m ore e e is appropriat t your s ys t m . e o e Ch ange t o , and f l ilin your e m ail addre s s . Cl ick . Y can alo ch ange ou s t an SM TP s e rv r w h ich o e doe s n't re q uire aut e nt h icat ion,
11
ot e rw is e s e lct l h os t us ing h e ocal , 'P t ix' or 'Se ndm ail- w e w ilbe os f ' l s e t ing up P t ix in f ure is s ue s . t os f ut Se e m y s e t be l : up ow
Y can alo ch e ck your s ys t m ou s e l by cl ing on ogs ick and going t o (be l ) - in t e re you ow h can cl on a l f e and cl ick og il ick .
W it in t e h h and page s , you can add v arious m onit oring opt ions f rom t e drop h dow n l t you can alo de lt is , s e e t e m by t ing t e adj nt radioh ick h ace box and cl ing D e lt . ick e e
ow ns and runs and is bas e d in P rt , Scot and. H e is alo e h l s inv v d in a num be r of ope n ole s ource proj ct s uch as e s , and . H e is alo a com m it e d L e ds s t e Unit d f e an.
TH E H ERO N H A S L ND ED .D O W NL A D 8. 4! A O 0
w w w .ubunt u.com
w w w .k ubunt u.com
w w w .xubunt u.com
w w w .ubunt u.com
12
Written by Daniel Lamb
HOW-TO
CREATE YOUR OWN SERVER - Part 5
backup of directory'; you will now be greeted with the page shown below right. In the 'Directories to backup', you can fill in multiple directories, with each directory having its own line. In the 'Backup to' box, choose the mount point, and the name of the backup to create; ie, if it is a tape drive, it might be: /dev/st0/<nameofback up>.tar.gz (only if using tar and compression -- which is an option further down the page). You could also choose to backup to a remote location using RSH, SSH or FTP. In that case, choose (rather than file or tape device), and fill in your FTP/RSH/SSH details. Now choose a suitable name for your backup, and fill it in as 'Backup Label'. If you wish to omit any files or directories (within your selected backup directories) supply them. Choose your compression options from Compress Archive -- 'Yes with gzip' is recommended. In the boxes 'Command to run before
N
ow, before we do much more with the server, we are going to configure backups -- so all files and data are protected. We will use the webmin module to configure tar backups; you can use tar backups to save to tape, or to any other form of removable media. Under the System menu in webmin, you should have Filesystem, Backup -or, with the new webmin 1.410, you might need to look under Unused Modules to find it. To add a new backup, fill in the box with a directory, or, to browse your drive, click on the '...' button (shown below).
Tick the tar format if you wish the backup to be in that compressed format, otherwise it will just be a direct dump without compression. After filling in the directory box, click on 'Add a new
14
backup' and 'Command to run after backup', add any required commands. You should now set up a backup schedule (shown below). To do so, select 'Enabled, at times chosen below'. To have yourself (or someone else) informed when backup is running, insert a valid email address into 'Email scheduled output to'. A simple approach is to select 'Simple schedule', choose 'Daily, at midnight', and click 'Create'. We now have an automatically scheduled daily backup to save your most important data and files.
We will now install Postfix (email server) and Dovecot (IMAP and POP3 server). We must drop to the command line, and type: sudo apt-get install postfix dovecot-common dovecot-imapd Answer the questions as follows: Internet Site NONE server1.example.com server1.example.com, example.com, localhost.example.com, localhost No 127.0.0.0/8 Yes 0 + all You now have Postfix and Dovecot installed --
with IMAP. I would suggest you now set up an MX record pointing to your IP address, and change your router to forward SMTP (port 25) traffic, through your router, to your server IP address. This will allow us to use postfix to collect and deliver email directly via SMTP.
owns and runs and is based in Perth, Scotland. He is also involved in a number of open source projects such as , and . He is also a committed Leeds United fan.
15
Written by Daniel Lamb
HOW-TO
CREATE YOUR OWN SERVER - Part 6
N
ow we can start setting up email on our server. I suggest using IMAP and SMTP for sending and receiving email. You should have installed Postfix and Dovecot. You still need to install fetchmail - which will collect any email not received by SMTP. To collect emails by SMTP, you need to set up an MX record (read more about this here http://www.petri.co.il/configure_mx _records_for_incoming_smtp_email _traffic.htm) with the provider of your domain name - it forwards emails to your home IP address. You need to forward SMTP through the firewall on your router to the IP address of your server - to do this, refer to your user manual for your router/firewall. The only changes you will need to make in the Postfix configuration is under Local Delivery: change "Home-relative pathname of user mailbox file" to Maildir, and under "SMTP
Authentication And Encryption", put a tick in the box to "Allow connections from same network", and "Allow connections from this system" under the heading "SMTP relaying restrictions". In the Dovecot IMAP/POP3 server menu, click on Mail Files, and change the radio button option under Mail file location to “Inbox in ~/Maildir, folders in ~/mail”. If you have any other email that needs to be picked up via POP3, you should now install fetchmail by typing:
sudo apt-get install fetchmail Now, open up "Fetchmail Mail retrieval" (Fig.1 above) in Webmin, and click on "..." and "Add Fetchmail server for user". Fill in the box for "Server name", add a username and password (which will be supplied by your ISP or your web site provider), and choose which local users you want the email to be distributed to.
12
One item which should have been configured previously is DNS - to set this up, click on Bind DNS in Webmin. Click on "Create master zone". Enter the domain into the "Domain name / network" box. For the master server, type in the domain name as well. Enter a suitable email address in the appropriate box. Type in the IP address of the server (the external IP address provided by your ISP) and finally, click "Create".
Add any users who are permitted to access the system these are users who can access email, samba shares and so on. You can now install (right), which will allow you to view webmail and also connect to shared calendars and shared contacts. To install , open a console and type: sudo apt-get install egroupware We will deal with configuring for next month.
owns and runs and is based in Perth, Scotland. He is also involved in a number of open source projects such as , and . He is also a committed Leeds United fan.
13
Written by Daniel Lamb
HOW-TO
CREATE YOUR OWN SERVER - Part 7
The script will run through some preinstallation tests. Some of the items will pass and some will have warnings. Click the 'continue to the Header Admin' link at the bottom to continue. You should now be on the setup page. The 'Server Root' and 'Include Root' should be correct. You can leave the admin user set to 'admin' and create a password. This will be the account you use to login to the header manager. Change 'Persistent Connections' to 'False'. Scroll down to the database information section, and enter the information for the database you created in step #1. In this example, we'll use the following information:
- Stays the same. - Stays the same.
W
e are now going to install eGroupware onto your server. This will give us a groupware server which can function like Exchange by connecting an email client such as Thunderbird to it via IMAP, and connecting Sunbird to the calendaring service via icalsrv. First of all, we will need to copy icalsrv into the eGroupware installation folder. To do this, use these commands: wget http://downloads.sourceforge. net/egroupware/eGroupWare1.4.004.zip?modtime=120830122 9&big_mirror=1 unzip eGroupWare-1.4.004.zip and now cp eGroupWare1.4.004/icalsrv /usr/share/egroupware -r Now we can access the installer. In this example, we'll point to:
http://yourserver/egroupware/setup/.
This should be setup via mysql server settings within webmin. Choose a username and password for the 'Configuration User'. This is the account you'll use to manage the configuration. For this example, we'll use the same username and password as the header manager. Click the 'Write config' button to create the header file. You should get a screen saying that your header file was created. You should now be on the eGroupware login page for the control panel. Enter the admin information into the Setup/Config fields to login to the setup control panel. Click the 'Login' button to continue. You should now be on the setup screen for your eGroupware. It will tell you that the database is working but you
13
don't have any tables installed. Click the 'Install' button to create the core tables. The script will create the core tables. If you don't receive any error messages, then it was successful. Click the 'Re-check My Installation' button to continue. The setup page will refresh and you'll see that all of the stages have been complete. Click on the 'Click here to setup 1 admin account and 3 demo accounts' link to continue. Enter the information you would like to have for your admin account. Check the 'Create demo accounts' checkbox to create the demo accounts.
Click the 'Save' button to save these settings. You should now be back at the eGroupware setup page. Click the 'Back to user login' link at the top left of the screen. If you get an error message saying that the lock function failed, create a support ticket on the help page with the name of your database, and lock access will be granted to your database. Refresh the page once lock access has been granted. You should now be at the login page. Enter the information you created for your admin account.
[email protected]
Click the 'Login' button to login to your eGroupware. You should now be at the admin control panel for your eGroupware management system. eGroupware is now installed.
owns and runs and is based in Perth, Scotland. He is also involved in a number of open source projects such as , and . He is also a committed Leeds United fan.
14
Written by Daniel Lamb
HOW-TO
CREATE YOUR OWN SERVER - Part 8
defaults should be fine for anyone to use. There are also preferences for which any users can set themselves. Again, the defaults are fine, but you might choose to change them depending on the use you have planned for them. A request I received from Philipp Hohn was how to connect and to eGroupwares ical server. To get a list of calendars (below), go to the URL: http://servername/egroupware/icalsrv .php/username/list.html Ensure the user has permissions to use the ical server. You can do this via the User Accounts tab from the Admin menu, then click on the user you wish to have permissions for this, or do it via the groups menu. My user is called manager, so if I type in: http://server/egroupware/icalsrv.p hp/manager/list.html I get a number of calendars showing up. I want to use the main-events calendar, so in , under the calendar option (as long as you have lightening installed, there are loads of guides how to do this on the Web), I would simply right click and select New Calendar, choose 'On The Network' then enter the URL: http://10.0.165.15/egroupware/ic alsrv.php/manager/events.ics Click 'Next' then choose your
W
e are now going to add users to eGroupware and give them permissions to various items. To add a user, log into your eGroupware install with the admin user you created before. Browse to Admin, click on Admin, and fill in the boxes as you wish, I suggest putting a tick in the box "Never Expires". You can also give the users different permissions. You may want some to be able to view only emails, whereas you may wish to give full control to others. After adding a user, remember to click "Add". You now want to add a group. You can use the default group for everyone, or use the Admin group if you wish. You will see under Admin a large number of options depending on what you want to do. Go through the different options there, although the
12
preferred name for the calendar. When prompted, enter the username and password for the account. We are now going to install . Some of you may not use it, but in a business environment it is invaluable.
mv doc_download.html doc_download.zip apt-get install unzip unzip doc_download.zip You will now have a new folder called Quotero_Bundle_0.6. We want to move that file to /usr/share/Quotero. To do this, use this command: mv Quotero_Bundle_0.6/ /usr/share/Quotero -r As Quotero uses sh files you need to make them executable. Again, to do this for all the files type in the following commands:
run which depends on java so we need to install java and set it so tomcat knows it’s the default java environment. Do this by typing: apt-get install sun-java6bin update-java-alternatives -s java-6-sun Now you can start Quotero with this command: Sudo ./usr/share/Quotero/Quotero. sh Now browse to the URL for Quotero to continue the install: http://servername:8080/Quotero Deploy All the default settings are fine except for changing the Database type to HSQL, leave the default Database Username, Password and Name as it is. Fill in the SMTP username and password. Then click Validate. It will now carry out the install for you. Once it has come up with the message 'Enjoy, click on Let’s go Quotero...'
To do this we are going to drop to the command line again and enter the following command to download it. wget http://www.quotero.com/downlo ads/doc_download.html As it is automatically downloaded as an HTML file we need to rename it to a zip file and extract it. To do this, we type in the following commands:
chmod +x /usr/share/Quotero/quotero_tomc at/bin/startup.sh chmod +x /usr/share/Quotero/Quotero.sh chmod +x /usr/share/Quotero/quotero_tomc at/bin/catalina.sh chmod +x /usr/share/Quotero/quotero_tomc at/bin/setclasspath.sh Quotero uses Tomcat Apache to
13
You can now log in using the URL: http://servername:8080/QuoteroCli ent/login.jsp and the username "admin" and password "admin". To add users, click on Administration, expand domains, then HQUOTERO, click on users. You can add new users here using the button Add. Under Special Roles you can add various users with different permissions for different tasks. Under Quotero Server v0.6, click on this button and choose New workspace, name it whatever you wish and add permissions for
the various users you have created. By clicking on the button you can add a new folder by clicking on New folder, and call it what you wish, and add relevant permissions. You can now upload documents by clicking on the button next to the folder name and select Import Document. The Document will now be in the folder. You can now check out this document, open it just to view it or start a workflow involving the document (as well as a number of other options) or any others you add. You can check out a document then check it back in again, which will mean only one person can use it at a time. This is very powerful software and can save businesses a lot of time.
owns and runs and is based in Perth, Scotland. He is also involved in a number of open source projects such as , and . He is also a committed Leeds United fan.
on UbuntuForums.org, and IRC on the irc.freenode.net server, channel: #fullcirclemagazine
keep up to date with our adventures via http://twitter.com/fullcirclemag
full circle magazine
www.fullcirclemagazine.org
14
W rit e n by D anie l am b t L
CREATE YO UR O W N SERV R - P rt 1 E a
Th is guide w ilbe gin at t e v ry s t , ins t l ion, and t e you t rough alt e s t ps t e v nt l h av l h e art al at ak h lh e o e ual y ing your ow n f l w ork ing ul y Ubunt s e rv r w h ich coul be us e d in your h om e or f a bus ine s s of any s ize . u e d or
W
e w ils t by l art dow nl oading Ubunt u 7.10 f rom h t p:/ w w w .ubunt t / u.com / t ge ubunt u/ dow nl and s e lct oad e f or 'St andard pe rs onal com put r' and e ch os e t e m os t appropriat m irror h e f you f or rom t e drop dow n m e nu. h
s upport of m os t m ode rn h ardw are and it w ilalo s upport t e ne w e s t l s h Raid s ys t m s and Gigabit ne t ork e w cards w h ich curre nt y 6.06 L (L l TS ong T rm Support doe s not h ow e v r e ) , e w it v rs ion 8.04 L t is s h oul be h e TS h d re -as s e s s e d. Af e r dow nl t oading Ubunt 7.10 u Se rv r you ne e d t w rit t e im age e o e h t CD us ing your f orit CD burning o av e program , if you are on w indow s you can l at us ing Inf ook rare corde r w h ich can be dow nl oade d f rom h t p:/ inf t / rare corde r ource f .s orge .ne t . / O nce you h av w rit e n t e im age e t h t CD pl your Ubunt Se rv r CD o ace u e int your driv and boot f o e rom it , e ns ure t at your s ys t m is s e t t h e o boot f rom CD . Y w ilt e n s e e t is ou lh h s cre e n (abov righ t e ).
Ch oos e 'Ins t lo t e h ard alt h dis k '. Th e ins t l ion w ilnow s t . al at l art F t you w ilh av t ch oos e your irs l e o l anguage , t e n s e lct your h e l ion. Ne xt ch oos e a k e yboard ocat l ayout you w ilne e d t pre s s a , l o f w k e ys s o t e ins t lr can e h al e de t ct your k e yboard l e ayout bas e d on t e k e ys you pre s s e d, h
I am ch oos ing Ubunt 7.10 u (Gut y Gibbon) f v s or arious re as ons but t e m ain re as on is h
22
or you can m anual ch os e w h at l y k e yboard you h av . e Th e ins t lr ch e ck s t e al e h ins t l ion CD , your h ardw are , al at and conf igure s t e ne t ork w it h w h D H CP if it is conne ct d t t e e o h ne t ork , or you can conf w igure t is h m anual l y. Now e nt r t e 'h os t e h nam e '. M y s ys t m is cal d e l e 's e rv r e .dom ain.l ', s o I e nt r ocal e 's e rv r'. e
O pe nSSH , print and SAM BA s e rv rs . Se lct t e dif e re nt e e h f s e rv rs us ing t e s pace k e y t e n e h h cont inue .
W h e n you are re ady, h it 'Y s ' t e o 'W rit t e ch ange s t dis k s ? Now e h o ' your part ions w ilbe cre at d and it l e f orm at e d. t Se t t e s ys t m cl . Norm al up h e ock l y UTC is a s af ch oice . e Ne xt cre at a ne w us e r, I us e t e e h nam e 'Adm inis t or' w it t e us e r rat h h nam e 'adm inis t or'. D on't us e t e rat h us e r nam e 'adm in' as t at is a h s ys t m nam e in Ubunt e u.
Th e GRUB boot l oade r w ilnow l be ins t ld. al e Th e ins t l ion is now al at f h e d. Re m ov your CD f inis e rom t e driv and h it 'Cont h e inue ' t o re boot t e s ys t m . h e
Now you w ilne e d t part ion l o it your dis k , lt t e s e t cre at t e e h up e h part ions (s w ap and root it ) aut at l unls s you are om ical y e conf nt on doing t is m anual ide h l y.
Th e bas e s ys t m w ilnow be e l ins t ld. al e Now w e ge t t e opt h ion of w h at e xt s of w are ge t ins t ld, w e are ra t s al e going t ch oos e D NS, m ailL P, o , AM
Th at is t e f t part of t e h irs h Ubunt s e rv r ins t ld. Ne xt u e al e is s ue , w e w ilcov r updat s , l e e ins t l t e Xubunt de s k t al ing h u op and alo t e w e bm in ins t l s h al .
23
H O W - TO
W rit e n by D anie l am b t L
CREATE YO UR O W N SERV R - P rt 2 E a
Now t e Ubunt s e rv r ins t l ion is com plt w e w ilins t l ce de s k t h u e al at e e l alXf op, W e bm in and alo s of w are updat s f s t e rom t e com m and h l as w e las w it t e updat m anage r w h ich w ilbe builint t e Xubunt de s k t ine l h h e l t o h u op.
A
f e r re boot t ing t e PC af e r h t t e ins t ll h al ogin us ing your , ch os e n us e r nam e and pas s w ord. Th e f t it m t be addre s s e d is irs e o conf iguring of t e s ource s . W e w il h l re m ov t e CD re pos it e h ory (w h ich aut at l ge t adde d t t e om ical y s o h s ource s ) and add w e b bas e d s ource s . T do t is w e w ilus e nano, m y o h l pe rs onalav e , if you h av a f orit e pre f rre d t xt e dit plas e us e e e or e t at T h . ype int t e com m and l : o h ine sudo nano /etc/apt/sources.list Y w ilne e d t s uppl t e ou l o y h pas s w ord you s e t as your us e r pas s w ord as you are running a
com m and as root Add a h as h (# ) in . f ront of t e CD e nt and re m ov t e h ry e h h as h e s f rom t e f h ront of t e ot e r h h e nt s . Af e r com plt rie t e ing t is s t p h e pre s s CTRL X t e n pre s s 'Y' or t + h ype 'ye s ' t s av ch ange s . o e
Af e r com plt t e ing t is , t h ype : sudo apt-get update Th is w ilupdat t e apt s ource s l e h and apt w ilt e n k now w h at s of w are lh t it can ge t Now t . ype : sudo apt-get upgrade T ins t lh e l e s t updat s t your o alt at e o s ys t m . Th is m ay t e a lt e w h il e ak it l e de pe nding on h ow m any updat s are e ne e de d f your s ys t m , you m igh t or e w ant t put t e k e t l on now . o h te
Af e r t e updat s are f h e d, t h e inis re s t your m ach ine . L in and art og run t e s am e com m and j t in h us cas e t e re are any ot e r updat s h h e t at w e re m is s e d, al ough apt h t h is unl e l t m is s any. Af e r t is ik y o t h is f h e d, w e is s ue w h at w ilbe inis l our l t com m and f t is t is as or h h is s ue : sudo apt-get install xubuntu-desktop Ans w e r 'ye s ' t 'D o you w ant o: t cont o inue '. Go and re ad t e h
13
re s t of t is is s ue , and h av a nice h e cup of t a. e Af e r t is h as com plt d, re boot t h e e your m ach ine . O nce t e m ach ine h h as s t e d up you w ilbe art l pre s e nt d w it t e e h h l ogin s cre e n. L in us ing your pre v og ious l y ch os e n us e r nam e and pas s w ord and you w ilbe pre s e nt d w it t e l e h h Xubunt de s k t u op, you now ne e d t run t e updat s by righ t o h e cl ing on t e orange icon in t e ick h h t righ t h and corne r and cl op ick 'Ins t l l alalupdat s ', t e n s uppl e h y your pas s w ord t al t e o l h ow updat s t run. Al rnat e l you e o t e iv y, can pre s s Ct + Al F2 and l rl t + ogin us ing your us e r nam e and pas s w ord again and run t e h updat s f e rom t e com m and l . h ine Af e r t is is f h e d re s t your t h inis art m ach ine . O nce l ogge d in, ope n F f and brow s e t ire ox o h t p:/ w w w .w e bm in.com /(abov t / e righ t and in t e m e nu on t e lf , ) h h e t cl 'D e bian P age '. ick ack W h e n t e .de b f e h as f h e d h il inis dow nl oading, righ t cl on it and ick
Ful Circl is l e l ing f ook or proof re ade rs . Can you s pare a f w days e ach m onth to e proof re ad articls f us ? e or If you can, plas e e m ail e : ronnie @ f l e m agazine . ul circl org f m ore de tail. or s
or j oin our IRC ch anne l : l on t irc.f e node .ne t and og o re j oin # f l e m agazine ul circl O r, you can v it v our is ia w e bIRC cl nt at ie irc.f l e m agazine .org ul circl W e alo h av a f s e orum at : h t p:/ ubunt orum s .org/ orum t / uf f dis pl ay.ph p?=270 f
ch oos e t ope n w it o h and cl O K. Th e 'P age Ins t lr' w il ick ack al e l t e n ope n and you can s im pl cl h y ick 'Ins t l ack age '. Th e pack age alP m anage r w ilalo ins t l lh e l s alalt ne e de d de pe nde ncie s f W e bm in. or O nce W e bm in h as ins t ld, go t al e o: h t ps :/ l h os t t /ocal :10000 and l in og us ing your us e r nam e and pas s w ord.
,
w w w .f l e m agazine .org ul circl
14
H O W - TO
W rit e n by D anie l am b t L
CREATE YO UR O W N SERV R - P rt 3 E a
W
e now h av a w ork ing e s e rv r w it t e bas e e h h s ys t m , Sam ba, SSH , e Xubunt de s k t and W e bm in al u op l ins t ld;w e w ilnow ins t l al e l al D H CP, and conf igure D H CP and Sam ba. W e 'ls t of w it D H CP l art f h . L int W e bm in by going t og o o h t ps :/ l h os t t /ocal :10000 Go t “ Se rv rs ” , t e n “ D H CP” . o e h Cl on " ick Add a ne w s ubne t , and " f l t e de s cript ilin h ion of t e h s ubne t F ne t ork addre s s , us e . or w t e s am e IP as t e int rnal h h e addre s s , but us e 0 as t e e nding h oct t f e xam pl, if your int rnal e ; or e e NIC is 19 2.168.1.1, t e n us e h 19 2.168.1.0 f your ne t ork or w addre s s . F addre s s range s , us e or t e range of addre s s e s t be h o as s igne d by D H CP F ne t as k , . or m us e t e s am e as your s ubne t h ; m os t are 255.255.255.0. Cl ick " at " Cre e . Now t conf o igure Sam ba f e il s h are s . O nce cre at d, cl t e ne w icon e ick h t at w as j t cre at d (w it t e h us e h h ne t ork addre s s you ch oos e unde r w it Scroldow n t t e bot om , and ). l o h t cl " ick Edit Cl nt O pt ie ions " F l t e . ilin h Subne t m as k w it t e s ubne t t e h h ;h D e f t rout rs and D NS s e rv rs w it aul e e h your int rnal and t e Broadcas t e IP; h addre s s w it t e int rnal - but w it h h e IP h 255 at t e e nd. Cl " e "t e n h ick Sav h s t t e s e rv r art h e . F t of al cre at a f de r on irs l , e ol your s e rv r I w oul norm al e . d l y cre at one w it in a s t e h andard us e r's h om e f de r, s o t e ol h dire ct ory l t is ing w oul be d / om e / s h are -nam e . L t s t H / e 's art by cal one “ Sh are d” ;brow s e l ing t t e m ain H om e f de r, and o h ol t e n dow n t t e f de r nam e d h o h ol w it your e xis t h ing us e rnam e ; righ t cl , and ch oos e “ Cre at ick e F de r” . Nam e t e ne w f de r ol h ol “ Sh are d” , and e ns ure t at t e h h
18
pe rm is s ions of t e ne w f de r h ol al re ad and w rit acce s s by al l ow e l us e rs - as s h ow n be l . ow
Now cl on F e pe rm is s ions , ick il and ch ange t e Ne w Unix f e h il m ode t 777 and t e Ne w Unix o h dire ct ory m ode t 777. Cl o ick " e" Sav . Re s t Sam ba, and you art s h oul now be abl t w rit t d e o e o your s h are .
Sam ba w ilnow h av a s h are d l e f de r t at you can brow s e t ol h o. H ow e v r, you w ilnot be abl t e l e o acce s s it unt you cl on t e s h are , il ick h s e lct Se curit and Acce s s cont , e y rol ch ange t e s h are t W rit e , e nabl h o abl e Gue s t acce s s , and t e n cl " e " h ick Sav .
NEXT M ONTH :
SP CI LBI TH D AY I SUE! E A R S
w h e re w e dis cus s t e birt of h h , h ow w e m anage d t ov r com e s om e of our bigge s t h urdls in o e e cre at ing and organizing FCM and s om e ge e k y dow nl s t s . oad at - Th e GIM P . incl s cre at ude ing a ne w im age , dpi and t e m os t im port h ant t s ne e de d f our ool or f ure GIM P s e s s ions . ut
Now go back t W e bm in, go t o o “ Se rv rs ” , and t e n “ Sam ba e h W indow s F e s h aring” . Se lct il e “ Cre at a ne w f e Sh are ” ;nam e e il t e f e s h are “ Sh are d” and s e lct h il e t e dire ct h ory you w is h t s h are . o F l a Sh are Com m e nt if you ilin w is h , and cl “ Cre at ” . ick e
19
W rit e n by D anie l am b t L
H O W - TO
CREATE YO UR O W N SERV R - P rt 4 E a
Brow s e t o ,t en h . F t w e w ilcre at our irs l e PPP (P oint o-P -t oint P ocol rot ) account , s o cl on s ick ;add a ne w us e r cal d l e , w it a pas s w ord of h ;t e n h cl ick and cl ick . W it in t e inde x of t at m odul, cl h h h e ick on ;f l t e ilin h box w it t e cl nt e nd IP h h ie addre s s ;and f l ilin w it t e IP h h addre s s e s t be as s igne d t t e o o h cl nt m ach ine com ing in v t e ie ia h V PN. Cl ick . Th e n, ope n ;ch ange t o ;ch ange t o ; ch ange t o ; dis abl e and ;and t e re s t can s t on de f t Cl h ay aul ick . , and cl ick . W e w ilnow s e t up m onit l oring f or t e s ys t m . W it in h e h , go t o , and . Cl on ick ;s e lct e f or ; ch ange t te o h f q ue ncy f ch e ck ing t e re or h s e rv r - e v ry 5 m inut s is a e e e good t e f im ram e , j t in cas e us t e re are any problm s or any h e s e rv ice f t . Se t aul s t o 0 s o t at it runs e xact y e v ry 5 h l e m inut s . M ak e s ure alt e h ours e lh and days are s e lct d - t s e lct e e o e m ore t an one , us e t e 'Ct ' k e y h h rl w h il you s e lct t e m . e e h Ch ange t o
N
ow t at w e h av Sam ba, h e D H CP and W e bm in ins t ld and w ork ing, w e al e w ils e t up a V s e rv r t l PN e o m onit t e v or h arious running s e rv s . ice O ur f t s t p is s e t ing up a irs e t V (V ual riv e Ne t ork ) PN irt P at w us ing (P oint o-P -t oint T unne l P ocolprov d by l ing rot ) ide t e popt t am . Th is can alo be h op e s conf igure d by . T st o art of , w e w ilne e d t ins t lh e f l o alt PPTP s e rv r, as f l s : e ol ow sudo apt-get install pptpd (or us e your pack age m anage r and s e arch f popt or ppt or op p) W h e n prom pt d, h it e nt r, and e e apt t w ilins t l -ge l al and al l it de pe nde ncie s . s Now , act at W e bm in by going iv e t o: h t ps :/ l h os t t /ocal :10000
or w h ich e v r you f e l m ore e e is appropriat t your s ys t m . e o e Ch ange t o , and f l ilin your e m ail addre s s . Cl ick . Y can alo ch ange ou s t an SM TP s e rv r w h ich o e doe s n't re q uire aut e nt h icat ion,
11
ot e rw is e s e lct l h os t us ing h e ocal , 'P t ix' or 'Se ndm ail- w e w ilbe os f ' l s e t ing up P t ix in f ure is s ue s . t os f ut Se e m y s e t be l : up ow
Y can alo ch e ck your s ys t m ou s e l by cl ing on ogs ick and going t o (be l ) - in t e re you ow h can cl on a l f e and cl ick og il ick .
W it in t e h h and page s , you can add v arious m onit oring opt ions f rom t e drop h dow n l t you can alo de lt is , s e e t e m by t ing t e adj nt radioh ick h ace box and cl ing D e lt . ick e e
ow ns and runs and is bas e d in P rt , Scot and. H e is alo e h l s inv v d in a num be r of ope n ole s ource proj ct s uch as e s , and . H e is alo a com m it e d L e ds s t e Unit d f e an.
TH E H ERO N H A S L ND ED .D O W NL A D 8. 4! A O 0
w w w .ubunt u.com
w w w .k ubunt u.com
w w w .xubunt u.com
w w w .ubunt u.com
12
Written by Daniel Lamb
HOW-TO
CREATE YOUR OWN SERVER - Part 5
backup of directory'; you will now be greeted with the page shown below right. In the 'Directories to backup', you can fill in multiple directories, with each directory having its own line. In the 'Backup to' box, choose the mount point, and the name of the backup to create; ie, if it is a tape drive, it might be: /dev/st0/<nameofback up>.tar.gz (only if using tar and compression -- which is an option further down the page). You could also choose to backup to a remote location using RSH, SSH or FTP. In that case, choose (rather than file or tape device), and fill in your FTP/RSH/SSH details. Now choose a suitable name for your backup, and fill it in as 'Backup Label'. If you wish to omit any files or directories (within your selected backup directories) supply them. Choose your compression options from Compress Archive -- 'Yes with gzip' is recommended. In the boxes 'Command to run before
N
ow, before we do much more with the server, we are going to configure backups -- so all files and data are protected. We will use the webmin module to configure tar backups; you can use tar backups to save to tape, or to any other form of removable media. Under the System menu in webmin, you should have Filesystem, Backup -or, with the new webmin 1.410, you might need to look under Unused Modules to find it. To add a new backup, fill in the box with a directory, or, to browse your drive, click on the '...' button (shown below).
Tick the tar format if you wish the backup to be in that compressed format, otherwise it will just be a direct dump without compression. After filling in the directory box, click on 'Add a new
14
backup' and 'Command to run after backup', add any required commands. You should now set up a backup schedule (shown below). To do so, select 'Enabled, at times chosen below'. To have yourself (or someone else) informed when backup is running, insert a valid email address into 'Email scheduled output to'. A simple approach is to select 'Simple schedule', choose 'Daily, at midnight', and click 'Create'. We now have an automatically scheduled daily backup to save your most important data and files.
We will now install Postfix (email server) and Dovecot (IMAP and POP3 server). We must drop to the command line, and type: sudo apt-get install postfix dovecot-common dovecot-imapd Answer the questions as follows: Internet Site NONE server1.example.com server1.example.com, example.com, localhost.example.com, localhost No 127.0.0.0/8 Yes 0 + all You now have Postfix and Dovecot installed --
with IMAP. I would suggest you now set up an MX record pointing to your IP address, and change your router to forward SMTP (port 25) traffic, through your router, to your server IP address. This will allow us to use postfix to collect and deliver email directly via SMTP.
owns and runs and is based in Perth, Scotland. He is also involved in a number of open source projects such as , and . He is also a committed Leeds United fan.
15
Written by Daniel Lamb
HOW-TO
CREATE YOUR OWN SERVER - Part 6
N
ow we can start setting up email on our server. I suggest using IMAP and SMTP for sending and receiving email. You should have installed Postfix and Dovecot. You still need to install fetchmail - which will collect any email not received by SMTP. To collect emails by SMTP, you need to set up an MX record (read more about this here http://www.petri.co.il/configure_mx _records_for_incoming_smtp_email _traffic.htm) with the provider of your domain name - it forwards emails to your home IP address. You need to forward SMTP through the firewall on your router to the IP address of your server - to do this, refer to your user manual for your router/firewall. The only changes you will need to make in the Postfix configuration is under Local Delivery: change "Home-relative pathname of user mailbox file" to Maildir, and under "SMTP
Authentication And Encryption", put a tick in the box to "Allow connections from same network", and "Allow connections from this system" under the heading "SMTP relaying restrictions". In the Dovecot IMAP/POP3 server menu, click on Mail Files, and change the radio button option under Mail file location to “Inbox in ~/Maildir, folders in ~/mail”. If you have any other email that needs to be picked up via POP3, you should now install fetchmail by typing:
sudo apt-get install fetchmail Now, open up "Fetchmail Mail retrieval" (Fig.1 above) in Webmin, and click on "..." and "Add Fetchmail server for user". Fill in the box for "Server name", add a username and password (which will be supplied by your ISP or your web site provider), and choose which local users you want the email to be distributed to.
12
One item which should have been configured previously is DNS - to set this up, click on Bind DNS in Webmin. Click on "Create master zone". Enter the domain into the "Domain name / network" box. For the master server, type in the domain name as well. Enter a suitable email address in the appropriate box. Type in the IP address of the server (the external IP address provided by your ISP) and finally, click "Create".
Add any users who are permitted to access the system these are users who can access email, samba shares and so on. You can now install (right), which will allow you to view webmail and also connect to shared calendars and shared contacts. To install , open a console and type: sudo apt-get install egroupware We will deal with configuring for next month.
owns and runs and is based in Perth, Scotland. He is also involved in a number of open source projects such as , and . He is also a committed Leeds United fan.
13
Written by Daniel Lamb
HOW-TO
CREATE YOUR OWN SERVER - Part 7
The script will run through some preinstallation tests. Some of the items will pass and some will have warnings. Click the 'continue to the Header Admin' link at the bottom to continue. You should now be on the setup page. The 'Server Root' and 'Include Root' should be correct. You can leave the admin user set to 'admin' and create a password. This will be the account you use to login to the header manager. Change 'Persistent Connections' to 'False'. Scroll down to the database information section, and enter the information for the database you created in step #1. In this example, we'll use the following information:
- Stays the same. - Stays the same.
W
e are now going to install eGroupware onto your server. This will give us a groupware server which can function like Exchange by connecting an email client such as Thunderbird to it via IMAP, and connecting Sunbird to the calendaring service via icalsrv. First of all, we will need to copy icalsrv into the eGroupware installation folder. To do this, use these commands: wget http://downloads.sourceforge. net/egroupware/eGroupWare1.4.004.zip?modtime=120830122 9&big_mirror=1 unzip eGroupWare-1.4.004.zip and now cp eGroupWare1.4.004/icalsrv /usr/share/egroupware -r Now we can access the installer. In this example, we'll point to:
http://yourserver/egroupware/setup/.
This should be setup via mysql server settings within webmin. Choose a username and password for the 'Configuration User'. This is the account you'll use to manage the configuration. For this example, we'll use the same username and password as the header manager. Click the 'Write config' button to create the header file. You should get a screen saying that your header file was created. You should now be on the eGroupware login page for the control panel. Enter the admin information into the Setup/Config fields to login to the setup control panel. Click the 'Login' button to continue. You should now be on the setup screen for your eGroupware. It will tell you that the database is working but you
13
don't have any tables installed. Click the 'Install' button to create the core tables. The script will create the core tables. If you don't receive any error messages, then it was successful. Click the 'Re-check My Installation' button to continue. The setup page will refresh and you'll see that all of the stages have been complete. Click on the 'Click here to setup 1 admin account and 3 demo accounts' link to continue. Enter the information you would like to have for your admin account. Check the 'Create demo accounts' checkbox to create the demo accounts.
Click the 'Save' button to save these settings. You should now be back at the eGroupware setup page. Click the 'Back to user login' link at the top left of the screen. If you get an error message saying that the lock function failed, create a support ticket on the help page with the name of your database, and lock access will be granted to your database. Refresh the page once lock access has been granted. You should now be at the login page. Enter the information you created for your admin account.
[email protected]
Click the 'Login' button to login to your eGroupware. You should now be at the admin control panel for your eGroupware management system. eGroupware is now installed.
owns and runs and is based in Perth, Scotland. He is also involved in a number of open source projects such as , and . He is also a committed Leeds United fan.
14
Written by Daniel Lamb
HOW-TO
CREATE YOUR OWN SERVER - Part 8
defaults should be fine for anyone to use. There are also preferences for which any users can set themselves. Again, the defaults are fine, but you might choose to change them depending on the use you have planned for them. A request I received from Philipp Hohn was how to connect and to eGroupwares ical server. To get a list of calendars (below), go to the URL: http://servername/egroupware/icalsrv .php/username/list.html Ensure the user has permissions to use the ical server. You can do this via the User Accounts tab from the Admin menu, then click on the user you wish to have permissions for this, or do it via the groups menu. My user is called manager, so if I type in: http://server/egroupware/icalsrv.p hp/manager/list.html I get a number of calendars showing up. I want to use the main-events calendar, so in , under the calendar option (as long as you have lightening installed, there are loads of guides how to do this on the Web), I would simply right click and select New Calendar, choose 'On The Network' then enter the URL: http://10.0.165.15/egroupware/ic alsrv.php/manager/events.ics Click 'Next' then choose your
W
e are now going to add users to eGroupware and give them permissions to various items. To add a user, log into your eGroupware install with the admin user you created before. Browse to Admin, click on Admin, and fill in the boxes as you wish, I suggest putting a tick in the box "Never Expires". You can also give the users different permissions. You may want some to be able to view only emails, whereas you may wish to give full control to others. After adding a user, remember to click "Add". You now want to add a group. You can use the default group for everyone, or use the Admin group if you wish. You will see under Admin a large number of options depending on what you want to do. Go through the different options there, although the
12
preferred name for the calendar. When prompted, enter the username and password for the account. We are now going to install . Some of you may not use it, but in a business environment it is invaluable.
mv doc_download.html doc_download.zip apt-get install unzip unzip doc_download.zip You will now have a new folder called Quotero_Bundle_0.6. We want to move that file to /usr/share/Quotero. To do this, use this command: mv Quotero_Bundle_0.6/ /usr/share/Quotero -r As Quotero uses sh files you need to make them executable. Again, to do this for all the files type in the following commands:
run which depends on java so we need to install java and set it so tomcat knows it’s the default java environment. Do this by typing: apt-get install sun-java6bin update-java-alternatives -s java-6-sun Now you can start Quotero with this command: Sudo ./usr/share/Quotero/Quotero. sh Now browse to the URL for Quotero to continue the install: http://servername:8080/Quotero Deploy All the default settings are fine except for changing the Database type to HSQL, leave the default Database Username, Password and Name as it is. Fill in the SMTP username and password. Then click Validate. It will now carry out the install for you. Once it has come up with the message 'Enjoy, click on Let’s go Quotero...'
To do this we are going to drop to the command line again and enter the following command to download it. wget http://www.quotero.com/downlo ads/doc_download.html As it is automatically downloaded as an HTML file we need to rename it to a zip file and extract it. To do this, we type in the following commands:
chmod +x /usr/share/Quotero/quotero_tomc at/bin/startup.sh chmod +x /usr/share/Quotero/Quotero.sh chmod +x /usr/share/Quotero/quotero_tomc at/bin/catalina.sh chmod +x /usr/share/Quotero/quotero_tomc at/bin/setclasspath.sh Quotero uses Tomcat Apache to
13
You can now log in using the URL: http://servername:8080/QuoteroCli ent/login.jsp and the username "admin" and password "admin". To add users, click on Administration, expand domains, then HQUOTERO, click on users. You can add new users here using the button Add. Under Special Roles you can add various users with different permissions for different tasks. Under Quotero Server v0.6, click on this button and choose New workspace, name it whatever you wish and add permissions for
the various users you have created. By clicking on the button you can add a new folder by clicking on New folder, and call it what you wish, and add relevant permissions. You can now upload documents by clicking on the button next to the folder name and select Import Document. The Document will now be in the folder. You can now check out this document, open it just to view it or start a workflow involving the document (as well as a number of other options) or any others you add. You can check out a document then check it back in again, which will mean only one person can use it at a time. This is very powerful software and can save businesses a lot of time.
owns and runs and is based in Perth, Scotland. He is also involved in a number of open source projects such as , and . He is also a committed Leeds United fan.
on UbuntuForums.org, and IRC on the irc.freenode.net server, channel: #fullcirclemagazine
keep up to date with our adventures via http://twitter.com/fullcirclemag
full circle magazine
www.fullcirclemagazine.org
14
