Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The MetaEd IDE installation steps are fairly straightforward. It's worth noting that the MetaEd IDE is a plug-in to the free, open source Atom text editor. The installation steps below walk you through a complete install assuming you haven't yet installed Atom.

The installation steps can be summarized as:

Table of Contents
maxLevel2
minLevel2
includeStep \d+.*

Detail on each step follows.

Info
titleTroubleshooting

If you run into issues during install, please consult the troubleshooting information located at: MetaEd IDE - Common Problems and Troubleshooting#InstallationandUpdateIssuesInstallation and Update Issues If you still have issues, please raise a Tracker ticket (project: EDFI) and provide details of the issue.

Step 1. Create a Project Folder

Create a project folder containing a folder called "MetaEd-IDE". The path to this folder should be short (e.g. "C:\Project\MetaEd-IDE") and should not contain spaces.

Step 2. Download and Unzip the MetaEd IDE Installation Files 

Info
titleNote

An Ed-Fi community login is required to access MetaEd IDE downloads. If you don't have a login, you can sign up here.

Download the MetaEd IDE Installation ZIP file from the Downloads section of this documentation. This will require agreeing to an end-user license for the software.

Save the files to the your new MetaEd-IDE folder. These are configuration files that enable the installation and updating of the MetaEd IDE via the Yarn Package Manager. You'll install Yarn in a later step.

Step 3. Download and Install the Atom Text Editor

Download and install the latest version of the Atom text editor from the website https://atom.io

Step 4. Download and Install Node.js version

12

16.x

Download and install the latest revision of Node.js version 12 16 from the Node.js website here: Node version 1216.x installers are published here: https://nodejs.org/dist/latest-v12v16.x/

Image Removed

Image Added
Step 5.

Download and Install Yarn 1.16 or greater

Download and install the latest version of the Yarn package manager from the website https://yarnpkg.com/en/. Version 1.16 or greater is required.

Image Removed

Activate the Yarn Package Manager

First, you will need to open a command prompt with Administrator privileges. Press the Windows key on your keyboard to open the Windows Start menu and type in "cmd". This will autocomplete to "Command Prompt". On the right side, select "Run as administrator". 

Image Added

A command prompt will open with the title "Administrator: Command Prompt". Run the command "corepack enable" for here. If you receive an error running "corepack enable", you are not in an Administrator command prompt.

Code Block
themeMidnight
c:\>corepack enable

This is the only time you should run commands as an Administrator. Close the Administrator command prompt.

Step 6. Install the MetaEd IDE


Note

We recommend that at this point you close and reopen any open shell windows (e.g., Windows command prompts, Powershell, etc.) to ensure that Atom Package Manager ('apm', installed in Step 3 above) is correctly configured for this step. 

Open a command prompt, and from your MetaEd-IDE directory type the command yarn install and press Enter
Image Removedthe command run the command "yarn set version stable". This ensures you have the latest version of Yarn, the package manager that installs the MetaEd IDE.

Code Block
themeMidnight
c:\Project\MetaEd-IDE>yarn set version stable

If you receive an error at this step that contains "TLSSocket" in the error message, you have a firewall issue either in your enterprise network or on your local machine. See "I can't install MetaEd IDE and I receive a warning relating to fetching or downloading packages" in the Troubleshooting guide for help.

Next, run "yarn install". While the command is running, you may notice some warnings displayed in the command prompt, as shown in the example below. These do not indicate problems and may be safely ignored. A final message showing "success" in green indicates a successful installation.

Code Block
themeMidnight
c:\Project\MetaEd-IDE>yarn install

Image Added

Finally, run "cd node_modules\atom-metaed" and then run "apm link". This should result in a single line of output indicating that an Atom packages directory is pointing to the MetaEd-IDE installation node_modules\atom-metaed directory.Image Removed

Code Block
c:\Project\MetaEd-IDE>cd node_modules\atom-metaed
c:\Project\MetaEd-IDE\node_modules\atom-metaed>apm link


Note

Tips for installing the MetaEd IDE for Mac OS X users can be found here: Getting Started - For Mac OS X Users.

Step 7. Open the MetaEd IDE

– and Enjoy

Open the Atom text editor (or close and reopen if already running). You may be asked whether you'd like to install dependencies. If so, click Yes.

Image RemovedImage Added

A blue message will indicate that the installation is running a few remaining tasks. 

Image RemovedImage Added

Wait for the install to complete before dismissing notifications. The message will turn green and then fade away once the remaining tasks are complete.

Image RemovedImage Added

For optimal performance, you should configure the MetaEd IDE settings. See the Settings & Preferences section of the user guide for more information.

Include Page
_Getting Started - Sidebar
_Getting Started - Sidebar

...