Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Install pm-ganesha packages for SLES on local package install #712

Open
wants to merge 156 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
156 commits
Select commit Hold shift + click to select a range
cc7a1d3
Remove non-collection (legacy) samples
Oct 29, 2021
cc5ae1e
Remove alternative (legacy) installation methods
Oct 29, 2021
b0c1ce1
Remove custom_module role in favor of global plugins/ directory
Oct 29, 2021
4b03f90
Remove role-specific tags in favor of global collection tags
Oct 29, 2021
9a3bc4e
Remove role name from role metadata (ignored for collections)
Oct 29, 2021
f715be0
Bump min_ansible_version to 2.9, consistent with README
Oct 29, 2021
42449f3
Fix indentation
Oct 31, 2021
015e337
Rename all roles (breaking)
Oct 31, 2021
a16aeb4
Add simple migration script
Oct 31, 2021
1048d07
Update dependencies to reflect new role names
Oct 31, 2021
b99de07
Update references to 'local' roles
Oct 31, 2021
d294492
Reference dependencies by their fully-qualified name
Oct 31, 2021
64f89de
Move role-specific README's to docs/ directory
Nov 1, 2021
06fa12f
Update samples to reflect new role names
Nov 1, 2021
be14f0d
Update minimal example to reflect new role names
Nov 4, 2021
1fe31ed
Merge pull request #572 from acch/nextgen
rajan-mis Nov 8, 2021
dff874d
Update 'import_role' tasks to reflect new role names
Nov 15, 2021
8138d86
Merge pull request #573 from acch/nextgen
rajan-mis Nov 16, 2021
0c67bd7
[ces_common] Change 'scale_protocol_node_list' to use 'inventory_host…
Nov 17, 2021
a1459f0
[OBJ] Change 'scale_obj_nodes_list' to use 'inventory_hostname'
Nov 17, 2021
d7609f8
[NFS] Change 'scale_nfs_nodes_list' to use 'inventory_hostname'
Nov 18, 2021
0f28a59
[SMB] Change 'scale_smb_node_list' to use 'inventory_hostname'
Nov 18, 2021
18b725d
[HDFS] Change 'scale_protocol_nodes_list' to use 'inventory_hostname'
Nov 18, 2021
f4c7115
[Perfmon] Extract daemon nodename from 'scale_zimon_collectors'
Nov 24, 2021
bf655bd
[OBJ] Use daemon nodename as cluster hostname (temporary)
Nov 24, 2021
88b6d69
Consistently check if scale_install_repository_url is defined when cr…
Nov 24, 2021
6f22fc8
Rename 'is_protocol_node' to 'scale_protocol_node'
Nov 25, 2021
1d0c29d
Rename 'is_admin_node' to 'scale_admin_node'
Nov 25, 2021
496e2c0
Rename variables in sample inventory file
Nov 25, 2021
e51681f
Rename 'is_nsd_server' to 'scale_nsd_server'
Nov 25, 2021
59c95fc
Rename 'gpfs_cluster_system_profile' to 'scale_cluster_system_profile'
Nov 25, 2021
2af91b5
Rename 'scale_fileauditlogging_enable' to 'scale_fal_enable'
Nov 25, 2021
3328d60
[NFS] Rename 'install_debuginfo' to 'scale_nfs_install_debuginfo'
Nov 25, 2021
7f4db07
[SMB] Rename 'install_debuginfo' to 'scale_smb_install_debuginfo'
Nov 25, 2021
4f195d1
[HDFS] Rename 'install_debuginfo' to 'scale_hdfs_install_debuginfo'
Nov 25, 2021
3c1ff31
Fix role directory name for default variables
Nov 25, 2021
ceacf0d
Add 'scale_' prefix to 'hdfs_*_version_path' variables
Nov 25, 2021
9acda81
Add 'scale_' prefix to HDFS internal variables
Nov 25, 2021
bf74f40
Created new variables to document all variables in the project.
olemyk Nov 30, 2021
a44b441
- Fixed som logic when remotemount is hafeway setup between client an…
olemyk Dec 9, 2021
2c95cc3
Merge pull request #578 from acch/iss577
rajan-mis Dec 27, 2021
b824a5e
Updated the format and test in VARIABLESNEW.md file.
olemyk Jan 3, 2022
31c71db
Merge branch 'nextgen' into rename_vars
acch Jan 3, 2022
08d81e4
Merge pull request #587 from acch/iss574
rajan-mis Jan 4, 2022
eccb005
Merge pull request #590 from acch/rename_vars
rajan-mis Jan 4, 2022
2cda5f7
Merge pull request #591 from olemyk/nextgen_remotemount_fix
rajan-mis Jan 4, 2022
0afcabc
- Updated Variabled to start with scale_remotemount*
olemyk Jan 4, 2022
02caccc
Merge pull request #592 from olemyk/nexgen-variables
rajan-mis Jan 6, 2022
2fd0a1a
Add README.md (symlink) in each role directory
Jan 11, 2022
6169c37
Add runtime metadata
Jan 11, 2022
087c6e8
Link 'Docs Site' directly to README
Jan 11, 2022
ea16d2b
Define minimum Ansible version according to Collections checklist
Jan 11, 2022
942cc31
Merge pull request #593 from olemyk/nextgen_remotemount_fix
rajan-mis Feb 1, 2022
9df5d7a
Merge pull request #595 from acch/iss571
rajan-mis Feb 1, 2022
98c93b8
Initial draft version
Mar 11, 2022
8f34f61
hdfs-3220 feature
dheren-git Feb 4, 2022
b8bd178
Adding `loop_var` to avoid warning in nanenode start
dheren-git Mar 9, 2022
b127004
Fix link to samples and add details for creating multiple clusters
Mar 11, 2022
3cb4b6b
Use scale_daemon_nodename for perfmon configuration
Mar 15, 2022
9a913a3
Minor wording
Apr 5, 2022
03057e3
Add reference to MIGRATING.md
Apr 5, 2022
e84e93f
NSD active logic check to compare inventory defined nsd with system e…
rajan-mis Mar 18, 2022
b4f917b
Explicitly reference `main` branch
Apr 12, 2022
5a819e2
Merge pull request #618 from acch/nextgen_migrating
rajan-mis May 20, 2022
b2f9530
Merge pull request #613 from acch/gui_hostname_fix
rajan-mis May 21, 2022
e107ba6
UBUNTU 22.04 zimon collector directory change
rajan-mis Apr 7, 2022
ec16454
UBUNTU22.04 upgrade support code for zimon
rajan-mis Apr 7, 2022
cbc50dd
Optional prereqs package install logic in the core/precheck role
rajan-mis Apr 20, 2022
310bdfd
UBUNTU 22 support for SMB
rajan-mis Apr 25, 2022
1d30f7e
Fixed type issue fix for ubuntu22
rajan-mis Apr 25, 2022
53d774e
UBUNTU 22 fix for zimon
rajan-mis Apr 26, 2022
275209b
UBUNTU22 zimon upgrade issue
rajan-mis Apr 26, 2022
6bfb38d
UBUNTU 22 support for NFS package
rajan-mis Apr 27, 2022
e4040d7
UBUNTU 22 fixed for pm-ganesha
rajan-mis Apr 28, 2022
fc3f026
UBUNTu22 upgrade support
rajan-mis May 2, 2022
c1c26fa
UBUNTU 22 support for local and remote method
rajan-mis May 4, 2022
ff30086
[TS009168275] HDFS Transparency is not installed properly
dheren-git May 9, 2022
43a74a4
[TS009168275] HDFS Transparency is not installed properly
dheren-git May 10, 2022
bd4de1c
Update install_repository.yml
sujeetkjha May 11, 2022
b4a13fd
Update install_repository.yml
sujeetkjha May 13, 2022
f112a4d
Update install_remote_pkg.yml
sujeetkjha May 13, 2022
1323721
Update install_local_pkg.yml
sujeetkjha May 13, 2022
b09228b
Update install_repository.yml
sujeetkjha May 16, 2022
76b2bf5
Update install_local_pkg.yml
sujeetkjha May 16, 2022
09ca004
Update install_remote_pkg.yml
sujeetkjha May 16, 2022
80bcb9f
Update install_repository.yml
sujeetkjha May 16, 2022
8abcd42
Update install_remote_pkg.yml
sujeetkjha May 16, 2022
e533598
Update install_local_pkg.yml
sujeetkjha May 16, 2022
aacd554
Merge pull request #612 from acch/nextgen_port_master
rajan-mis May 23, 2022
2ad05db
Object Signing requirement fix and adding protocol node into existing…
rajan-mis Nov 23, 2021
935ec56
Merge pull request #650 from rajan-mis/nextgen_obj
rajan-mis Jun 1, 2022
05c54b8
Object directory import fix with namespace
rajan-mis Jun 1, 2022
233542b
Merge pull request #651 from rajan-mis/nextgen_obj
rajan-mis Jun 1, 2022
c29b9af
ECE fix for setsize
rajan-mis Jun 14, 2022
a46d4ef
Merge pull request #655 from rajan-mis/nextgen_obj
rajan-mis Jun 14, 2022
c69d113
FAL issue for RHEL9
rajan-mis Jun 16, 2022
223886f
Merge pull request #656 from rajan-mis/nextgen_obj
rajan-mis Jun 16, 2022
d7f919f
RHEL9 repo code for protocol
rajan-mis Jun 17, 2022
ea145fc
Merge pull request #657 from rajan-mis/nextgen_obj
rajan-mis Jun 17, 2022
ce1e13b
Synced master object upgrade code with nextgen
rajan-mis Jun 21, 2022
1c59ba5
Merge pull request #658 from rajan-mis/nextgen_obj
rajan-mis Jun 21, 2022
f54c721
Upgradedirectory change for RHEL9
rajan-mis Jun 21, 2022
70754f9
Merge pull request #659 from rajan-mis/nextgen_obj
rajan-mis Jun 21, 2022
7bff5b3
PMswift upgrade backport from master to nextgen
rajan-mis Jun 22, 2022
ec5012d
Merge pull request #660 from rajan-mis/nextgen_obj
rajan-mis Jun 22, 2022
9226776
RHEL9 support code
rajan-mis Jun 24, 2022
4339229
Merge pull request #661 from rajan-mis/nextgen_obj
rajan-mis Jun 24, 2022
69b51d1
CES fix for nextgen
rajan-mis Jun 27, 2022
32ab345
Merge pull request #662 from rajan-mis/nextgen_obj
rajan-mis Jun 27, 2022
4c0a260
Node add fix
rajan-mis Jun 28, 2022
e26ef9e
Merge pull request #664 from rajan-mis/nextgen_rhel9
rajan-mis Jun 28, 2022
c9090dc
Add role name mapping table to migration guide
Jul 1, 2022
4538ae7
RHEL9 directory structure for local and remote installation
rajan-mis Jul 6, 2022
9281000
Merge pull request #667 from rajan-mis/nextgen_rhel9
rajan-mis Jul 6, 2022
8c6c053
Merge pull request #666 from acch/name_mapping_table
rajan-mis Jul 7, 2022
f7c4d12
Missing code from master to nextgen for tiebreaker node installation
rajan-mis Jul 15, 2022
5af3717
Merge pull request #669 from rajan-mis/nextgen_rhel9
rajan-mis Jul 15, 2022
6da6ba8
Update install_repository.yml
dheren-git Oct 14, 2022
4543ff0
Merge pull request #673 from dheren-git/scale_hdfs_rhel9
rajan-mis Oct 18, 2022
253a984
RHEL9 support for HDFS
dheren-git Oct 18, 2022
3423a5d
Merge pull request #674 from dheren-git/scale_hdfs_rhel9
rajan-mis Oct 18, 2022
10fe8e4
Remote mount variable name fix
rajan-mis Nov 2, 2022
e8bb23f
Merge pull request #675 from rajan-mis/remote_mount_fix_dev
rajan-mis Nov 2, 2022
14377b1
Fix for GUI user creation
rajan-mis Nov 16, 2022
ab70678
Merge pull request #677 from rajan-mis/gui_user_fix_main
rajan-mis Nov 16, 2022
f823cf4
New option for mmcrcluster for future release dev branch
rajan-mis Dec 22, 2022
f4bbe4c
Merge pull request #679 from rajan-mis/mmcrcluster_new_port
rajan-mis Dec 23, 2022
3b6f585
Add step to wait until GUI is up and running
Christop1964 Jan 6, 2023
8072747
Merge pull request #680 from Christop1964/guifix2
rajan-mis Jan 6, 2023
28a294d
Fix GPL sles installation issue
rajan-mis Jan 17, 2023
84ab9b5
GPL fix for ubuntu
rajan-mis Jan 17, 2023
2722da9
Merge pull request #681 from rajan-mis/gpl_sles_fix
rajan-mis Jan 17, 2023
11bca30
Fixed mmbuilgpl upgrade issue
rajan-mis Jan 24, 2023
cc8dc59
Merge pull request #682 from rajan-mis/gpl_sles_fix
rajan-mis Jan 24, 2023
3b79f4a
Fixed FAL issue
rajan-mis Feb 2, 2023
d85d5ab
Merge pull request #684 from rajan-mis/gpl_sles_fix
rajan-mis Feb 2, 2023
08737e8
Multi DA Support Dev branch
rajan-mis Mar 20, 2023
cbe4829
Merge pull request #690 from rajan-mis/multi_da_dev_support
rajan-mis Mar 20, 2023
3157555
Rename "Spectrum Scale" to "IBM Storage Scale"
Mar 20, 2023
d93d2f9
Fix link to variables documentation
Mar 20, 2023
59760e2
Code formatting
Mar 20, 2023
abb62bd
Improve wording
Mar 20, 2023
93fd5d8
Refer to Release Notes for detailled version information
Mar 20, 2023
322f3b4
Replace broken links
Mar 20, 2023
167459b
Fix ansible-core 2.10 deprecation warnings
Mar 20, 2023
6d9377f
Modernize wait-for-server handler
Mar 23, 2023
52dea09
Merge pull request #694 from acch/doc_updates
rajan-mis Mar 24, 2023
d56ffa4
GPGKey rename change
rajan-mis Apr 21, 2023
f13c171
Merge pull request #700 from rajan-mis/storage-scale-publickey
rajan-mis Apr 26, 2023
becc0c0
Public key rename fix
rajan-mis Apr 27, 2023
2cedee6
Merge pull request #701 from rajan-mis/storage-scale-publickey
rajan-mis Apr 28, 2023
13637b0
Merge pull request #695 from acch/210_deprecation
rajan-mis Jun 6, 2023
33ce85f
Merge pull request #697 from acch/waitforserver
rajan-mis Jun 6, 2023
dda59f9
Added option for NSDUsage and Storage pool for ECE
rajan-mis Jul 3, 2023
46fb632
Merge pull request #711 from rajan-mis/multida_ece
rajan-mis Jul 3, 2023
b60e8bf
Install pm-ganesha packages on local package install for sles.
Jul 4, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
Empty file modified CONTRIBUTING.md
100755 → 100644
Empty file.
133 changes: 133 additions & 0 deletions MIGRATING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,133 @@
# Migrating from master to main

This Git repository has two branches: `master`, which is now stable, and `main`, which is where new functionality will be implemented. Your playbooks need to be adjusted when switching from one branch to the other — and these adjustments are outlined in this document.

## What's changing?

A long-term goal of this project is to publish the code through [Ansible Galaxy](https://galaxy.ansible.com/). It became clear that changes to the project's directory structure would be inevitable to follow the conventions imposed by Galaxy (i.e. [Collections format](https://docs.ansible.com/ansible/latest/user_guide/collections_using.html)) — and this was taken as an opportunity to also rename all existing roles and some variables for consistency. See [#570](https://github.com/IBM/ibm-spectrum-scale-install-infra/pull/570), [#572](https://github.com/IBM/ibm-spectrum-scale-install-infra/pull/572), and [#590](https://github.com/IBM/ibm-spectrum-scale-install-infra/pull/590) for details.

All playbooks using the Ansible roles provided by this project need to adapt this new naming scheme, in order to use the latest updates implemented in the `main` branch.

**Important**: The `master` branch (previous default) will stay with the current naming scheme. It is considered stable, which means that only critical bug fixes will be added. New functionality will solely be implemented in the `main` (new default) branch.

## What do I need to do?

The following steps need to be taken in order to consume the `main` branch in your own projects:

- Repository contents need to be placed in a `collections/ansible_collections/ibm/spectrum_scale` directory, adjacent to your playbooks. The easiest way to do this is to clone the correct branch into the appropriate path:

```shell
$ git clone -b main https://github.com/IBM/ibm-spectrum-scale-install-infra.git collections/ansible_collections/ibm/spectrum_scale
```

The resulting directory structure should look similar to this:

```shell
my_project/
├── collections/
│ └── ansible_collections/
│ └── ibm/
│ └── spectrum_scale/
│ └── ...
├── hosts
└── playbook.yml
```

- Once the repository contents are available in the appropriate path, roles can be referenced by using their Fully Qualified Collection Name (FQCN). A minimal playbook should look similar to this:

```yaml
# playbook.yml:
---
- hosts: cluster01
roles:
- ibm.spectrum_scale.core_prepare
- ibm.spectrum_scale.core_install
- ibm.spectrum_scale.core_configure
- ibm.spectrum_scale.core_verify
```

Refer to the [Ansible User Guide](https://docs.ansible.com/ansible/latest/user_guide/collections_using.html#using-collections-in-a-playbook) for details on using collections, including alternate syntax with the `collections` keyword.

Note that all role names have changed:

- Old naming: `[component]/[precheck|node|cluster|postcheck]`
- New naming: `[component]_[prepare|install|configure|verify]`

Refer to the [name mapping table](#role-name-mapping-table) for a list of new role names.

- Some variables have been renamed for consistency as well, but it's expected that these changes only affect very few users. See [#590](https://github.com/IBM/ibm-spectrum-scale-install-infra/pull/590) for details, and refer to [VARIABLES.md](VARIABLES.md) for a complete listing of all available variables.

## Role Name Mapping Table

| `master` branch | `main` branch |
| -------------------------------- | ---------------------------------------- |
| callhome/cluster | ibm.spectrum_scale.callhome_configure |
| callhome/node | ibm.spectrum_scale.callhome_install |
| callhome/postcheck | ibm.spectrum_scale.callhome_verify |
| callhome/precheck | ibm.spectrum_scale.callhome_prepare |
| core/cluster | ibm.spectrum_scale.core_configure |
| core/common | ibm.spectrum_scale.core_common |
| core/node | ibm.spectrum_scale.core_install |
| core/postcheck | ibm.spectrum_scale.core_verify |
| core/precheck | ibm.spectrum_scale.core_prepare |
| core/upgrade | ibm.spectrum_scale.core_upgrade |
| gui/cluster | ibm.spectrum_scale.gui_configure |
| gui/node | ibm.spectrum_scale.gui_install |
| gui/postcheck | ibm.spectrum_scale.gui_verify |
| gui/precheck | ibm.spectrum_scale.gui_prepare |
| gui/upgrade | ibm.spectrum_scale.gui_upgrade |
| nfs/cluster | ibm.spectrum_scale.nfs_configure |
| nfs/common | ibm.spectrum_scale.ces_common |
| nfs/node | ibm.spectrum_scale.nfs_install |
| nfs/postcheck | ibm.spectrum_scale.nfs_verify |
| nfs/precheck | ibm.spectrum_scale.nfs_prepare |
| nfs/upgrade | ibm.spectrum_scale.nfs_upgrade |
| remote_mount/ | ibm.spectrum_scale.remotemount_configure |
| scale_auth/upgrade | ibm.spectrum_scale.auth_upgrade |
| scale_ece/cluster | ibm.spectrum_scale.ece_configure |
| scale_ece/node | ibm.spectrum_scale.ece_install |
| scale_ece/precheck | ibm.spectrum_scale.ece_prepare |
| scale_ece/upgrade | ibm.spectrum_scale.ece_upgrade |
| scale_fileauditlogging/cluster | ibm.spectrum_scale.fal_configure |
| scale_fileauditlogging/node | ibm.spectrum_scale.fal_install |
| scale_fileauditlogging/postcheck | ibm.spectrum_scale.fal_verify |
| scale_fileauditlogging/precheck | ibm.spectrum_scale.fal_prepare |
| scale_fileauditlogging/upgrade | ibm.spectrum_scale.fal_upgrade |
| scale_hdfs/cluster | ibm.spectrum_scale.hdfs_configure |
| scale_hdfs/node | ibm.spectrum_scale.hdfs_install |
| scale_hdfs/postcheck | ibm.spectrum_scale.hdfs_verify |
| scale_hdfs/precheck | ibm.spectrum_scale.hdfs_prepare |
| scale_hdfs/upgrade | ibm.spectrum_scale.hdfs_upgrade |
| scale_hpt/node | ibm.spectrum_scale.afm_cos_install |
| scale_hpt/postcheck | ibm.spectrum_scale.afm_cos_verify |
| scale_hpt/precheck | ibm.spectrum_scale.afm_cos_prepare |
| scale_hpt/upgrade | ibm.spectrum_scale.afm_cos_upgrade |
| scale_object/cluster | ibm.spectrum_scale.obj_configure |
| scale_object/node | ibm.spectrum_scale.obj_install |
| scale_object/postcheck | ibm.spectrum_scale.obj_verify |
| scale_object/precheck | ibm.spectrum_scale.obj_prepare |
| scale_object/upgrade | ibm.spectrum_scale.obj_upgrade |
| smb/cluster | ibm.spectrum_scale.smb_configure |
| smb/node | ibm.spectrum_scale.smb_install |
| smb/postcheck | ibm.spectrum_scale.smb_verify |
| smb/precheck | ibm.spectrum_scale.smb_prepare |
| smb/upgrade | ibm.spectrum_scale.smb_upgrade |
| zimon/cluster | ibm.spectrum_scale.perfmon_configure |
| zimon/node | ibm.spectrum_scale.perfmon_install |
| zimon/postcheck | ibm.spectrum_scale.perfmon_verify |
| zimon/precheck | ibm.spectrum_scale.perfmon_prepare |
| zimon/upgrade | ibm.spectrum_scale.perfmon_upgrade |

## Migration script

If you have existing playbooks which reference roles provided by this project, and you wish to migrate to the new format, then there is a [migration script](migrate.sh) available to replace all occurrences of role names in a given file. You can use the migration script like so:

```shell
$ ./migrate.sh playbook.yml
```

Note that the script will create a backup of the file prior to making any changes. Further note that the script does not perform any kind of syntax checking, so you will need to manually verify that the resulting code is syntactically correct.

## What if I need help?

Create a [new issue](https://github.com/IBM/ibm-spectrum-scale-install-infra/issues/new) and provide (the relevant parts of) your playbook, along with the exact error message.
Loading