Making an indirect connection for Firmware Upgrades

It is sometimes awkward to connect a Platinum systemA "platinum system" is any system running the Platinum operating system. This includes stand-alone acquisition systems such as EAMs and NAMs, DAS units such as the Affinity and DM24SxEAM and digital instruments with built-in acquisition systems such as the 3TDE, 40TDE or 5TDE., such as an EAM or 40TDE instrument, to the Internet for firmware upgrades. For example: in some cases, the only available Internet access is via WiFi so, if the Platinum system does not have a WiFi interface, direct connection becomes impossible. In these cases, a PC or laptop can be used as a gateway, allowing the Platinum system to contact the Güralp firmware server indirectly, via the PC.

For a full overview of the theory behind this technique, please see the Indirect Platinum Upgrades page. If you are using a Windows PC as a gateway, that page includes a link back here for detailed instructions. If your gateway PC runs Linux, please see the Indirect Platinum Upgrades - Linux instructions page for detailed instructions.

If the Platinum system can be given direct access to the Internet, please use the standard upgrade method instead.

Configuring indirect platinum upgrades for Windows users

To configure a Windows PC to act as an intermediary for a firmware upgrade connection:

Download and install PuTTYPuTTY is a free (both as in “free speech” and also as in “free beer”) and highly-recommended SSH client, telnet client and serial terminal emulator that runs under Windows and Linux. It should be downloaded from Simon Tatham's web-site.
(Beware of fake alternative download sites.) , if you do not already have it installed.

If you cannot or do not want to install third-party software on your PC, you can use the Linux command-line instructions in conjunction with the command-line SSH client shipped with Windows 10. (This feature may need to be enabled before use; please see this article for instructions.)
Open PuTTY – the following dialogue is displayed:
Enter the I.P. address of the Platinum system in the "Host Name (or IP address) field, as shown:
Select Connection→Data from the left-hand menu and enter root as the Auto-login username:
Select SSH → Tunnels from the left-hand menu. In this screen (shown below):
- Enter 8730 in the "Source port" field;
- Enter 46.43.14.141:873 in the "Destination" field; and
- Click the Re_mote radio button.
and then click

we have used an IP address - 46.43.14.141:873 - rather than a DNS name here in order to to remove a potential source of problems. If you are confident that your PC has a functioning name-resolution system, you can use rsync.guralp.com:873 in place of 46.43.14.141:873. This provides a degree of future-proofing, guarding against a change in the address of the Güralp firmware server.
Check that a new entry beginning R8730 appears in the central list area exactly as shown:
Select Sessions from the top of the left hand menu and enter a name for your Platinum system in the Saved Sessions box above the list of saved sessions. In the example below, we have used the name EAMxxxx but you are free to choose your own.
Click . Your new saved session should appear in the list below Default Settings:
Click . The first time you do this, a security dialogue is displayed:

Simply click (or, in some versions, "Accept") to clear this.
An emulator window then opens, prompting you for the root password of the Platinum system:

Enter the password and check that you reach the command line.
Once logged in, issue the commands

echo -e "RSYNC_HOST=localhost\nRSYNC_PORT=8730" >> /etc/conf.d/upgrade.local

This tells the upgrade system to use a different server and port number for the upgrade files, so that it can access the tunnel that you have created.
Leaving the emulator window open, switch to your browser and visit the web interface of your Platinum system.
Log in as root, using your normal password:
Select Tools → Firmware from the main menu:
Click or , as required, to initiate an appropriate upgrade, using the Linux PC as a port-forwarding gateway. The progress of the upgrade will be printed to the screen.
Once the upgrade is finished, return the upgrade subsystem to its default settings by switching to the PuTTY window and entering the command:
sed -i -e "/RSYNC_[PH]/d" /etc/conf.d/upgrade.local
Once the upgrade is finished, the SSH connection can be closed by keying Ctrl + D. Close the PuTTY window by clicking the in the top right-hand corner of the window.