diff --git a/README.md b/README.md index 267455e..3017e7b 100644 --- a/README.md +++ b/README.md @@ -2,71 +2,13 @@ Rocky Tools =========== Various scripts and tools that we find useful, whether we use them or they are -made for public consumption. For example, conversion scripts or otherwise. +made for public consumption. -## [migrate2rocky] -- Conversion Script +## [migrate2rocky](./migrate2rocky/) -- Conversion Script Running this script will convert an existing CentOS 8 system to Rocky Linux 8. -### Usage +## [mirrorsync](./mirror/) -- Mirror Script -```bash -./migrate2rocky.sh -h -├── -h # --> Display this help -├── -r # --> Convert to Rocky -└── -V # --> Verify switch +Example script for keeping a public or private mirror in sync. -[!! USE WITH CAUTION !!] -``` - -### Known Issues - -#### Katello clashes - -Katello installs its own repositories via subscription-manager that are meant to -replace the ones from CentOS, but it does not remove, or even disable, the -corresponding CentOS repositories. This would cause issues to a normal running -system, but it is especially problematic for migrate2rocky as it means that -migrate2rocky cannot properly determine which repositories to remove and -attempting to run migrate2rocky on a katello will likely result in a corrupted -system. - -#### RHEL migrations show error messages during conversion - -``` - Installing : rocky-release-8.3-13.el8.noarch 2/5Error unpacking rpm package rocky-release-8.3-13.el8.noarch -... -error: unpacking of archive failed on file /usr/share/redhat-release: cpio: File from package already exists as a directory in system -error: rocky-release-8.3-13.el8.noarch: install failed -... -Error: Transaction failed -``` - -This results from conflicts in the directory structure of RHEL with that of -RockyLinux. migrate2rocky will detect the issue and go on to remove the -conflicting directory and install rocky-release with the rpm command. - -#### Grub still shows kernel entries from previous installation - -This is normal. The running kernel cannot be safely removed when migrate2rocky -is run. The RockyLinux kernel should come up as the default highlighed kernel -on reboot but the other ones will remain until they are removed or replaced by -newer kernels. If you want you can manually remove the old kernels after reboot -with dnf or rpm. - -### Latest Version - -The latest version of this script can be found [here](https://github.com/rocky-linux/rocky-tools/). - -### Debugging - -The `migrate2rocky` script pipes everything shown on `stdout` and `stderr` to -`/var/log/migrate2rocky.log`. - -If you run in to issues executing this script, please submit an issue -[here](https://github.com/rocky-linux/rocky-tools/issues). - -Make sure to include the output log, and remove any sensitive information. (if -any) - -Feel free to create a pull request if you think you've got the fix. diff --git a/migrate2rocky/README.md b/migrate2rocky/README.md new file mode 100644 index 0000000..07037c4 --- /dev/null +++ b/migrate2rocky/README.md @@ -0,0 +1,67 @@ +migrate2rocky -- Conversion Script +=========== + +Running this script will convert an existing CentOS 8 system to Rocky Linux 8. + +### Usage + +```bash +./migrate2rocky.sh -h +├── -h # --> Display this help +├── -r # --> Convert to Rocky +└── -V # --> Verify switch + +[!! USE WITH CAUTION !!] +``` + +### Known Issues + +#### Katello clashes + +Katello installs its own repositories via subscription-manager that are meant to +replace the ones from CentOS, but it does not remove, or even disable, the +corresponding CentOS repositories. This would cause issues to a normal running +system, but it is especially problematic for migrate2rocky as it means that +migrate2rocky cannot properly determine which repositories to remove and +attempting to run migrate2rocky on a katello will likely result in a corrupted +system. + +#### RHEL migrations show error messages during conversion + +``` + Installing : rocky-release-8.3-13.el8.noarch 2/5Error unpacking rpm package rocky-release-8.3-13.el8.noarch +... +error: unpacking of archive failed on file /usr/share/redhat-release: cpio: File from package already exists as a directory in system +error: rocky-release-8.3-13.el8.noarch: install failed +... +Error: Transaction failed +``` + +This results from conflicts in the directory structure of RHEL with that of +RockyLinux. migrate2rocky will detect the issue and go on to remove the +conflicting directory and install rocky-release with the rpm command. + +#### Grub still shows kernel entries from previous installation + +This is normal. The running kernel cannot be safely removed when migrate2rocky +is run. The RockyLinux kernel should come up as the default highlighed kernel +on reboot but the other ones will remain until they are removed or replaced by +newer kernels. If you want you can manually remove the old kernels after reboot +with dnf or rpm. + +### Latest Version + +The latest version of this script can be found [here](https://github.com/rocky-linux/rocky-tools/). + +### Debugging + +The `migrate2rocky` script pipes everything shown on `stdout` and `stderr` to +`/var/log/migrate2rocky.log`. + +If you run in to issues executing this script, please submit an issue +[here](https://github.com/rocky-linux/rocky-tools/issues). + +Make sure to include the output log, and remove any sensitive information. (if +any) + +Feel free to create a pull request if you think you've got the fix. diff --git a/migrate2rocky.sh b/migrate2rocky/migrate2rocky.sh similarity index 100% rename from migrate2rocky.sh rename to migrate2rocky/migrate2rocky.sh