Installation Guide Zentyal Installer
The preferred way to install Zentyal on a new machine from scratch is using our tailored CD installer. This CD contains Zentyal and all its dependencies. The 4.2 version is based on Ubuntu Server 14.04 and is available at:
Note: If you want to define the partition layout manually or you need to specify a proxy to get Internet access, make sure you install using the “expert mode”.
Once the installation process is done, you can access the web interface using a web browser (usually from another machine in the same network):
To log in, a user name and password is asked, this data is asked during the first stage of the installation. But any other user belonging to the “sudo” group could be used to log in as well.
Add a user with sudo access.
Note: The installers are generated from time to time, so maybe some packages contained on them are outdated. If you have Internet connection during the installation, the latest version of the packages will be installed from our repositories.
For a complete step-by-step installation guide, please refer to http://doc.zentyal.org
Zentyal 4.2 packages
You can also install Zentyal as a “package set” to an already installed version of Ubuntu. This was developed and tested with Ubuntu version 14.04.
For Ubuntu 14.04 (Trusty). You should install the server edition of Ubuntu.
Add to your /etc/apt/sources.list:
deb http://archive.zentyal.org/zentyal 4.2 main
sudo add-apt-repository "deb http://archive.zentyal.org/zentyal 4.2 main extra"
In order to authenticate the packages in the Zentyal repository you can import its public key with the following command:
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 10E239FF
wget -q http://keys.zentyal.org/zentyal-4.2-archive.asc -O- | sudo apt-key add -
Read the Zentyal_4.2_Announcement for more info.
Zentyal has a modular design that allows you to install or remove modules depending on your needs.
After editing your sources.list, make sure that your package database is up to date by running the following command:
sudo apt-get update
After that, you just need to run:
sudo apt-get install zentyal
And then point your browser to the Zentyal IP address and follow the instructions on screen:
If you want to install the full graphical environment you can install zenbuntu-desktop instead of just zentyal:
sudo apt-get install zenbuntu-desktop
After installing zenbuntu-desktop your Ubuntu will be in almost the same state as if you were used the the official Zentyal Installer, you just need to rebootyour server (simulating the finish of the first stage of the installation) and on the next boot the Zentyal core packages will be installed and you will be able to continue the installation from the desktop environment.
You can also use the command line to install the packages.
sudo apt-get install zentyal-mail
You can also install all the Zentyal packages:
sudo apt-get install zentyal-all
Some of the module names are straightforward, but here is a defined list of Zentyal packages:
- zentyal-all – Zentyal – All Component Modules (all Profiles)
- zentyal-office – Zentyal Office Suite (Profile)
- zentyal-antivirus – Zentyal Antivirus
- zentyal-dns – Zentyal DNS
- zentyal-ebackup – Zentyal Backup
- zentyal-firewall – Zentyal Firewall Services
- zentyal-ntp – NTP Services
- zentyal-remoteservices – Zentyal Cloud Client
- zentyal-samba – Zentyal File Sharing and Domain Services
- zentyal-communication – Zentyal Communications Suite
- zentyal-jabber – Zentyal Jabber (Instant Messaging)
- zentyal-mail – Zentyal Mail Service
- zentyal-mailfilter – Zentyal Mail Filter
- zentyal-gateway – Zentyal Gateway Suite
- zentyal-l7-protocols – Zentyal Layer-7 Filter
- zentyal-squid – HTTP Proxy
- zentyal-trafficshaping – Zentyal Traffic Shaping
- zentyal-infrastructure – Zentyal Network Infrastructure Suite
- zentyal-ca – Zentyal Certificate Authority
- zentyal-dhcp – DHCP Services
- zentyal-openvpn – VPN Services
- zentyal-webserver – Zentyal Web Server
Other modules which are not included in the profiles are as follows:
- zentyal-bwmonitor – Zentyal Bandwidth Monitor
- zentyal-captiveportal – Zentyal Captive Portal
- zentyal-ips – Zentyal Intrusion Prevention System
- zentyal-ipsec – Zentyal IPsec and L2TP/IPsec
- zentyal-monitor – Zentyal Monitor
- zentyal-nut – Zentyal UPS Management
- zentyal-openchange – Zentyal OpenChange Server
- zentyal-radius – Zentyal RADIUS
- zentyal-software – Zentyal Software Management
- zentyal-sogo – Zentyal OpenChange Webmail
- zentyal-usercorner – Zentyal User Corner
- zentyal-users – Zentyal Users and Computers
- zentyal-webmail – Zentyal Webmail Service
Accessing the Zentyal Dashboard
Access the Zentyal dashboard by visiting the IP address or domain of your server in your browser, over HTTPS (port 443):
The Zentyal server creates a self-signed SSL certificate for use when being accessed remotely. Any browser accessing the server’s dashboard remotely will be asked if the site is trusted and an exception will need to be made as shown below. The method will vary based on your browser.
Because of the SSL certificate, an error is generated that the site is untrusted. You need to click on the lineI Understand the Risks. Then click on the Add Exception button. Select Confirm Security Exception. After the exception is added, it is a permanent listing that does not occur again unless the server IP Address should change.
Your Zentyal username and password are the same user and password that you use to SSH to your Ubuntu server. This user must be added to the sudo group. (Granting full permissions to the user by some other method will NOT work.) If an existing user account needs to be added to the sudo group, run the following command:
sudo adduser username sudo
To add more Zentyal users, add new Ubuntu users. To add a new user use the following command to create the user and also add the user to the sudo group:
sudo adduser username --ingroup sudo
Once you log into the Zentyal server, you will see a collection of packages available for installation.
When you access the web interface for the first time, you will be presented a configuration wizard.
Any of the parameters that you configure using this wizard can be modified later on accessing the appropriate service or component configuration.
First of all, you will be asked about the functionality that you want to install and configure in your server. Some of these components depend on others, but Zentyal will manage those dependencies automatically. The next steps of this wizard will depend on the functionality you choose here. In any case, you can install/remove/update any of the components later on from the server’s interface.
For this example, the Domain Controller, Groupware and Firewall components will be installed.
Zentyal will inform you of the dependencies that will be installed to support the components I have chosen in the previous step
The required software will be downloaded and installed
Next, you will be asked for the basic network configuration. First of all, which interfaces are External (generally speaking, connected to the Internet gateways), and which ones are Internal (generally speaking, LAN interfaces). This will impact the firewall default policies, network masquerading, default listen interfaces for other modules, etc.
Next, you will provide basic configuration for each one of these interfaces. External interfaces can be configured using DHCP, if you have another network device providing the leases. In any case, if you use DHCP to configure any of the Zentyal interfaces, it is recommended to use an static lease.
The directory component was selected for this example, so I have to select the directory mode:
- Standalone: First domain controller of the domain.
- Additional domain controller: Join an existing domain as an additional controller.
- Connect with external Active Directory server: Join as a domain member, not a controller, to have read-only access to the directory.
For the shake of simplicity, Standalone mode will be selected for this example, you can read more about the other directory modes in the Users, Computers and File Sharing chapter.
To configure this mode, you just need to specify the domain name for your directory entities. Not to be confused with the DNS domain, which is a highly related, but actually different context.
In the next step, you will choose the default virtual mail domain, by default both IMAP and MAPI (Microsoft Outlook® default native protocol) gateways will be enabled for this domain. By default, the domain name will be used to autocomplete this form, but that may not be your case.
The OpenChange component (provides native Microsoft Outlook® protocols) need to have an Organization Name to create the required directory schemas.
Zentyal will proceed to apply the initial configuration for the installed components.
And, that’s it! Your Zentyal server is ready to be used.
Now you can access the Dashboard and the specific configuration of each one of the components. In the next chapter, you can go through the basic concepts and behavior of the Zentyal GUI.