Enabling OpenWISP Modules

Enabling the Monitoring Module

The Monitoring module is enabled by default, it can be disabled by setting openwisp2_monitoring to false.

Enabling the Firmware Upgrader Module

It is encouraged that you read the quick-start guide of openwisp-firmware-upgrader before going ahead.

To enable the Firmware Upgrader module you need to set openwisp2_firmware_upgrader to true in your playbook.yml file. Here's a short summary of how to do this:

Step 1: Install ansible

Step 2: Install this role

Step 3: Create inventory file

Step 4: Create a playbook file with following contents:

- hosts: openwisp2
  become: "{{ become | default('yes') }}"
  roles:
    - openwisp.openwisp2
  vars:
    openwisp2_firmware_upgrader: true

Step 5: Run the playbook

When the playbook is done running, if you got no errors you can login at https://openwisp2.mydomain.com/admin with the following credentials:

username: admin
password: admin

You can configure openwisp-firmware-upgrader specific settings using the openwisp2_extra_django_settings or openwisp2_extra_django_settings_instructions.

E.g:

- hosts: openwisp2
  become: "{{ become | default('yes') }}"
  roles:
    - openwisp.openwisp2
  vars:
    openwisp2_firmware_upgrader: true
    openwisp2_extra_django_settings_instructions:
      - |
        OPENWISP_CUSTOM_OPENWRT_IMAGES = (
            ('my-custom-image-squashfs-sysupgrade.bin', {
                'label': 'My Custom Image',
                'boards': ('MyCustomImage',)
            }),
        )

Refer the Role Variables section of the documentation for a complete list of available role variables.

Enabling the Network Topology Module

To enable the Network Topology module you need to set openwisp2_network_topology to true in your playbook.yml file. Here's a short summary of how to do this:

Step 1: Install ansible

Step 2: Install this role

Step 3: Create inventory file

Step 4: Create a playbook file with following contents:

- hosts: openwisp2
  become: "{{ become | default('yes') }}"
  roles:
    - openwisp.openwisp2
  vars:
    openwisp2_network_topology: true

Step 5: Run the playbook

When the playbook is done running, if you got no errors you can login at https://openwisp2.mydomain.com/admin with the following credentials:

username: admin
password: admin

Enabling the RADIUS Module

To enable the RADIUS module you need to set openwisp2_radius to true in your playbook.yml file. Here's a short summary of how to do this:

Step 1: Install ansible

Step 2: Install this role

Step 3: Create inventory file

Step 4: Create a playbook file with following contents:

- hosts: openwisp2
  become: "{{ become | default('yes') }}"
  roles:
    - openwisp.openwisp2
  vars:
    openwisp2_radius: true
    openwisp2_freeradius_install: true
    # set to false when you don't want to register openwisp-radius
    # API endpoints.
    openwisp2_radius_urls: true

Note

openwisp2_freeradius_install option provides a basic configuration of freeradius for OpenIWSP, it sets up the radius user token mechanism if you want to use another mechanism or manage your freeradius separately, please disable this option by setting it to false.

Step 5: Run the playbook

When the playbook is done running, if you got no errors you can login at:

https://openwisp2.mydomain.com/admin
username: admin
password: admin

Note: for more information regarding radius configuration options, look for the word “radius” in the Role Variables section of this document.