Topics/Tutorials

Remote Linux Replay

Jeff Daudel May 27, 2011

If you are making recordings on Linux and interested in replaying these recordings on Windows, you can do this using Remote Replay via Eclipse. From Eclipse running on Windows, you will configure remote SSH access to a Linux system or VM on which the recording will replay. Eclipse running on Windows will then connect to the Linux system and control the replay on Linux allowing for debugging.

System Requirements

  • Windows system with Eclipse 3.3 or later installed.
  • Linux system (physical or VM)
  • ReplayDIRECTOR installed on both the Windows and Linux systems 
  • SSH access to the Linux system

Firewall Requirements

The Windows machine will need to communicate to the Remote Linux Replay machine over three TCP ports:

  • 22 (SSH Port)
  • 10234 (Replay Agent Port)
  • 12345 (Eclipse Debugger Port) 

If any of these ports are not reachable, the feature will not work.

Configuration

You'll need to install the Replay Eclipse Plugin (which is part of the general ReplayDirector Installer).

In Eclipse:

  1. Goto Window Menu -> Preferences.
  2. In the Preferences Dialog, Select ReplayDIRECTOR -> Replay Preferences
  3. Set the following fields:

    RemoteReplayLinux.JPG


    "Host" - The hostname or IP address of the Linux box the will do the remote replay

    "SSH port" - Usually this is 22

    "Username" - Your login username to the Linux host. This user needs read and write access to the recordings folder and files.

    "Password" - Password for username

    "Java Home" - This is the JDK home that will be used to replay on the remote machine. Note that the JDK must be the same version (major and minor) of the recording. If you don't have it, you'll need to download and install the JDK. You can download JDKs from Oracle. Google 'download java jdk' to find them. This usually takes just a few minutes.

    "Replay Home" - This is the value of the REPLAY_HOME env var on the remote linux machine. This is normally the ReplayDIRECTOR installation folder.

    "Recordings Dir" - This is the location of recordings on the remove linux machine. Normally the RECORDINGS_DIR env var points to this folder. If its not set, you can leave it blank.
     

  4. Hit Apply. There should be no errors if all the values are correct.
  5. In the Preferences Dialog, goto ReplayDIRECTOR -> ReplayDIRECTOR Server.
  6. Make sure the RDS is added and selected as the default.

 

Using Remote Linux Replay

Replaying recordings remotely is similar to replaying them locally.

  1. Download the Linux recording you would like to replay to your Windows machine from Eclipse using the Recordings View. To download a recording, go to the Recordings view, enter the ID of the recording and click 'Download'. 
  2. Once downloaded, replaying this recording will use Remote Linux Replay automatically.

 When you click to replay a recording made on Linux, the Eclipse plugin will automatically download and start the replay on the remote machine. You will be able to debug the recording as it if were running locally on the Windows machine

 

.