Install >


Recommended system requirements:

  • Install Ansible by following the Installation guide from here.

Clone WSO2 Stream Processor Ansible git repository and switch to the relevant resource directory by executing the following commands.

git clone
cd ansible-sp

Download and the copy the following binary files to `files/packs` directory.


Download and copy the following files to `files/lib` directory.


Run the playbook.

    The existing Ansible playbook contains the configurations to set up a single node WSO2 Identity Server pattern. In order to deploy the pattern, you need to replace the [ip_address] given in the inventory file under dev folder by the IP of the location where you need to host the StreamProcessor. An example is given below.
dashboard_1 ansible_host=<ip_address> ansible_user=<ssh_user>
editor_1 ansible_host=<ip_address> ansible_user=<ssh_user>
worker_1 ansible_host=<ip_address> ansible_user=<ssh_user>
    Run the following command to execute the playbook.
ansible-playbook -i dev site.yml
    Once the deployment has completed, try to access the web UIs via the following URLs and default credentials on the web browser.
Username: admin Password: admin

Customize the WSO2 Ansible Playbook.

    If you need to alter the configurations given, please change the parameterized values in the yaml files under group_vars and host_vars. You can add customizations to custom.yml under tasks of each role.

Step 1

    Uncomment the following line in main.yml under the role you want to customize.
- Import_tasks: custom.yml

Step 2

    Add the configurations to the custom.yml. A sample is given below.
- name: "Copy custom file"
    src: path/to/example/file/example.xml.j2
    dest: destination/example.xml.j2
  when: "(inventory_hostname in groups['sp'])"