Skip to content

Commit

Permalink
Deploying to gh-pages from @ 9890416 🚀
Browse files Browse the repository at this point in the history
  • Loading branch information
jdejoya17 committed Jul 12, 2022
1 parent ffd7580 commit 6deb810
Show file tree
Hide file tree
Showing 21 changed files with 1,506 additions and 6 deletions.
Binary file modified .doctrees/environment.pickle
Binary file not shown.
Binary file modified .doctrees/roles.doctree
Binary file not shown.
Binary file added .doctrees/roles/bootptab.doctree
Binary file not shown.
Binary file added .doctrees/roles/inetd.doctree
Binary file not shown.
Binary file added .doctrees/roles/nim_alt_disk_migration.doctree
Binary file not shown.
Binary file added .doctrees/roles/power_aix_bootstrap.doctree
Binary file not shown.
Binary file added .doctrees/roles/power_aix_vioshc.doctree
Binary file not shown.
7 changes: 7 additions & 0 deletions _sources/roles/bootptab.md.txt
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
7 changes: 7 additions & 0 deletions _sources/roles/inetd.md.txt
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
279 changes: 279 additions & 0 deletions _sources/roles/nim_alt_disk_migration.md.txt
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
72 changes: 72 additions & 0 deletions _sources/roles/power_aix_bootstrap.md.txt
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
Loading

0 comments on commit 6deb810

Please sign in to comment.