Update your appliance using zypper

This topic describes how to update the software on your appliance using the zypper utility.

Tip   You can also use the Web Administration Interface to manage updates for system software and API Gateway software. For more information, see Manage software updates.

Introduction to zypper

zypper is a tool which provides an easy way to manage RPM software packages and their dependencies on a system. When you use zypper to update software it checks the configured package repositories to find the latest versions of installed RPMs and any dependencies required.

Axway zypper repository

Axway maintains a repository which contains updates to software packages along with any security updates to appliance-specific OS packages. It is already included in the appliance distribution.

Apply security updates

To check if any new versions of the system packages are available run the following command:

# zypper list-updates

This returns a list a of packages from the repository if there are updates required.

Run the following command to install the new packages:

# zypper -n update --auto-agree-with-licenses

Run the list-updates command when the system is first deployed, and periodically afterward.

Install updates on a system without Internet access

If the system to be updated does not have access to the Internet then it is not possible to use zypper for any updates. In this case Axway Support can provide the update packages required for your system. To provide Axway Support with a list of the currently installed packages, run the following command:

# rpm -qa > installed_rpms.txt

You can send the file installed_rpms.txt to Axway Support, who can provide you with a tarball of RPM updates that you can copy to the target system (either using SCP or the Web Administration Interface).

To install the updates, follow these steps:

  1. Log in to the appliance using the default administrator account (user name admin ) and use su - to switch to the root user after logging in. You can log in locally or using SSH. For more information, see Connect to consoles and user interfaces.
  2. Change to the directory where the update bundle is stored.
  3. Run the following commands:
  4. # tar -zxf update-RPMs-7.1.0_to_7.2.2-2014-01-16.tar.gz
    # cd update-RPMs-7.1.0_to_7.2.2-2014-01-16
    # sh upgrade.sh
    # reboot
Note   This is an example only. The update bundle file name is different on your system.
  1. Change directory to the location where you have copied the new RPMs and execute:
  2. # rpm -Uvh *.rpm 
  3. This updates the necessary packages.

Use zypper through a proxy server

To enable all zypper operations to use a proxy server, run the command yast proxy and enter the proxy configuration information. You can also configure a proxy server using the Appliance Console Menu. For more information, see Configure proxies.

zypper commands

To check if there are any new available software updates, enter this command:

# zypper list-updates

To apply all updates:

# zypper update

To apply all updates and automatically answer yes to any questions asked by zypper:

# zypper --non-interactive update --auto-agree-with-licenses

To search for a specific package, enter this command:

# zypper search <keyword>

Axway Support can issue important bug fixes or extra functionality for the appliance through the zypper repository. To install such a package, run the following command:

# zypper install -l <package-name>

rpm commands

You should not run standalone rpm commands to install any package and zypper should be preferred whenever possible. However, if it cannot be avoided then use this command to install or upgrade a package:

# rpm -Uvh <package-name> 

You can specify multiple packages on the command line. This is sometimes necessary, for example, to satisfy a particular dependency. Whenever you use rpm to install or upgrade a package, you should save the output of the command.

The following command shows all installed package versions. It can be used with grep to find specific packages.

# rpm -qa

The following command shows all files associated with a package:

# rpm -qli <package-name> 

Install software patches provided as a tarball

In some cases a software patch is made available as a tarball (gzip compressed tar file). To install a file like this on the appliance, you must either use SCP to transfer the file to the appliance, or copy it to the system using a USB drive.

To transfer a file using SCP, enter the following command:

# scp gateway-patch-name.tgz admin@appliance-hostname:

To copy the file from a USB drive:

  1. Insert the ext2/3 or FAT32 formatted USB drive in to the appliance.
  2. Mount the USB drive.
  1. Copy the file from the USB drive to the disk.
  1. Unmount and remove the USB drive.

To extract and install the patch:

  1. Log in to the appliance using the default administrator account (user name admin ) and use su - to switch to the root user after logging in. You can log in locally or using SSH. For more information, see Connect to consoles and user interfaces.
  2. Change directory to the location of the .tgz file and execute the following command:
# tar zxvf gateway-patch-name.tar.gz -C /opt/Axway-7.5.3/apigateway
  1. After extracting the files, run the following command to set the correct ownership on the new files:
# chown -R admin:admin /opt/Axway-7.5.3/apigateway

Related Links