Due to the evolution of Katello as a standalone application into a plugin to The Foreman, an upgrade is not feasible. We regret that instead of an upgrade you will need to transition to a new server.
The following terminology changes have occured between Katello 1.4 and 2.0:
The general steps for transitioning are:
Follow the installation instructions for the latest Katello version: Installation
If you are using Red Hat Content you will want to import your Subscription Manifest in the same way as you had done on your previous Katello instance. You will likely want to create the same set of Lifecycle Environments.
For Red Hat repositories that come from your subscription manifest, we recommend to re-enable these and sync them again to the new server.
For custom content you can re-create them with the same upstream url and sync them again. Alternatively you can sync them from your existing Katello server. Assuming the custom repo has been published with ‘HTTP’ enabled, set the url of the repository in the Katello 2.0 server to the repository’s url on the Katello 1.4 Server. It would look something like:
For custom content that was not published via HTTP, it will not be available for the new Katello Server to easily sync. You can, however, SCP it over to the new server and then manually import it there:
On the Katello 2.0 server, create a directory to hold each repo:
mkdir -p /repos/my_product/my_repo
repeat for each product and repo you want to transfer. Note that you cannot use /tmp for this as pulp can not sync from /tmp locally.
On the Katello 1.4 server, copy over each repo:
scp - r /var/lib/pulp/published/https/repos/ACME_Corporation/Library/custom/my_product/my_repo/ root@KATELLO2.0:/repos/my_product/my_repo
Replacing ‘KATELLO2.0’ with the hostname or IP address of your Katello 2.0 server. Note that each repo path will follow a similar directory path of /var/lib/pulp/published/https/repos/ORG/Library/custom/PRODUCT/REPO. Repeat for each Repository you want to copy.
chmod 755 /repos/my_product/my_repo -R
Other items such as:
Will all need to be recreated manually through the UI or through the Hammer CLI tool. We recommend to create things like Activation Keys and Host Collections prior to transitioning your Systems over to make it easier to re-register them.
In order to move systems to the new Katello server you will need to re-register them. On each system:
Remove the existing bootstrap rpm:
rpm -e `rpm -qf /etc/rhsm/ca/candlepin-local.pem`
Install the new bootstrap rpm (replacing HOSTNAME with your Katello server’s hostname):
rpm -Uvh http://HOSTNAME/pub/katello-ca-consumer-latest.noarch.rpm
subscription-manager register --user=admin --password=changme --org=Default_Organization --environment=Library
Or you may create an activation key and register with that:
subscription-manager register --org=Default_Organization --activationkey=mykey