Style Cleanup Required
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 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.
WARNING: the eBox package released with Ubuntu 8.10 (Intrepid Ibex) is broken and cannot be installed. See bug #255368 for information and unsupported workarounds.
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.
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.
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.
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.
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.
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.
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.
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.