Argonne National Laboratory

GM/CA @ APS

Remote Access

Department of Energy Office of Science
GM/CA @ APS Sponsors:
National Institute of General Medical Sciences (NIGMS) and National Cancer Institute (NCI) of the National Institutes of Health (NIH)
 

 
Remote IP = 54.198.134.32
 

Steps for Remote Access

Before your beamtime starts

1. Review documentation

2. Check your hardware and network compatibility

3. Submit us request for remote access with your IP address

  • When scheduling your beamtime, submit to Sheila Trznadel (strznadel@anl.gov) your request to run remote.
  • Note that remote access can be allowed from a requested pool of IP addresses only and only for the time of experiment.
  • Also, if you are behind a proxy or firewall, your IP address presented to us may differ from what you see locally.
  • Run Check IP Address tool to check your IP and email the requested pool of IP addresses to your host.
  • Provide host with a phone number where you can be reached during remote experiment.

4. Fill and submit automounter templates

 

On the day of your remote experiment

5. Have NxPlayer or TeamViewer installed

  • We offer five methods for connecting remotely to the GMCA computers (click here to open the flowchart): one using NOMACHINE™ Webplayer running in web browsers, three using different ways of installing NOMACHINE™ NxPlayer and one using TeamViewer™. With all methods the supported operating systems are Linux, MacOS, and Windows.
  • If you are going to use NX WebPlayer (Method-1), verify that your Browser compatible, then check the WebPlayer video guide and proceed to Step-6.
  • If you already have NxPlayer installed, then clear NX cache and proceed to Step-6.
  • If you do NOT like WebPlayer and do NOT have NxPlayer, but have Java installed, try Method-2: add https://www.gmca.aps.anl.gov to the Exception Site list on Java Control Panel (see details here). Then proceed to Step-6. A 32-bit version of NxPlayer will be automatically installed at Step-7 with no admin rights required.
  • If Java is NOT installed, try Method-3: download and unpack portable version of NxPlayer from GMCA website. Then start nxplayer from the bin subdirectory of unpacked distribution.
  • If Methods 1 to 3 do not work for you, try Method-4: download Enterprise NxPlayer from NOMACHINE web site and install it on your computer (admin rights required).
  • Finally, if you prefer to use TeamViewer™ instead of NX (Method-5; admin rights required), follow the TeamViewer™ instructions page.

6. Check your credentials on the day of experiment

  • You will receive remote login credentials (username and password) from your host over the phone at ~10am CST on the day of experiment.
  • Beware that the Lab firewall treats multiple login failures as a hacking attack and blocks respective remote IP after 3 failures.
  • Therefore it is very important that you run Check Credentials tool before trying to login remotely.
  • Contact your host to find out what might be wrong if the tool reports incorrect login credentials. See more details in FAQ.

7. Run your remote experiment

  • Proceed to Webplayer, enter your login credentials and then choose proper beamline workstation to connect.
  • For automatic NxPlayer installation via Java (Method 1) proceed to Table-1.
  • For manually installed NxPlayer (Methods 2 and 3) proceed to Table-2.
  • Connect with NX to blXws2 for data collection
  • Connect with NX to blXws6 for data analysis
  • Connect with NX to blXws5 for data backups
  • For TeamViewer™, read TeamViewer™ FAQ and ask beamline host to start TeamViewer server for you.
  • Remotely start Rayonix-300 software (BM beamline only) or remotely start Pilatus3-6M or Eiger-16m servers (ID beamlines).
  • Phone the beamlines if needed: +1(630)252-1823 for 23-IDD and +1(630)252-1723 for 23-IDB. The office phones of GMCA hosts are listed on the staff page.
  • You can also use Skype to communicate with the beamline or an on-site part of your team.
  • In addition, Google Talk is available on blXws3 for on-site visitors who have a Google account.
  • Pidgin instant messaging client supporting most chat networks is available on all computers.

8. Transfer data back to your institution

9. Logout once finished

  • Check FAQ on how long you can use the remote workstations.
  • Workstations blXws2 (data acquisition) and blXws6 (data processing) are available for the time of experiment only.
  • Workstation blXws5 (data backup) is available for an extra day. It can be also used for data processing in case you have such need.
  • Please be a good neighbor and logout from all workstations once your work is over.
 

 


NX WEBPLAYER

Watch Webplayer video guide

Webplayer inaccessible.
Please check your credentials

 

TABLE 1

REMOTE ACCESS TO GM/CA @ APS WITH AUTOMATIC NxPlayer INSTALLATION

(requires Java RunTime to auto-install NxPlayer) 1)

NOTE: Checking NxPlayer box for saving passwords may lead to firewall blocking !
Beamline Acquisition
(blXws2)
Processing
(blXws6)
Backup
(blXws5)
Beamline-1
23ID-D (23ID-in):
Inaccessible.
Please check your credentials.
Inaccessible.
Please check your credentials.
Inaccessible.
Please check your credentials.
Beamline-2
23ID-B (23ID-out):
Inaccessible.
Please check your credentials.
Inaccessible.
Please check your credentials.
Inaccessible.
Please check your credentials.
Beamline-3
23BM:
Inaccessible.
Please check your credentials.
Inaccessible.
Please check your credentials.
Inaccessible.
Please check your credentials.

 

TABLE 2

PRECONFIGURED NX™ SESSIONS FOR REMOTE ACCESS TO GM/CA @ APS

(right-click to download and use with already installed NxPlayer)

ATTENTION: NOT compatible with NxClient-3 or OpenNX!
NOTE: Checking NxPlayer box for saving passwords may lead to firewall blocking !
Beamline Acquisition
(blXws2)
Processing
(blXws6)
Backup
(blXws5)
Beamline-1
23ID-D (23ID-in):
Inaccessible.
Please check your credentials.
Inaccessible.
Please check your credentials.
Inaccessible.
Please check your credentials.
Beamline-2
23ID-B (23ID-out):
Inaccessible.
Please check your credentials.
Inaccessible.
Please check your credentials.
Inaccessible.
Please check your credentials.
Beamline-3
23BM:
Inaccessible.
Please check your credentials.
Inaccessible.
Please check your credentials.
Inaccessible.
Please check your credentials.

 

1) Note-1: Clicking these links initiates installation of free NxPlayer on your computer. The administrative access is not required, but the installation needs Java Runtime Environment (JRE). Also, you need to add https://www.gmca.aps.anl.gov to the Exception Site list on Java Control Panel. When prompted to open or save JNLP file, choose to open with javaws (Java Web Start Launcher). On Windows and MacOSX it will likely be the default. On Linux, javaws can be found in /usr/bin or /usr/java/latest/bin and Java Control Panel can be started as /usr/bin/jcontrol or /usr/java/latest/bin/jcontrol .
If you do not have Java installed, download portable NOMACHINE player from GMCA, then unpack, find nxplayer in the unpacked tree and execute it. Or download and install Enterprise NOMACHINE player provided you have installation rights to your computer. With the NxPlayer installed, use preconfigured NX™ sessions listed in Table-2 to connect to the GM/CA @ APS beamlines. Right-click on the session link in Table-2 to download the session file. Then, start NxPlayer on your computer, skip to "Recent connections" screen and open the saved NX session file. On some systems, e.g. Microsoft Windows, this command can be launched by double-clicking on the session file.

2) Note-2: Our beamline computers operate under CentOS-7, a free clone of Redhat Enterprise Linux-7. We use Mate graphical destop as a faster alternative to Gnome3, the default desktop of this operating system. For the sake of simplicity, other Linux desktops, such as Gnome3, KDE, Unity, Xfce, Cinnamon, and etc., are not supported.

3) Note-3: Shadow sessions establish additional connections to already running remote sessions. They provide collective viewing/controlling of the same desktop. These sessions are mostly meant for the GM/CA @ APS staff when there is a need to help users remotely. Shadow sessions are not recommended for users with slow network connections since streaming multiple remote desktops may result in a degraded performance. Be aware that with NxPlayer, after opening the shadow session and connecting to remote computer, you need to do Ctrl+Alt+DoubleClick (Cmd+Alt+DoubleClick on MacOSX) on the running session icon in order to shadow it. See this FAQ for additional details.

 

TABLE 4

Flowchart of remote connection options

(click to enlarge)

GM/CA @ APS is an Office of Science User Facility operated for the U.S. Department of Energy Office of Science by Argonne National Laboratory

UChicago Argonne LLC | Privacy & Security Notice | Contact Us | A-Z Index | Search