2021-04-25 17:08:19 +00:00
|
|
|
Rocky Tools
|
|
|
|
|
===========
|
|
|
|
|
|
2021-04-25 17:10:34 +00:00
|
|
|
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.
|
|
|
|
|
|
2021-05-31 02:30:32 +00:00
|
|
|
## [migrate2rocky] -- Conversion Script
|
2021-05-04 02:33:47 +00:00
|
|
|
|
|
|
|
|
Running this script will convert an existing CentOS 8 system to Rocky Linux 8.
|
|
|
|
|
|
2021-05-04 02:35:41 +00:00
|
|
|
### Usage
|
2021-05-04 02:33:47 +00:00
|
|
|
|
|
|
|
|
```bash
|
2021-05-31 02:37:49 +00:00
|
|
|
./migrate2rocky.sh -h
|
2021-05-31 02:30:32 +00:00
|
|
|
├── -h # --> Display this help
|
|
|
|
|
├── -r # --> Convert to Rocky
|
|
|
|
|
└── -V # --> Verify switch
|
2021-05-04 02:33:47 +00:00
|
|
|
|
|
|
|
|
[!! USE WITH CAUTION !!]
|
2021-04-25 17:10:34 +00:00
|
|
|
```
|
2021-05-04 02:33:47 +00:00
|
|
|
|
2021-05-31 09:12:32 +00:00
|
|
|
### Known Issues
|
|
|
|
|
|
2021-06-04 23:30:45 +00:00
|
|
|
#### Katello clashes
|
|
|
|
|
|
2021-06-05 00:05:35 +00:00
|
|
|
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
|
2021-06-04 23:30:45 +00:00
|
|
|
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.
|
|
|
|
|
|
2021-05-31 09:12:32 +00:00
|
|
|
#### 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
|
2021-05-31 09:15:15 +00:00
|
|
|
...
|
2021-05-31 09:12:32 +00:00
|
|
|
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.
|
|
|
|
|
|
2021-05-31 15:13:33 +00:00
|
|
|
### Latest Version
|
|
|
|
|
|
|
|
|
|
The latest version of this script can be found [here](https://github.com/rocky-linux/rocky-tools/).
|
|
|
|
|
|
2021-05-04 02:35:41 +00:00
|
|
|
### Debugging
|
2021-05-04 02:33:47 +00:00
|
|
|
|
2021-05-31 02:30:32 +00:00
|
|
|
The `migrate2rocky` script pipes everything shown on `stdout` and `stderr` to
|
|
|
|
|
`/var/log/migrate2rocky.log`.
|
2021-05-04 02:33:47 +00:00
|
|
|
|
2021-05-31 02:30:32 +00:00
|
|
|
If you run in to issues executing this script, please submit an issue
|
|
|
|
|
[here](https://github.com/rocky-linux/rocky-tools/issues).
|
2021-05-04 02:33:47 +00:00
|
|
|
|
2021-05-31 02:44:38 +00:00
|
|
|
Make sure to include the output log, and remove any sensitive information. (if
|
|
|
|
|
any)
|
2021-05-04 02:33:47 +00:00
|
|
|
|
|
|
|
|
Feel free to create a pull request if you think you've got the fix.
|
