Move migrate2rocky into it's own subdirectory.

Clean up the rocky-tools root dir, the mirror script has it's own subdir too.
This makes rocky-tools scale better. As this breaks existing links, we should
do it as early as possible, before GA.
This commit is contained in:
Electronic Eel 2021-06-11 19:12:40 +02:00
parent 761a27fecd
commit 750ed26f99
3 changed files with 71 additions and 62 deletions

View File

@ -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.

67
migrate2rocky/README.md Normal file
View File

@ -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.