Skip to content

Latest commit

 

History

History
 
 

pre-install-playbook

SAS Viya Infrastructure Resource Kit (VIRK) - Pre-installation Playbook

Introduction

This playbook verifies and optionally performs many of the tasks that are required to prepare the environment for a typical SAS Viya deployment.

Use this playbook to prepare for a deployment of SAS Viya 3.3.

Prerequisites for Running the Pre-installation Playbook

Before running this playbook, take the following steps:

  • Install Ansible. Version 2.3.2 or later is recommended.
  • Make sure that the user has sudoers privileges.
  • Be aware that the scripts make modifications to the system unless they are run with the --check option.
  • The base inventory file that VIRK provides contains only localhost and will run only on the machine where it was installed. To run the playbook on multiple machines, you can update the inventory file to include additional hosts. See the Ansible Documentation for instructions.

Running the Playbook

To run the playbook, execute the following command:

ansible-playbook viya_pre_install_playbook.yml -i pre-install.inventory.ini

Useful Optional Arguments

  • --check: Executes a "dry run" of the playbook. Runs the playbook without making changes to the system. Any modules that are instrumented to support "check mode" will report the changes that they would have made rather than make them.
  • -v through -vvvv: Lets you increase the verbosity of the script output; -vvvv enables connection debugging.
  • -i <host-inventory-file>: Lets you use 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>: Skips task(s) with specific tag(s).
  • --list-tasks: Display all tags in a playbook

Index of Tags for Requirement Checks within the Playbook

To see a list of tasks you can run:

ansible-playbook viya_pre_install_playbook.yml -i pre-install.inventory.ini --list-tasks

Here's an example of running only a specific check or configuration:

ansible-playbook viya_pre_install_playbook.yml -i pre-install.inventory.ini --tags memory_check