Zimbra Ansible Install Role

This role allows you to install Zimbra version 8.8.x using Ansible in one of two ways:

• Default method
• Using a prompt variable set to true (e.g., -e prompt=true)

Installing the Ansible Role

To install the role, you can use either of the following commands:

ansible-galaxy install deathice.zimbra_ansible_install_role

or

git clone https://github.com/Deathice/Zimbra_ansible_install_role.git

Requirements

General Requirements

• Ansible version 2.4 or higher.
• Update your inventory host's remote group.
• Red Hat/CentOS version 7.x.

Logo Requirements

If you want to use your own logo, you will need to follow these specifications (more details in the documentation):

• The application banner: 200px X 35px, PNG format.
• The login banner: 440px X 60px, PNG format.

Role Variables

Edit the variables in the default/main.yml file:

• srv_hostname: 'Fully Qualified Domain Name (FQDN) of your machine'
• zim_url: URL to download the Zimbra compressed file.
• ip_client: IP address of the server.
• ip_dns: DNS server IP address.
• token_id: 'Token ID from Telegram'.
• chatid: 'Chat ID from Telegram'.
• timezone: Set the system's timezone (e.g., America/Guatemala).
• logo: Set to true to use your own logo.
• url_app: Full URL to the application banner (if logo is true).
• url_login: Full URL to the login banner (if logo is true).
• url_redirect: Optional redirect URL if the app or login banner is clicked (if logo is true).

Main Playbook Examples

Deploy Zimbra from scratch

Create a file named site.yml:

---
- name: Execute role(s)
  hosts: remote

  roles:
    - Zimbra_ansible_install_role

Run it with:

ansible-playbook site.yml

Using a personal logo

Update the defaults/main.yml file with these variables:

---
logo: true
url_app: https://my.images.com/images/application_banner.png
url_login: https://my.images.com/images/login_banner.png

Deploy only your logo

To run just the logo installation, use:

ansible-playbook site.yml --tags only_logos

Notifications

To receive notifications on Telegram when the Ansible process is done:

Change these variables in your default/main.yml file:

• token_id: Token ID from your Telegram chat group.
• chatid: Chat ID from your Telegram chat group.

Then, run the playbook with the TG variable set to true (e.g., -e tg=true).

• For instructions on creating a Telegram bot, visit https://core.telegram.org/bots.
• To find your token_id and chat_id, refer to https://stackoverflow.com/questions/32683992/find-out-my-own-user-id-for-sending-a-message-with-telegram-api.

Note

This role does not support compatibility with previous versions.

Author Information

• Kevyn Perez ([email protected])
• Cellphone: +(502) 5412-7538
• LinkedIn: linkedin.com/in/kevyn-perez-marin-a0b198b7
• Ansible Galaxy: https://galaxy.ansible.com/deathice