2.6. Upgrading Subscription Asset Manager

  1. Back up the Subscription Asset Manager instance before beginning the upgrade procedure. Backing up a Subscription Asset Manager instance is covered in Section 9.1, “Backing up Subscription Asset Manager”.
  2. Stop all Subscription Asset Manager services: 
    [root@server]# katello-service stop
    If the katello-service command is not available, then stop the associated services manually: 
    [root@server]# service katello stop 
[root@server]# service katello-jobs stop 
[root@server]# service httpd stop 
[root@server]# service tomcat6 stop 
[root@server]# service elasticsearch stop

    Important

    Do not turn off the postgresql service.
  3. Flush the indexes.
    1. Start the Elasticsearch service: 
      # service elasticsearch start
    2. Flush the indexes: 
      # curl localhost:9200/_flush
    3. Stop the Elasticsearch service: 
      # service elasticsearch stop
  4. Upgrade the Subscription Asset Manager packages with yum: 
    [root@server]# yum upgrade
  5. yum avoids overwriting the current Subscription Asset Manager configuration by creating a set of .rpmnew and .rpmsave files. Check these files against the existing configuration for any new changes.
    For a list of configuration files, run the following command: 
    [root@server]# rpm -ql katello-configure | grep erb | grep etc | sed 's/.*etc/\/etc/' | sed 's/\.erb//'
    For a list of .rpmnew files, run the following command: 
    [root@server]# find /etc -name *rpmnew
  6. Upgrade Subscription Asset Manager using the upgrade script. 
    [root@server]# katello-upgrade
    The upgrade script prompts for confirmation for each part of the upgrade process. For example: 
    1/1: Update Candlepin (0003_update_candlepin.sh)
 Updates Candlepin database schema to the latest version

Do you want to proceed? (y/n): y

Update Candlepin OK.
  7. Run katello-configure to correct any configuration files and analyze log output for errors. 
    [root@server]# katello-configure

    Note

    In some cases, the configuration process is not finished after running katello-configure once. You will need to run katello-configure again to finish the configuration process. You can safely run katello-configure as many times as required to finish the configuration process, but twice is usually sufficient.
  8. Start the Subscription Asset Manager server: 
    [root@server]# katello-service start
  9. Test the Subscription Asset Manager server: 
    [root@server]# katello-service status
[root@server]# katello -u admin -p admin password ping
  10. Update the port settings on every Subscription Asset Manager agent system.
    The QPIDD port changed from 5674 to 5671 after Subscription Asset Manager 1.1. All systems connecting to Subscription Asset Manager using katello-agent must be updated to use port 5671.
    1. Upgrade your system to the latest version of katello-agent and goferd.
    2. Open the Katello plug-in configuration file: 
      [root@server]# vim /etc/gofer/plugins/katelloplugin.conf
    3. Edit the url line to change port number. 
      url=ssl://$(host):5671
    4. Restart the katello-agent and goferd services.
    5. Open port 5671 on your Subscription Asset Manager firewall. For example, add the following rule to iptables: 
      -A INPUT -p tcp -m state --state NEW -m tcp --dport 5671 -j ACCEPT