- This playbook verifies and possibly performs many of the pre-requisites for a generic Viya deployment.
- This playbook is for Viya 3.3
Before running this script you will need to:
- Install ansible. Version 2.3.2 is recommended for deployment.
- Make sure the user has sudo prvilileges
- Be aware that the scripts makes modifications to the system when not run with the --check option.
- The base inventory file that we've provided contains only localhost and will only run on the machine on which it was installed. To run the playbook against multiple machines you can update the inventory file to include additional hosts. See Ansible Documentation for how-to.
To run the script, execute on the command line:
ansible-playbook viya_pre_install_playbook.yml -i inventory
--check
: Executes a "dry run" of the playbook. Runs the playbook without making changes to the system. Any module instrumented to support ‘check mode’ will report what changes they would have made rather than making them.-v through -vvvv
: Allows you to increase the verbosity of the script output; -vvvv enables connection debugging.-i <host-inventory-file>
: Allows use of a different host inventory file instead of the default /etc/ansible/host file.--tags <tag-name>
: Runs only task(s) with specific tag(s)--skip-tags <tag-name>
: Skip task(s) with specific tag(s)--list-tasks
: Display all tags in a playbook
While SAS Tech Support will not provide support for the content of VIRK, issues and/or pull requests in GitHub are welcome.
To see a list of tasks you can run:
ansible-playbook viya_pre_install_playbook.yml -i inventory --list-tasks
Example running only a specific check or configuration:
ansible-playbook viya_pre_install_playbook.yml -i inventory --tags memory_check
These specific tags run the code that perform the pre-install checks and changes:
- ping
- os_name_check
- os_version_check
- memory_check
- cpu_check
- storage_check
- third_party_check
- hostname_length_check
- yum_cache_config
- ssh_maxstartups_config
- required_packages_config
- selinux_config
- user_and_group_config
- ulimit_config
- network_and_bandwidth_check
- os_firewall_config
- ntp_config