RHEL Only: Upgrade vFabric SQLFire from the VMWare YUM Repository

When VMware releases a new maintenance version of SQLFire, the appropriate VMware YUM repository is updated to include the new RPM. You can use yum to quickly upgrade SQLFire to the latest version.

Prerequisites


Procedure


  1. On the RHEL VM or computer on which you have installed vFabric SQLfire, start a terminal either as the root user or as an unprivileged user using sudo.
  2. Execute the yum upgrade command to upgrade SQLFire:
    yum upgrade vfabric-sqlfire
    Note: The yum upgrade command shown in the preceding example upgrades SQLFire to the most recent RPM it finds in all of the repositories that the yum command knows about. If you want to upgrade to a version that is not the most recent, then you must explicitly specify the version in the yum upgrade command. Use yum search vfabric-sqlfire --showduplicates to find all versions of a component in all repositories.
  3. Enter y at the prompt to begin the actual upgrade.

    When the upgrade process is finished, you see the Complete! message.

  4. If you use the default SQLFire server configuration, then you must copy user data from the old server installation directory to the new, shared data directory (/var/opt/vmware/sqlfire). For example, if you were upgrading from version 1.0.1 you would enter:
    prompt# cp -Rp /opt/vfabric/sqlfire/vFabric_SQLFire_101/datadictionary \
                   /var/opt/vmware/sqlfire/
    prompt# cp -p /opt/vfabric/sqlfire/vFabric_SQLFire_101/vf.sf-license.cfg \
                  /var/opt/vmware/sqlfire/
  5. If you configured disk persistence or overflow for tables and you did not specify an explicit disk store to use, then you must copy the default disk store from the old SQLFire installation directory to the new directory. For example:
    prompt# cp -p /opt/vfabric/sqlfire/vFabric_SQLFire_101/BACKUPSQLF-DEFAULT-DISKSTORE* \
                   /var/opt/vmware/sqlfire/
  6. If you created new disk stores by specifying path relative to the old SQLFire version's working directory, you must copy those disk stores to the same relative directory in the new SQLFire installation. For example, if you created a disk store in the previous release using a command similar to:
    sqlf> CREATE DISKSTORE store1 'dir1';
    then you must copy the dir1 directory to the new SQLFire installation's working directory:
    prompt# cp -Rp /opt/vfabric/sqlfire/vFabric_SQLFire_101/dir1 \
                   /var/opt/vmware/sqlfire/
    Note: Disk stores that you created using a path outside of the older SQLFire working directory continue to work without any changes.
  7. If you modified /etc/sysconfig/sqlfire from the default configuration prior to the upgrade, the yum upgrade process saved your modifications to the file /etc/sysconfig/sqlfire.rpmsave . If you want to continue using these modifications, then you must manually update the new configuration file (/etc/sysconfig/sqlfire) with the same changes.
  8. If you made license key modifications to the old sqlfire.properties file (such as /opt/vfabric/sqlfire/vFabric_SQLFire_101/sqlfire.properties) prior to the upgrade, the yum upgrade process saved your modifications to the file /opt/vfabric/sqlfire/vFabric_SQLFire_101/sqlfire.properties.rpmsave. If you want to continue using these modifications, then you must manually update the new configuration file with the same changes.