18 The HELIOS Update Installer

HELIOS Software GmbH offers several options to keep your HELIOS software current. There are options for both product updates and upgrades.

Updates include bug fixes, 3rd party compatibility patches, and product enhancements, and are released on an on-going as-needed basis. Updates are available for download from the HELIOS support website to authorized users.

HELIOS products include free updates (not version upgrades) for a 30 day period after purchase. Thereafter, updates are available to those who subscribe to one of the three HELIOS Update/Upgrade options, SE001 or SE002.

Upgrades are major new product versions and are only available via CD. Upgrades are automatically sent to customers with current SE002 contracts, for the covered product, at no additional charge. Further information about these "Software Upgrade Service" options is available from your reseller.

SE001 provides web-only access to updates for your current version, of the covered product. It can be purchased for any products at any time. Upgrades to a new version are not included.

Product SE002 allows access to the HELIOS update download area on the internet, and it lets the customer receive upgrades on new distribution CD-ROMs free of charge.

Note The "Software Upgrade Service Agreement" can only be purchased within 30 days of purchase of the license you are registering. Each Software Upgrade Service covers only one product (e.g. If you have an EtherShare and an ImageServer, you will need two Service Agreements).

SE003 allows switching to a backup server hardware. The agreement is available for base products only (EtherShare, PCShare, WebShare, and Base Windows).

SE003 is an option for the SE002 software upgrade service and includes additional back-up for the base license and all its user expansions. Back-up for optional HELIOS add-ons (e.g. ImageServer, PDF HandShake, PrintPreview) is covered, too. Separate standard software update service agreements for ImageServer, PDF HandShake, and PrintPreview are recommended.

An automatic software upgrade service ("Software Upgrade Service Agreement") is available for end-users who wish to have immediate access to updates via the HELIOS web site, and to receive accumulated updates, and upgrades, via CD-ROM.

Another way to obtain the latest HELIOS software updates (but not upgrades) is called "Internet Update Access", which provides the customer with the latest updates via the HELIOS website.

Customers not taking part in the update or upgrade service will only receive product updates (but not version upgrades) within 30 days after the software purchase. Customers can still upgrade their software when new major releases become available, by paying the appropriate upgrade fee. HELIOS will inform all customers who do not have an upgrade service contract about fees for upgrading existing installations as soon as new releases become available.

For both update service products contact your supplier for price information and for a copy of the relevant application form, or visit the HELIOS website.

18.2 Using the HELIOS Update Installer

To view a list of all HELIOS modules and their update levels, log on to HELIOS Admin as a user with "SysAdm" privileges, and select Versions on the Lists menu.

Note: If you need information about a certain update or update level, please check the distribution CD-ROM or the HELIOS website.

Alternatively, if the HELIOS Services are already running on your server you can use the "uwhat" utility (see 8.22 "uwhat") to get information about the current update level of the HELIOS modules. For example, the entry "afpsrv 4.0.0uXYZ" indicates that the HELIOS update u0XYZ is already installed.

"uwhat" does not display updates in the way the HELIOS Update Installer does. Thus, it is more reliable to use the HELIOS Update Installer (options List Updates and List History) for precise information about the update level on your server. The HELIOS Update Installer is described below.

New HELIOS updates are included in every new distribution CD-ROM and can also be downloaded by authorized users from the HELIOS web server. If you receive a new CD-ROM and want to add the updates to your HELIOS installation, check the /updates directory on the CD-ROM for the update program files, and the support section on the HELIOS website for detailed descriptions of the updates.

For update installations, we strongly recommend to use our update installer. The tool is able to find and install all updates that are required for a particular product and to check interdependencies of certain updates. The installer is easy to handle and can also be used to retrieve information about updates or to uninstall a particular update, if required.

To start the HELIOS Update Installer (Fig. 109), open a shell and enter the following command:

The items in the main menu can be selected by typing the first letter. E.g. typing "s" will highlight the Setup item.

For detailed information on navigating within the HELIOS Update Installer read the instructions in 4.1.5 "Navigating within the HELIOS Installer". Operating the HELIOS Update Installer is almost the same as operating the HELIOS Installer.

The ESC key (Ctrl-X) always lets you return to the start-up window and the main menu.

The HELIOS Update Installer offers eight different options in its main menu (Fig. 109):

Note that the HELIOS Update Installer does not automatically stop the HELIOS services, because this is usually not required. However, to avoid problems, we recommend to stop all printer queues before starting to install updates and to stop and restart the HELIOS services (commands
"stop-helios" and "start-helios", respectively) some time after the update installation to make the newly installed modules available. You must stop the HELIOS services before you select the Commit Updates option. Otherwise, serious problems can arise.

To install new updates, you should always open the General setup dialog first and check whether the update search path is correct (Fig. 110).

Fig. 110: The General Setup dialog

If you have to replace the path entry, use the BACKSPACE key to delete the old one. You can enter several search paths at a time, in case you have different updates repositories. E.g. in Fig. 110 we have defined two search paths. They are separated by a ":".

The HELIOS Update Server Setup dialog (Fig. 111) lets you specify a path (Download path) where the downloaded updates are saved. Additionally you are asked for the name of the HTTP Proxy server you want to use, and its port number. In the Serial Numbers section enter the code of each product for accessing the HELIOS Update Server.

Note: If invalid (or no) serial numbers are entered, the update descriptions can be downloaded, but not the updates themselves.

Your current update level can optionally be entered in the Hide updates below field so that only newer updates are downloaded.

Important: Do not specify a higher number because interdependencies need to be checked!

The List Updates window lists all updates that are related to a certain product and indicates the state of each update. This means, you get information if an update is applied, already superseded, or not installed. If you select an update from the list and press ENTER, the HELIOS Update Installer will display the corresponding description (Fig. 112).

Fig. 112: The List Updates dialog window

The List History window (Fig. 113) reveals the product update history for the specified path.

To download updates from the HELIOS Update Server via the Internet proceed as follows:

Select the Download Updates item and confirm the dialog box that appears first with (Fig. 114).

A Download Status list, which appears upon confirmation of the preceding dialog, shows the progress of the update loading process (Fig. 115) and disappears automatically when the loading has been completed.

At this point, update description files have been downloaded to the specified directory. Next, relevant updates for each product are displayed, and can be selected for download.

In the Download from the HELIOS Update Server dialog (Fig. 116) select the HELIOS product you want to update and the architecture your host uses.

To select the desired product and architecture, move to the appropriate field, and press RETURN to display a list of options. Select the desired option, and press RETURN.

In the Update-Description section select and mark the update for download according to the instructions given in Custom Update. You can mark more than one update at a time. Then confirm your selection with Ok.

As soon as the download is complete, an Information box appears, which states the number of updates and the directory where they have been saved to.

Note: The HELIOS Update Installer uses the standard HTTP port (80) or if configured the proxy server port number for downloading updates from the server.

This information may be important if you set up a firewall on your system.

The easiest way of installing updates is to use the Express Update option (Fig. 117). The correct Install path is detected automatically by the HELIOS Update Installer. The installation will be performed automatically when you confirm with the Ok button.

Fig. 117: The express Update dialog

In contrast to the Express Update item you do not just select the mere product in the Custom Update dialog window, but each single update you want to install for that particular product (Fig. 118). The correct Install path is detected automatically by the HELIOS Update Installer. However, it is possible to override the path entry.

To obtain more information on the specific updates highlight an update in the Updates section and press ENTER. To mark an update for installation highlight it and use the following keys to select/deselect updates for installation or removal. See also the bottom line of the dialog (Fig. 118):

As soon as the installation is complete, you will be notified that all updates have been successfully installed.

Fig. 118: The Custom Update dialog

Commit Updates removes previous update versions. Note that "stop-helios" and "start-helios" should have been issued since updates were installed the last time. If in doubt, issue "stop-helios" and "start-helios" before committing updates.

In the Updates section of the Commit Update dialog (Fig. 119) select and mark the update you wish to commit according to the instructions given in Custom Update. You can mark more than one update at a time. Then confirm your selection with Ok.

After you have committed an update, there is no simple way, apart from reinstalling the product, to fall back to a previous version. As soon as the committal has been completed, an Information box appears stating that the committal has been successful.

Please remember that you have to stop the HELIOS services before committing any updates. Otherwise certain processes could be "killed".

Fig. 119: The Commit Update dialog

Some updates change the behavior of certain product modules. To uninstall updates you do not want to work with, use the Remove Updates option. The respective dialog window is shown in Fig. 120. There may be interdependencies between several updates, i.e. certain updates cannot be removed as long as they are required by other updates that are still installed. The dialog window displays either all removable or all non-removable updates. Updates you have already committed can no longer be removed.

Fig. 120: The Remove Update dialog

HELIOS Base UB⁺ User manual