<> ||<>|| = Introduction = This guide covers installation and configuration of '''eBox''' (currently renamed to '''Zentyal'''). [[Zentyal]] is a web framework used to manage server application configuration. The modular design of Zentyal allows you to pick and choose which services you want to configure using Zentyal. The official Zentyal website provides directions for [[http://trac.zentyal.org/wiki/Document/Documentation/InstallationGuide#Zentyal2.0packages|installing directly from their PPA.]] (sudo add-apt-repository ppa:zentyal/2.0) eBox version 1.5 is the development branch for use with Ubuntu 10.04 LTS (Lucid Lynx). On September 2010 it was renamed as Zentyal with the release of the 2.0 version. = Older Versions = {{attachment:IconsPage/warning.png}} '''WARNING:''' the eBox package released with Ubuntu 8.10 (Intrepid Ibex) is broken and cannot be installed. See [[https://bugs.launchpad.net/ubuntu/+source/ebox/+bug/255368|bug #255368]] for information and unsupported workarounds. {{attachment:IconsPage/warning.png}} '''WARNING:''' the eBox version released with Ubuntu 7.10 (Gutsy Gibbon) has several bugs that severely limit its usefulness. The eBox version released for Ubuntu 8.04 (Hardy Heron) is much more functional. = Installation = The '''ebox''' package can be installed from the Universe repository. See InstallingSoftware for detailed instructions using package managers. The different eBox modules are split into different packages, allowing you to only install those necessary. One way to view the available packages is, from a terminal enter: {{{ apt-cache rdepends ebox | uniq }}} You can install all eBox packages by running: {{{ sudo apt-get install “^ebox-.*” }}} During the installation you will be asked to supply a password for the '''ebox''' user. After installing eBox the web interface can be accessed from: {{{https://yourserver/ebox}}}. == Using the latest version == To install a newer version of eBox or Zentyal than is included in Ubuntu's repositories add to the file /etc/apt/sources.list this line if you are using Ubuntu 8.04 (Hardy Heron): {{{ deb http://ppa.launchpad.net/ebox/1.4/ubuntu hardy main }}} Or this one if you are using Ubuntu 10.04 (Lucid Lynx): {{{ deb http://ppa.launchpad.net/zentyal/2.0/ubuntu lucid main }}} Be sure to run {{{ sudo apt-get update }}} before installing it. = eBox Configuration = An important thing to remember when using '''eBox''' is that when configuring most modules there is a '''Change''' button that implements the new configuration. After clicking the change button most, but not all, modules will then need to be '''Saved'''. To save the new configuration click on the '''Save changes''' link in the top right hand corner. Once you make a change that requires a save the link will change from '''green''' to '''red'''. == eBox Modules == By default all '''eBox Modules''' are not enabled, and when a new module is installed it will not be automatically enabled. To enable a disabled '''module''' click on the ''Module status'' link in the left had menu. Then check which modules you would like to enable and click the ''Save'' link. == Default Modules == This section provides a quick summary of the default eBox modules. * '''System:''' contains options allowing configuration of general eBox items. * '''General:''' allows you to set the eBox language and port number. Also, contains a change password form. * '''Disk Usage:''' presents a graph detailing information about disk usage. * '''Backup:''' is used to backup eBox configuration information, and the '''Full Backup''' option allows you to save all eBox information not included in the Configuration option such as log files. * '''Halt/Reboot:''' will shutdown the system or reboot it. * '''Bug Report:''' creates a file containing details helpful when reporting bugs to the eBox developers. * '''Logs:''' allows eBox logs to be queried depending on the purge time configured. * '''Events:''' this module has the ability to send alerts through rss, jabber, and log file. * Events: * '''Free Storage Space:''' will send alert if free disk space drops below a configured percentage, 10% by default. * '''Log Observer:''' unfortunately this event doesn't work with the eBox version shipped with Hardy. * '''RAID:''' will monitor the RAID system and send alerts if any issues arise. * '''Service:''' sends alerts if a service restarts multiple times in a short time period. * '''State:''' alerts on the state of eBox, either up or down. * Dispatchers: * '''Log:''' this dispatcher will send event messages to the eBox log file {{{/var/log/ebox/ebox.log}}} * '''Jabber:''' before enabling this dispatcher you must first configure it by clicking on the configure icon. * '''RSS:''' once this dispatcher is configured you can subscribe to the link in order to view event alerts. == Expansion Modules == * '''Network:''' allows configuration of the systems network options through eBox. * '''Firewall:''' configures firewall options for the eBox host. * '''UsersandGroups:''' this module will manage users and groups contained in an {{{OpenLDAP}}} LDAP directory. * '''DHCP:''' provides an interface to configuring a DHCP server. * '''DNS:''' provides {{{BIND}}} configuration options. * '''Objects:''' allow configuration of eBox {{{Network Objects}}}, which allow you to assign a name to an IP or group of IPs. * '''Services:''' displays configuration information for services that available to the network. * '''Squid:''' configuration options for the {{{Squid}}} proxy server. * '''CA:''' configures a {{{Certificate Authority}}} for the server. * '''NTP:''' set {{{Network Time Protocol}}} options. * '''Printers:''' interface allowing the configuration of printers. * '''Samba:''' configuration options for {{{Samba}}}. * '''OpenVPN:''' setup options for {{{OpenVPN}}} Virtual Private Network application. = Connecting Services to ebox = * [[ebox_setup]] Setting upp ebox for other services. * [[ebox_ubuntu10.04]] Connect an ubuntu 10.04 to your ebox. * [[ebox0Zimbra]] Connect your zimbra server to ebox. * [[ebox0Redmine]] Connect your Redmine to ebox. * [[ebox0Apache]] Connect your Apache server to ebox. = Resources = * [[http://www.zentyal.org/|Zentyal Home Page]] ----