https://github.com/nasx/phpipam-install
Ansible Role to Handle Installation of phpIPAM on RHEL 7
https://github.com/nasx/phpipam-install
ansible phpipam rhel
Last synced: 12 days ago
JSON representation
Ansible Role to Handle Installation of phpIPAM on RHEL 7
- Host: GitHub
- URL: https://github.com/nasx/phpipam-install
- Owner: nasx
- Created: 2018-09-03T15:33:51.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-09-04T14:03:45.000Z (almost 8 years ago)
- Last Synced: 2025-01-13T12:46:52.877Z (over 1 year ago)
- Topics: ansible, phpipam, rhel
- Size: 38.1 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# phpIPAM Installer
Written to support RHEL 7 and phpIPAM version 1.4.
## About
This Ansible role is designed to do a reference install on RHEL 7 using the RHEL install instructions [1] detailed on the phpIPAM website. It is assumed that SELinux is ENABLED on the installation system and a custom SELinux policy [2] is created to allow subnet discovery.
## Variables
| Variable Name | Values | Vault | Description |
| :--- | :--- | :--- | :--- |
| mysql_secure_installation | True/False | No | Perform the equivalent of running the mysql_secure_installation command. |
| setup_selinux_http_ping_policy | True/False | No | Install http_ping custom policy to allow subnet discovery on SELinux enabled systems. |
| php_timezone | String | No | See php documentation [3] for a list of valid vaules (default is America/New_York). |
| phpipam_git_url | String | No | Link to the phpIPAM source code (default is https://github.com/phpipam/phpipam.git). |
| phpipam_database_username | String | Yes | The username phpIPAM will use to connect to the MariaDB database (default is phpipam). |
| phpipam_database_password | String | Yes | The password phpIPAM will use to connect to the MariaDB database. |
| phpipam_database_name | String | Yes | The database phpIPAM will use to store application database in the MariaDB database (default is phpipam). |
| mysql_root_password | String | Yes | The password for the MariaDB root user. The root user is used to bootstrap the phpIPAM phpipam_database_username, associated permissions and create the phpipam_database_name database. |
## Usage
### Cloning the Repository
Create a directory and clone the git repository as follows:
```bash
git clone https://github.com/nasx/phpipam-install
```
### Variables
The non-vault variables should be updated in roles/phpIPAM/vars/main.yml to reflect your installation. They can also be overwritten when launching the playbook by assigning them as extra vars (see ansible-playbook man page, specifically --extra-vars or -e).
Vault variables should be added to a vault and passed to the command line as extra vars (see above). To create a vault, use the ansible-vault command:
```bash
ansible-vault create vault
```
### Inventory
The phpIPAM role is expecting a single host in your inventory file. The contents of the inventory file could be as simple as a single line with a host. This host should be in FQDN format. For example:
```
ipam.lab.local
```
### Running the Playbook
To run the playbook we will use the ansible-playbook command to run the install.yml playbook. The install.yml playbook simply runs the phpIPAM role on all hosts marked in the provided inventory file.
The following example will leverage the root user (-u root) to login to the host defined in your inventory file. It will prompt you for the root password (-k) as well as the vault password (--ask-vault-pass) using the vault we created above (-e @vault). The playbook should run on the host(s) defined in the inventory file simply named inventory (-i inventory).
```bash
ansible-playbook -u root -k --ask-vault-pass -e @vault -i inventory install.yml
```
### Next Steps
After successfully running the playbook you can login to phpIPAM using the default credentials: admin/ipamadmin.
## External Links
[1] - https://phpipam.net/news/phpipam-installation-on-centos-7/
[2] - https://phpipam.net/news/selinux-policy-for-icmp-checks/
[3] - http://php.net/manual/en/timezones.php