Installing Egroupware

Embed Size (px)

Citation preview

  • 7/24/2019 Installing Egroupware

    1/17

    Installing Egroupware

    How to install Egroupware on a computer running Windows 2000, XP or 2003.

    There are other ways of installing the necessary its and pieces, ut the method elow

    seems to e the most straightforward for the non!e"pert...

    1. Download the necessary files

    #. $o to www.egroupware.org, go to the %&ownloads% section in the 'ontents

    menu on the left, and loo( under %)atest stale *ersion%. +ou should see a lin( to

    %fficial ... pac(ages from sourceforge.net%. 'lic( on the lin(, and you will eta(en to the -ourceforge download page. Here you will find three different .ip

    files /and some other files too, which are for installing on )inu".

    eGroupWare-xyz.zipis the main Egroupware program, which you definitelyneed to download.

    eGroupWare-egw-pear-xyz.zipis the %pear% pac(age, which you will only needif you want to use Egroupware1s uilt!in mail client /which can e integrated with

    the calendar to send automated reminders. ha*e not e"perimented with this, soif you want to use it, you will need to chec( the documentation at

    www.egroupware.org.

    eGroupWare-gallery-xyz.zipis the %gallery% pac(age%, which you can use tocreate online photo alums inside Egroupware. therwise it1s not needed.

    2. $o to http://www.apachefriends.org/en/xapp-windows.htl and follow the

    lin(s to download the latest *ersion of the X4PP Windows nstaller /which isone .e"e file. X4PP contains pache, PHP and 4y-5) in one installer, which

    ma(es the installation 6uite simple.

    3. f you don1t ha*e it already, you may also want to download and install the latest*ersion of 7irefo" from http://www.ozilla.org/en/firefox. This is ecause someparts of the Egroupware install process do not always wor( with nternet

    E"plorer.

    !. Install "#$%%

    #. )aunch the X4PP Windows nstaller which you downloaded. 'hoose the

    desired language for the installation, and clic( 8.

    http://www.egroupware.org/http://www.egroupware.org/http://www.apachefriends.org/en/xampp-windows.htmlhttp://www.mozilla.org/en/firefoxhttp://www.egroupware.org/http://www.egroupware.org/http://www.apachefriends.org/en/xampp-windows.htmlhttp://www.mozilla.org/en/firefox
  • 7/24/2019 Installing Egroupware

    2/17

    2. 'lic( 9e"t.

    3. 'lic( 9e"t, to choose the default install location.

    :. 4P;T9T ! in the X4PP ptions dialog, tic( %nstall pache as ser*ice%

    https://sites.google.com/site/richardmilena/egroupware/xampp3.png?attredirects=0https://sites.google.com/site/richardmilena/egroupware/xampp2.png?attredirects=0
  • 7/24/2019 Installing Egroupware

    3/17

    and %nstall 4y-5) as ser*ice%. Then clic( the nstall utton.

  • 7/24/2019 Installing Egroupware

    4/17

    need to clic( @nloc( when you see the following message.

    . -ome other program is using port A0 or port ::3. +ou can figure out which one

    y using the 9etstat command together with Tas( 4anager ! see herefor moredetails.

    B. 'lic( 8 at this dialog o", which confirms that pache and 4y-5) ser*icesha*e een installed.

    A. 'lic( +es at this dialog o", to start the X4PP control panel.

    C. 4a(e sure that oth pache and 4y-5) are started in the X4PP control panel

    http://answers.google.com/answers/threadview?id=52753http://answers.google.com/answers/threadview?id=52753https://sites.google.com/site/richardmilena/egroupware/xampp6.png?attredirects=0http://answers.google.com/answers/threadview?id=52753
  • 7/24/2019 Installing Egroupware

    5/17

    ! they oth need to e running efore you can continue with the installation.

    #0. 9ow test that pache is wor(ing properly ! open nternet E"plorer or 7irefo",

    type in localhost into the address ar and press Enter. +ou should see the X4PP

    page, li(e this one.

    &. Install Egroupware ' create %(% header

    #. pen the Egroupware ip file which you downloaded at the eginning, and unip

    https://sites.google.com/site/richardmilena/egroupware/xampp11.png?attredirects=0https://sites.google.com/site/richardmilena/egroupware/xampp10.png?attredirects=0
  • 7/24/2019 Installing Egroupware

    6/17

    all the files to ):*xapp*htdocs. This might ta(e a few minutes, and at the end

    you will ha*e a new folder ):*xapp*htdocs*egroupware, with sufolders andfiles li(e this>

    2. pen nternet E"plorer or 7irefo", type in localhost/egroupwareinto the address

    ar and press Enter. +ou should see a page li(e this.

  • 7/24/2019 Installing Egroupware

    7/17

    f you see an error instead, ma(e douly sure that your Egroupware files are

    unipped into the right place efore trying again.

    3. 'lic( on +un installation tests. This will test whether all Egroupware

    components are wor(ing properly.fter the test, you will see a report something li(e this /the screenshot shows the

    ottom of the report.

    https://sites.google.com/site/richardmilena/egroupware/Egroupware2.png?attredirects=0
  • 7/24/2019 Installing Egroupware

    8/17

    Each item will e shown with one of three symols>

    o green tic,/8

    o yellow lightning olt/a warning.

    t1s normal to see some warnings ! for e"ample ne"t to ciA and )dap,

    which you only need if you are setting up a more comple" system. Therewill also e a warning ne"t to Pear /which is a component you may not

    need anyway ! see ao*e.

    o ared " / prolem which needs to e fi"ed efore you can continue.

    This usually means either that X4PP is not wor(ing properly, or there is

    some prolem with the files you unipped.

    https://sites.google.com/site/richardmilena/egroupware/Egroupware3.png?attredirects=0
  • 7/24/2019 Installing Egroupware

    9/17

    :. f the tests show no prolems, clic( on )ontinue to the (eader #din, at the

    ottom of the screen. This will ring you to the header setup page, with a message

    at the top saying ou hae not created your header.inc.php yet0 ou can createit now.f you scroll down, you will see a numer of settings which you can fill in.

    This is the point where did a lot of head!scratching when was trying to follow

    the setup instructions at egroupware.org...Here1s all you need to fill in>

    Header PasswordThe password you will need the ne"t time you change any of

    the settings on this page. +ou cannot use a lan( password.

    'onfiguration

    user

    The username you will use to configure Egroupware system in

    a few moments.The easiest thing at this stage is to (eep the default #din.

    'onfiguration

    password

    The password which goes with the username ao*e. +ou1ll

    need this password the first time you log in. +ou cannot use a

    lan( password

  • 7/24/2019 Installing Egroupware

    10/17

    . )onfigure Egroupware

    #. @nder 2etup/)onfig #din 3ogin, log in with the configuration user and

    configuration password you created in step : ao*e. 9ow you will see this screen.

    https://sites.google.com/site/richardmilena/egroupware/Egroupware6.png?attredirects=0
  • 7/24/2019 Installing Egroupware

    11/17

    n 2tep 1you choose which character set to use, according to which languagesyou plan to install. n Egroupware #.=, the default is @T7!A, which gi*es more

    fle"iility for installing languages with different character sets.This is also the place to create your dataase ! Fust clic( on the )reate Dataase

    utton. 9ow you will see this screen>

    https://sites.google.com/site/richardmilena/egroupware/Egroupware7.png?attredirects=0
  • 7/24/2019 Installing Egroupware

    12/17

    'lic( on +e-)hec, $y Installation, and you should see a message saying our

    dataase is wor,ing.

    https://sites.google.com/site/richardmilena/egroupware/Egroupware8.png?attredirects=0
  • 7/24/2019 Installing Egroupware

    13/17

    'lic( on the Install /all applications utton. When did this, got an errormessage after a few seconds, with no o*ious way of going ac(. f this happens

    to you, you can get ac( to the setup screen y typing in

    localhost/egroupware/setupinto the address ar and pressing Enter.

    2. f your applications ha*e installed successfully, you will see a tic( under 2tep 1 -

    2iple #pplication $anageent. f there is a red cross instead, you may need

    to clic( the +e-)hec, $y Installationutton.

    When -tep # is tic(ed, go to 2tep ! - )onfiguration, and clic( on %Edit current

    configuration%. Here you add information aout HTTP pro"y and mailser*er !e*en if you don1t plan to use those features, you need to put something in the

    o"es ! some dummy address li(e none.nonewill do. The picture elow shows

    https://sites.google.com/site/richardmilena/egroupware/Egroupware9.png?attredirects=0
  • 7/24/2019 Installing Egroupware

    14/17

    the minimum information you need to pro*ide.

    'lic( the 2aeutton at the ottom, and you should e ac( at the setup screen

    with 2tep 1and 2tep !tic(ed.

    3. )et1s mo*e to 2tep & - #din #ccount. 'lic( the )reate adin accountutton.+ou will see a screen li(e this, which is to create the account which you will use

    when you first log into your fully set!up Egroupware system.

  • 7/24/2019 Installing Egroupware

    15/17

    The only things you need to fill in here are dmin username, dmin passwordand ;e!enter password. Then clic( the 2aeutton at the ottom.

    :. 2tep - 3anguage anageentis only needed if you want your users to e ale

    to see the user interface in a language other than English. n that case, clic( on the$anage 3anguagesutton, and choose the languages you want for the userinterface. 'trlGclic( lets you select multiple languages. Then clic( the Install

    utton.

    When the )anguage installation is finished, you are not ta(en ac( to the setupscreen automatically ! you need to clic( on %2etup $ain $enu% in the left

    column.

  • 7/24/2019 Installing Egroupware

    16/17

  • 7/24/2019 Installing Egroupware

    17/17

    9ow you can log in with the username and password you created in step 3 ao*e.

    f the login is successful, you should see something li(e this>

    9ow you can go on to custoise your Egroupware setupto suit the needs of

    your users.

    https://sites.google.com/site/richardmilena/egroupwarecustomhttps://sites.google.com/site/richardmilena/egroupware/Egroupware14.png?attredirects=0https://sites.google.com/site/richardmilena/egroupware/Egroupware13.png?attredirects=0https://sites.google.com/site/richardmilena/egroupwarecustom