Install >

Ansible

Recommended system requirements:

  • Install Ansible by following the Installation guide from here.
1

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

git clone https://github.com/wso2/ansible-sp
cd ansible-sp
2

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

3

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

4

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.
[sp]
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.
https://<ip_address>:9443/carbon
https://<ip_address>:9443/publisher
https://<ip_address>:9443/store
https://<ip_address>:9443/admin
Username: admin Password: admin
5

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"
  template:
    src: path/to/example/file/example.xml.j2
    dest: destination/example.xml.j2
  when: "(inventory_hostname in groups['sp'])"