Joyce Zhang · Nov 6, 2017

Announcement: Atelier Is Only Available as an Eclipse Plugin

To simplify the upgrade processes and to keep up with industry standards, we decided to make Atelier only available as an Eclipse plugin. Those of you who are currently using a standalone Atelier client will not be able to upgrade to a later version.

Please go to the Atelier Download page or see the sections below for the detailed instructions about installing Eclipse and the Atelier plugin. Feel free to reach out to support or leave a comment down below if you have any questions.

Edit: Related article - How to convert from your standalone Atelier?


Installation Instructions

System requirements

1. InterSystems' products 2016.2+

2. Java 1.8+

a. To check if you already have Java installed, and if so what version enter this in an OS Terminal: java –version

b. To install Java for the first time, a newer version of Java, or a different bitness of Java (Java bitness should match the Eclipse bitness) check the Oracle website:

3. Eclipse OXYGEN (please see details below)


Installing Eclipse

1. Download the installer from the Eclipse website:

2. Start the Eclipse Installer and select the package you want to install. We suggest you get Eclipse IDE for JavaScript and Web Developers which includes essential tools for JavaScript, HTML, CSS and XML languages support. You can always add or remove plugins later.


Installing the Atelier plugin

1. Launch the Eclipse IDE

2. Accept the default workspace location, or enter a new directory (this is where your Atelier projects/local copies of server files will be stored)

3. Add one of the Atelier repositories to your Eclipse environment

a. Select Help > Install New Software

b. Click Add... and enter the following info:

i. Name: Something meaningful to you, probably Atelier Stable or Atelier Beta

ii. Location: URL for the repository - pick stable for the fully QD-tested version, or beta for the latest-and-greatest which goes through standard testing by developers but is not thoroughly QD-tested

1. Stable:

2. Beta:

c. Click OK, select the box next to Core (containing the Atelier IDE), and click through to install

4. You will be prompted to restart Eclipse once the install is done

5. To open the Atelier perspective which contains the Atelier-specific views: select Window > Perspective > Open Perspective > Other, highlight Atelier and click Open


Keeping Atelier up-to-date

You can update your Eclipse plugins manually or by setting up automatic updates

1. Manually, option 1: Select Help > Check for Updates

2. Manually, option 2: (Windows) Select Help > About Eclipse or (Mac) Eclipse > About Eclipse, click Installation Details, then Update

3. Automatic updates: (Windows) Select Window > Preferences or (Mac) Eclipse > Preferences, drop down Install/Update, select Automatic Updates and pick your preferences




0 1,549
Discussion (9)8
Log in or sign up to continue

Hi. Is there any endpoint for updating to the latest stable version instead of 1.0 (I mean when new stable version will arrive)? Changing the site path every time isn't so convenient.

Even Eclipse itself offers the same way to upgrade platform. If you want to upgrade Eclipse to the newest version, you should change the link, and after that upgrade will be possible.

Can I still change the Eclipse app icon and splash screen back to Atelier? Is there a preferred way to do this? Through the eclipse.ini?

Hi Brian,

I did a quick Google search and found this post on how to change the Eclipse dock icon. You might also find something helpful from Stackoverflow as this is a general Eclipse question. 


I just tried to download Eclipse and got an installation error, unable to read repository.

Here is the log.

2017-11-16 13:11:12] ERROR: org.eclipse.equinox.p2.metadata.repository code=1002 Unable to read repository at
ERROR: org.eclipse.equinox.p2.repository code=0 An error occurred while downloading http://download.eclipse

This error can occur for a number of reasons. It could have to do with a firewall, a proxy server, etc. on your system. This is an Eclipse error, outside of InterSystems technologies - your best bet will probably be to Google the error.

Not sure if your issue is the same I ran into when I got this error, but to solve I did the following:

1. In the Eclipse installer, click the 'Network' button (it's next to the ? Help button in the lower tool bar.)

2. Make sure your Active Provider setting is set to Direct. By default, the installer was set to Manual I think and after I changed to Direct, I was able to read the repository.

Have you installed Eclipse before? What OS? You might want to take a look at this post to see if it's helpful.

Thank you everybody for your suggestions.

I did Google this error and the consensus seemed to be it was a firewall issue.

I disabled my firewall and the installation was successful, although it seemed very slow.