top of page

Run Eclipse (and ESAPI Scripts) Using a Remote ARIA System

If you have Eclipse installed on your computer, it'll likely point to a default ARIA system (database and file system) on your computer. In many cases, however, you'd like to test your script on a remote non-clinical ARIA system. Please note that it is against Varian's terms and conditions to point to a clinical system from your computer.

Eclipse obtains the location of the ARIA system (the "host") from a configuration file, located at C:\VMSOS\Config2\site.xml (at least in v. 13.6). In that file, the HostName tag specifies the location of the host. To use a different host, simply change the host name (the other tags should be the same). Make sure to create a back-up site.xml in case you want to switch back.

If you're not sure what the host name of your ARIA system is, you can look it up in Eclipse. Run Eclipse (through Citrix) from the system you would like to point to. Click on the question mark button (upper right) and select "About External Beam Planning." Click on "More Info ..." and a dialog box will appear. Find "VA Server Name" and "Database Server"; their values should be the same, which is the host name.

If you run Eclipse at this point (the one on your computer) and try to open a patient, you may get an error message about access permissions. Some data in ARIA is not stored directly in the database, like image files, but also in a file system. You'll need permission to access this file system. The easiest way to make sure you have access is to map a special directory to a drive on your computer (instructions below).

In the "Info" dialog box you opened before, find the "Directories and Paths" and "Image Directories" sections. These directories should have a common base (something like "\\rovision\va_data$"). This is the special directory you need to map to.

To map this directory to a drive, open "Windows Explorer" (Windows 7), right-click on "Computer" and select "Map network drive..." In the "Folder" text box, type in the directory location you found above. Check the "Reconnect at logon" option. You may also need to check the "Connect using different credentials" and enter the credentials you use to access Citrix (including the domain, like "ronet\username").

When you run Eclipse from your computer, you now should be able to open a patient on the remote ARIA system. ESAPI will also access this system and you'll therefore be able to test your scripts with patients on that system.

Related Posts

See All

ESAPI Essentials 1.1 and 2.0

A few months ago, I introduced ESAPI Essentials—a toolkit for working with ESAPI (available via NuGet). I've recently added one major feature: asynchronous access to ESAPI for binary plugin scripts. Y

Announcement: ESAPI Subreddit

A few months ago, Matt Schmidt started the ESAPI subreddit. It's another useful resource for finding and discussing ESAPI-related topics. According to the description, This community is to post and di

Dump All Patient Data from ESAPI

If, for whatever reason, you need to dump out all of the data for a patient from ESAPI, there's a quick and dirty way to do it. Well, there are probably several ways to do it, but here's one I've foun


bottom of page