-
Notifications
You must be signed in to change notification settings - Fork 98
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Deploying to gh-pages from @ 9890416 🚀
- Loading branch information
Showing
21 changed files
with
1,506 additions
and
6 deletions.
There are no files selected for viewing
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
# Ansible Role: bootptab | ||
The [IBM Power Systems AIX](../../README.md) collection provides an [Ansible role](https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html), referred to as `bootptab`, which can be used to add or remove entries to the bootptab file. | ||
|
||
For guides and reference, see the [Docs Site](https://ibm.github.io/ansible-power-aix/roles.html). | ||
|
||
## Copyright | ||
© Copyright IBM Corporation 2020 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
# Ansible Role: inetd | ||
The [IBM Power Systems AIX](../../README.md) collection provides an [Ansible role](https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html), referred to as `inetd`, which can be used to enable or disable inetd services, including ftpd, rlogind, rexecd, rshd, telnetd. | ||
|
||
For guides and reference, see the [Docs Site](https://ibm.github.io/ansible-power-aix/roles.html). | ||
|
||
## Copyright | ||
© Copyright IBM Corporation 2020 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,279 @@ | ||
# Ansible Role: nim_alt_disk_migration | ||
The [IBM Power Systems AIX](../../README.md) collection provides an | ||
[Ansible role](https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html), | ||
referred to as `nim_alt_disk_migration`, which assists in automating in migration in | ||
migration of AIX 7.1/7.2 to AIX 7.3. | ||
|
||
For guides and reference, see the [Docs Site](https://ibm.github.io/ansible-power-aix/roles.html). | ||
|
||
## Requirements | ||
|
||
None. | ||
|
||
## Role Variables | ||
|
||
|
||
Available variables are listed below, along with default values: | ||
|
||
<table> | ||
<thead> | ||
<tr> | ||
<th colspan="6"> Role Variables </th> | ||
</tr> | ||
</thead> | ||
<tbody> | ||
<tr> | ||
<td><b> Variable </b></td> | ||
<td><b> Suboptions </b></td> | ||
<td><b> Required </b></td> | ||
<td><b> Default </b></td> | ||
<td><b> Choices </b></td> | ||
<td><b> Comments </b></td> | ||
</tr> | ||
<tr> | ||
<td><b> nim_client </b></td> | ||
<td> </td> | ||
<td> true </td> | ||
<td> </td> | ||
<td> </td> | ||
<td> | ||
Specifies a NIM object name that is associated to the | ||
NIM client machine to be migrated. | ||
</td> | ||
</tr> | ||
<tr> | ||
<td><b> target_disk </b></td> | ||
<td> </td> | ||
<td> true </td> | ||
<td> </td> | ||
<td> </td> | ||
<td> </td> | ||
</tr> | ||
<tr> | ||
<td> </td> | ||
<td><b> disk_name </b></td> | ||
<td> </td> | ||
<td> </td> | ||
<td> </td> | ||
<td> | ||
Specifies the physical volume by name where | ||
the alternate disk will be created. | ||
</td> | ||
</tr> | ||
<tr> | ||
<td> </td> | ||
<td><b> disk_size_policy </b></td> | ||
<td> </td> | ||
<td> </td> | ||
<td> | ||
minimize, | ||
upper, | ||
lower, | ||
nearest | ||
</td> | ||
<td> | ||
Specifies the disk size policy to automatically | ||
determine a valid physical volume that fits the | ||
policy where the alternate disk will be created. | ||
If an alternate disk named '<i>altinst_rootvg</i>' or | ||
'<i>old_rootvg</i>' exists, the role will fail unless | ||
force option is used. | ||
</td> | ||
</tr> | ||
<tr> | ||
<td> </td> | ||
<td><b> force </b></td> | ||
<td> </td> | ||
<td> false </td> | ||
<td> </td> | ||
<td> | ||
If physical volume specified by <b>target_disk.disk_name</b> | ||
belongs to '<i>altinst_rootvg</i>', '<i>old_rootvg</i>', or a | ||
varied on volume group then that physical volume will be | ||
cleaned up. | ||
If <b>target_disk.disk_size_policy</b> is specified and an | ||
alternate disk named '<i>altinst_rootvg</i>' or '<i>old_rootvg</i>' | ||
already exists, then it will clean up the physical volume | ||
it occupies. | ||
</td> | ||
</tr> | ||
<tr> | ||
<td><b> lpp_source </b></td> | ||
<td> </td> | ||
<td> true </td> | ||
<td> </td> | ||
<td> </td> | ||
<td> | ||
Specifies a NIM object name associated to a | ||
LPP resource for the desired level of migration. | ||
</td> | ||
</tr> | ||
<tr> | ||
<td><b> spot </b></td> | ||
<td> </td> | ||
<td> false </td> | ||
<td> </td> | ||
<td> </td> | ||
<td> | ||
Specifies a NIM object name associated to a SPOT | ||
resource. | ||
</td> | ||
</tr> | ||
<tr> | ||
<td><b> reboot_client </b></td> | ||
<td> </td> | ||
<td> false </td> | ||
<td> false </td> | ||
<td> </td> | ||
<td> | ||
Specifies if the NIM client LPAR will be | ||
automatically rebooted after successfully | ||
creating the alternate disk. | ||
</td> | ||
</tr> | ||
<tr> | ||
<td><b> control_phases </b></td> | ||
<td> </td> | ||
<td> false </td> | ||
<td> </td> | ||
<td> </td> | ||
<td> </td> | ||
</tr> | ||
<tr> | ||
<td> </td> | ||
<td><b> validate_nim_resources </b></td> | ||
<td> </td> | ||
<td> true </td> | ||
<td> </td> | ||
<td> | ||
If set to false, then it will skip | ||
validation of NIM resources. | ||
</td> | ||
</tr> | ||
<tr> | ||
<td> </td> | ||
<td><b> perform_migration </b></td> | ||
<td> </td> | ||
<td> true </td> | ||
<td> </td> | ||
<td> | ||
If set to false, then it will skip | ||
the actual migration task | ||
</td> | ||
</tr> | ||
</tbody> | ||
</table> | ||
|
||
**NOTES**: | ||
- ***minimize*** disk size policy chooses smallest disk that can be selected. | ||
- ***upper*** disk size policy chooses the first disk found bigger than the rootvg disk. | ||
- ***lower*** disk size policy chooses a disk that is less than rootvg disk size but big | ||
enough to contain the used PPs. | ||
- ***nearest*** disk size policy chooses a disk closest to the rootvg disk in terms of size. | ||
- if ***upper*** or ***lower*** cannot be satisfied, it will default to *minimize*. | ||
- if you are using the role to ONLY validate the NIM resources then the **nim_client** | ||
variable is not required. | ||
- if a **spot** is not specified, one will be automatically created using the specified | ||
**lpp_source**. | ||
|
||
## Dependencies | ||
|
||
None. | ||
|
||
## Example Playbook | ||
|
||
``` | ||
- name: Perfrom an alternate disk migration using hdisk1. Let the role build the SPOT. | ||
hosts: aix | ||
gather_facts: no | ||
tasks: | ||
- include_role: | ||
name: nim_alt_disk_migration | ||
vars: | ||
nim_client: p9zpa-ansible-test1 | ||
target_disk: | ||
disk_name: hdisk1 | ||
lpp_source: lpp_2134A_730 | ||
``` | ||
|
||
``` | ||
- name: Perform an alternate disk migration and let the role choose the disk. | ||
hosts: aix | ||
gather_facts: no | ||
tasks: | ||
- include_role: | ||
name: nim_alt_disk_migration | ||
vars: | ||
nim_client: p9zpa-ansible-test1 | ||
target_disk: | ||
disk_size_policy: minimize | ||
lpp_source: lpp_2134A_730 | ||
spot: spot_2134A_730 | ||
``` | ||
|
||
``` | ||
# Useful when migrating multiple nodes concurrently. Use first the role to perform the | ||
# validation of the resources only once. Then you can migrate the nodes without doing verifications. | ||
|
||
- name: Validate the nim lpp and spot resources and exit the playbook. | ||
hosts: aix | ||
gather_facts: no | ||
tasks: | ||
- include_role: | ||
name: nim_alt_disk_migration | ||
vars: | ||
lpp_source: lpp_2134A_730 | ||
spot: spot_2134A_730 | ||
control_phases: | ||
validate_nim_resources: true | ||
perform_nim_migration: false | ||
``` | ||
|
||
``` | ||
# Useful when migrating multiple nodes concurrently. The role will prevent the validation | ||
# of the resources and just perform the migration. The role still will perform specific | ||
# validations for the nim client such as connectity, OS level and valid hardware platform | ||
# for the OS. | ||
|
||
- name: Perform an alternate disk without the lpp or spot resources validation. | ||
hosts: aix | ||
gather_facts: no | ||
tasks: | ||
- include_role: | ||
name: nim_alt_disk_migration | ||
vars: | ||
nim_client: p9zpa-ansible-test1 | ||
target_disk: | ||
disk_size_policy: minimize | ||
lpp_source: lpp_2134A_730 | ||
spot: spot_2134A_730 | ||
control_phases: | ||
validate_nim_resources: false | ||
perform_nim_migration: true | ||
``` | ||
|
||
``` | ||
# For debugging purposes: debug_skip_nimadm: true | ||
# Similar to modules "check_mode". Useful to execute all the validations and just exit before | ||
# performing the migration. | ||
|
||
- name: Preview an alternate disk migration. Exit before running nimadm | ||
hosts: aix | ||
gather_facts: no | ||
tasks: | ||
- include_role: | ||
name: nim_alt_disk_migration | ||
vars: | ||
nim_client: p9zpa-ansible-test1 | ||
target_disk: | ||
disk_size_policy: minimize | ||
lpp_source: lpp_2134A_730 | ||
spot: spot_2134A_730 | ||
control_phases: | ||
validate_nim_resources: true | ||
perform_nim_migration: true | ||
debug_skip_nimadm: true | ||
``` | ||
|
||
## Copyright | ||
© Copyright IBM Corporation 2022 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,72 @@ | ||
# Ansible Role: power_aix_bootstrap | ||
The [IBM Power Systems AIX](../../README.md) collection provides an [Ansible role](https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html), referred to as `power_aix_bootstrap`, which automatically loads and executes commands to install dependent software. | ||
|
||
For guides and reference, see the [Docs Site](https://ibm.github.io/ansible-power-aix/roles.html). | ||
|
||
## Requirements | ||
|
||
None. | ||
|
||
## Role Variables | ||
|
||
Available variables are listed below, along with if they are required, type and default values: | ||
|
||
pkgtype (True, str, none) | ||
|
||
Specifies the package service requiring bootstrap installation. | ||
pkgtype: [yum, python, dnf, wget, pycurl] | ||
Bootstrap for yum and python is supported for AIX 7.1 and AIX 7.2. | ||
Bootstrap for dnf is supported for AIX 7.3 | ||
|
||
-- pkgtype arguments | ||
- yum | ||
Uses the AIX toolsbox to install the yum package and dependencies. | ||
- python | ||
Install python2 using yum. | ||
- dnf | ||
Uses the AIX toolsbox to install dnf and dependencies on AIX 7.3 and above. | ||
- wget | ||
Uses dnf or yum to install wget. | ||
-pycurl | ||
Installs pycurl | ||
|
||
opt_free_size (optional, str, 500) | ||
|
||
Specifies the free space in megabytes needed in the /opt folder. It is used by dnf, wget and pycurl bootstraps. | ||
|
||
var_free_size (optional, str, 200) | ||
|
||
Specifies the free space in megabytes needed in the /var folder. | ||
|
||
download_dir (optional, str, ~) | ||
|
||
Specifies the temporary download location for install scripts and packages. The location resides on the Ansbile control node. | ||
|
||
target_dir (optional, str, /tmp/.ansible.cpdir) | ||
|
||
Specifies the target location (per inventory host) for copying and restoring package files and metadata. If the target location does not exist, then a temporary filesystem is created using the target_dir as the mount point. Upon role completion, the target location is removed. | ||
|
||
## Dependencies | ||
|
||
None. | ||
|
||
## Example Playbook | ||
|
||
- hosts: aix | ||
gather_facts: no | ||
include_role: | ||
name: power_aix_bootstrap | ||
vars: | ||
pkgtype: yum | ||
|
||
|
||
- hosts: aix | ||
gather_facts: no | ||
include_role: | ||
name: power_aix_bootstrap | ||
vars: | ||
pkgtype: wget | ||
opt_free_size: 1000 | ||
|
||
## Copyright | ||
© Copyright IBM Corporation 2021 |
Oops, something went wrong.