Port Forwarding

Operating System Requirements

Linux: No special requirements

Mac: No special requirements

Windows: WSL (Windows Subsystem for Linux), which can be found from the Microsoft Store. Make sure to download Ubuntu as the distribution. Note: Even though the download below has a Windows installation, it cannot be used to SSH into the XDC. The mrg commands must be run within the same directory as the mrg file, but it will not let the user SSH until support is added.

Application Requirements

The instructions assume you have installed mrg utility on your home machine. To do so, please obtain the source (and follow README to compile it) or binary from this site.

The instructions also assume that you have configured your API point (you only have to do this once) and have logged into your merge account by doing mrg login yourusername -p yourpassword (you have to do this each time you open a new terminal on your machine).

Port Forwarding Steps

Make sure that you have realized and materialized your experiment, and that you have set it up.

To do the actual port forwarding between a port yourport on your machine and node yournode in an experiment within yourproject via an XDC named yourxdc, you need to SSH with the following command:

mrg xdc ssh yourxdc.yourproject -L yourport:yournode:80

So, to port forwarding onto 8080 with the pathname lab, you would type this:

mrg xdc ssh xdc.yourusername -L 8080:pathname:80