RBSUPDATE - The Update Utility
RBSUPDATE - The Update Utility
RBSUpdate is the built-in automatic update utility that you can use to update your Client software. It is included in your Client installations. To use it, activate it with a registry key in the rbackup.reg file. (see Customizing the Client Installer) The default is for RBSUpdate to NOT be activated.
You can set RBSUpdate to run automatically during scheduled backups. You can also run it manually, and you can schedule it with Windows Task Scheduler. RBSUpdate does not run when you run a manual backup - only during scheduled backups.
Important Note: Unlike the other scripts, .INI files, .REG files, and .LNG files used to customize the Client installer, this file must be hosted on a web server. Do not include it in your Client installation file set.
RBSUpdate can be run with different options to deliver your updates and information the way that best fits your business. In its simplest mode, RBSUpdate displays a message that informs the user if there's an update to his software, and a link.
The user can click the link to perform several actions that you can program. The link can install the update from an .EXE file stored on your web server, or it can perform like any HTTP link by taking the user to a web page, or any other web-based action.
RBSUpdate can display an informative link with news and special offers.
If no update is available, RBSUpdate can notify the user.
RBSUpdate can also run automatically and install updates silently without user intervention, and without displaying an interface. You can set it to run at the end of every backup session, and you can also launch it from Windows Task Scheduler.
To program RBSUpdate, you will need to write a script file and make it available on a web server. When it is run, RBSUpdate will read the script file from the web server and perform the actions you have programmed it to do.
The script file is written with Windows Notepad. You can copy and paste this sample into Notepad to use as a template. Typically, this script file is called update.txt, although you can use different names for different versions of your software if you want to maintain separate updates.
Here's an example of an update script. This script causes RBSUpdate to do the following things:
client_txt=Click Here to upgrade to Jumbo Backup v9.31
info_txt=There's exiting news at Jumbo Backup! Click here to read all about it.
noupdates=Your software is up to date. No updates required.
Form_Caption=Jumbo Backup Software Updates
Select the links above for information and software updates. For help with updates go to the Jumbo Backup web site at http://Jumbobackup.com and select Tech Support.
The RBSUpdate update file is a text file in a specific format. Open Windows Notepad. Copy the sample script (above) into a blank document. Save it as file name update.txt or a different file name, if you intend to maintain different versions of your updates. Save the file as type Text Documents (*.txt)withEncodingasANSI
Now that the update file is saved, edit it and save it again.
Specify the version number of the Client software that is currently available as an update. RBSUpdate will compare the version number of the installed software with the version number you specify here. If the version number of the installed version is LESS THAN the version number specified here, RBSUpdate will perform an update action as indicated below. Otherwise, RBSUpdate will display the noupdates text (below).
[versions] : info
This value is an index to the most recently displayed info_txt value. RBSUpdate will display a particular info_txt (below) only once per client. When a specific info_txt is displayed, RBSUpdate remembers this value and will not display info_txt again until this value is incremented. So, when you want to display a new info_txt on your Clients' screens, change the value if info_txt and increment info. When RBSUpdate is initially installed, the value if info is set to 1000. So, if you never want to display any of the info_ text or links, never increment the value if info.
[dates] : client_date
The date, in this exact format, that the Client update was first made available. This date is displayed in the first column in the interactive RBSUpdate display, to the left of the text defined in client_txt below. Format MUST be MM-DD-YYYY
[dates] : info_date
The date, in this exact format, that the Client update was first made available. This date is displayed in the first column in the interactive RBSUpdate display, to the left of the text defined in info_txt below. Format MUST be MM-DD-YYYY. Note: All of the links that start with info_ are optional.
[text] : client_txt
This is the text displayed by RBSUpdate, as a hyperlink pointing to the URL defined by client_link (below). This text is displayed when the goto: command is included in client_link below.
[text] : info_txt
This is the text displayed as a result of incrementing the info value above. It is usually used to announce news or special information. This text is displayed as a hyperlink pointing to the URL defined by info_link below. Note: All of the links that start with info_ are optional.
[links] : client_link
This is the URL used as the link for client_txt above. It should point to an HTML object, a web page or .EXE file, or any web-based resource. It must be a valid URL including http:// and preceded by one of the following commands:
This is the URL used as the link for info_txt above. It should point to an HTML object, a web page or .EXE file, or any web-based resource. It must be a valid URL in the format goto:http://yourdomain.com/updates.htm. Unlike the client_link above, the info_link does not respond to the run: command and MUST contain the goto: command.
[messages] : noupdates
This defines the text displayed by RBSUpdate when no updates are available - when the version number defined in [versions] : clientis equal to or less than the version number of the currently installed software.
This defines the text displayed in the caption of the RBSUpdate screens. The caption is the first text on the screens, at the top left, displayed with the icon. See the example graphic at the top of this chapter.
In this section, define the help text at the bottom of the RBSUpdate screen. See the example graphic at the top of this chapter.
Step 2: Upload the Update File to your Web Server
The RBSUpdate Update File that you created in Step 1 (usually called update.txt) must be hosted on a web server, at a location reachable by the public, like a regular web page. Use any FTP utility (or your preferred method) to post your update file where it can be accessed by a web browser.
RBSUpdate needs to know where to find your update.txt file on the web. This link is stored in a registry key, and must be included in your rbackup.reg file. Please read the rbackup.reg section of the Customize Client Installer chapter.
In the rbackup.reg file, set the value of UpdateInfo to the URL of your update.txt file. Here's an example:
If you want RBSUpdate to automatically check for updates at the end of every Remote Backup session, also set the value of AutoUpdate to True. There are several ways to change how RBSUpdate runs in AutoUpdate mode:
Download and Install the Update with User Interaction
In this mode RBSUpdate displays a message ONLY if an update is available. If there is no update available, RBSUpdate displays no screen at all. If an update is available, RBSUpdate displays a screen like the following, and waits for the user to select the option to update. This is usually the preferred way to run RBSUpdate in AutoUpdate mode.
To make RBSUpdate operate like this, set AutoUpdate to True and use the update.txt script example above.
Silently Download and Install the Update
In this mode RBSUpdate will update the software automatically, without displaying screens at all. *
Setting up silent automatic updates requires several steps. Perform them in this order.
* Notes on Rebooting
Reboots after upgrades are required only in some (and not all) cases only when one of the components being updated is currently in use by another program. Because RBackup shares some components with Windows, and computers vary widely, it is impossible to predict when a reboot will be required.
Use the RBS Manager's Customize Client Installer feature to complete customizing your client software (if you haven't done it already)
The update.txt file and your update EXE file must be served from a web server. You can install a web server on the same computer as your RBS Server using Microsoft's Internet Information Service (IIS) or any other web server, like Apache. However, we recommend hosting these files on a high-bandwidth web host instead, to avoid additional burden on your RBS Server.
Copy the update.txt and update.exe files into the Web location specified in the URL you entered in Step 3 above.
Most Service Providers use the same distribution file for updates as they do for initial installations. If that's what you are going to do, you may distribute your update.exe file, and it will serve as both an installer and an updater.