How to retrieve copies of the messages* files from a Platinum system - Windows Network connection.

Overview

The file /var/log/messages contains important diagnostic information about your 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.. Historical copies of this file are saved as messages.0, messages.1 and so on. Technical support staff may occasionally request that you send them copies of these files to assist in diagnosing problems with your system. This document describes how to do this from a Windows PC or laptop using a network connection.

Preparation

Additional software is required. The PuTTY package provides terminal emulation and is required. It also provides command-line file transfer but, if you prefer to use graphical tools, you may wish to install WinSCP as well. WinSCP has a graphical “drag-and-drop” interface, similar to Norton Commander.

When downloading 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.) , select the full installation in order to include the PSFTP program.
Optional: WinSCP can be downloaded from winscp.net/eng/download.php
.

Creating the archive

Start by logging on to the command line of the EAM using PuTTY. Log in as normal and then issue the commands

cd /var/log tar cvzf msg.tgz messages*

This creates a compressed archive file called msg.tgz which we now need to copy to your PC.

Downloading the archive

Please follow the instructions under either Using PSFTP from the PuTTY distribution or Using WinSCP, below, depending on your choice of software.

Using PSFTP from the PuTTY distribution

Key windows + r and enter "C:\Program Files\PuTTY\Bin\psftp.exe" (or wherever you chose to install the PuTTY binaries) including the quote marks ("), then key enter.

A window opens with a command prompt. Enter the following command:

open 192.0.2.0

replacing 192.0.2.0 with the IP address or DNS name of your Platinum system.

If your display does not look like the screen-shot above, please check that you are using PSFTP and not the main PuTTY program.

Key y in response to the question about host keys, if asked, and then enter root and your root password at the login: and password: prompts.

Once logged in, issue the following commands:

lcd C:\Users\you.YourDomain\ cd /var/log get msg.tgz lpwd quit

replacing C:\Users\you.YourDomain\ with the path to a directory in which you have write permission. This is where PSFTP will store the downloaded file.

The lpwd command prints the name of the folder on your PC into which the archive file has been saved. From here, you can use your normal email tools to send it to GSL support staff.

Using WinSCP

Type WinSCP into Window's search box and pick the WinSCP Desktop app from the list of results:

A login screen appears: fill in the IP address or DNS name of your Platinum system in the Host name field and enter root and your root password in the User name and Password field. Click Login to continue and click Yes to continue if you receive a security alert mentioning the server’s host key.

A split window appears: the left hand side shows files and folders on your local PC and the right hand side shows files and directories on the Platinum system. Type ctrl + o and enter /var/log to open the required directory. If the files are not visible, type ctrl + alt + t to open the file viewer. Select an appropriate destination folder in the left hand pane and then drag the msg.tgz file into it. You can then use your normal email tools to send the file to GSL support staff.

You can then use your normal email tools to send the transferred file to GSL support staff.