Metadata Editor

NMDEdit Installation Instructions

A prerequisite step and a total of three additional steps are needed to complete the installation of NMDEdit, which is based on CatMDEdit, an open source metadata editor.

Please Note: If you have previously installed the NMDEdit, please uninstall the existing version first before installing the new version by following Steps 1 through 3 below. NMDEdit could uninstalled by running the "uninstaller" file that is in the "Uninstaller" folder under the directory where you have installed the NMDEdit.

  1. Prerequisite
  2. Step 1: Download Basic CatMDEdit
  3. Step 2: Install Basic CatMDEdit
  4. Step 3: Modify Basic CatMDEdit to NMDEdit

For questions or more information, please contact: datahelp@ucar.edu


Overview of the Installation Steps:

 


Prerequisite:
Before starting the installation process, please check that you have a recent version of Java on your computer.

  1. In a command prompt or a terminal window, type the following:
    java -version

    Example from Windows Command Prompt:

  2. Descriptions similar to the following should be returned:
    java version "1.8.0_111"
    Java(TM) SE Runtime Environment (build 1.8.0_111-b14)
    Java HotSpot(TM) Client VM (build 25.111-b14, mixed mode, sharing)


    Example from Windows Command Prompt:

  3. If you do not have Java, please install it by going to Java SE Development Kit (JDK) Downloads page, or see a sysadmin about installing it on your computer.

Step 1: Download Basic CatMDEdit
Choose one of the following installers for CatMDEdit based on your operating system.

Note: We recommend that the installer file to be downloaded to your desktop, so that it can be easily accessed for the next steps.

Windows Linux or Mac

installer_catmdedit-5.0.exe
(Please select the green "Download" button in the resulting page.)


installer_catmdedit-5.0.jar
(Please select the green "Download" button in the resulting page.)



Step 2: Install Basic CatMDEdit

Important Note: When prompted to choose and/or name a directory for CatMDEdit's installation during the following steps (this direcotry could be anywhere that is convenient to you), make sure to note (e.g. write it down or copy it) the full path to this directory. This information will be needed in Step 3. 

An installation path example is shown as follows.

Windows Linux or Mac
  1. Go to the directory (e.g. desktop) where the installer is downloaded.
  2. Run the installer by double clicking on the "installer_catmdedit-5.0.exe" file.

    Example:
  3. Follow the on-screen prompts to complete the installation.
    • Important Note: When prompted to choose and/or name a directory for CatMDEdit's installation during the following steps (this direcotry could be anywhere that is convenient to you), make sure to note (e.g. write it down or copy it) the full path to this directory.  
  1. Open a terminal window and change the directory to where you have saved the installer file.
  2. Run the installer by typing the following in the terminal window:
    java –jar installer_catmdedit-5.0.jar

    Example:
  3. Follow the on-screen prompts to complete the installation.
    • Important Note: When prompted to choose and/or name a directory for CatMDEdit's installation during the following steps (this direcotry could be anywhere that is convenient to you), make sure to note (e.g. write it down or copy it) the full path to this directory.

Step 3: Modify Basic CatMDEdit to NMDEdit

  1. In a separate browser window or tab, go the NCAR NMDEdit's GitHub repository - https://github.com/NCAR/NMDEdit - sign in is not required.

  2. Click on the green "Clone or download" button that is at the top right hand corner of the page.

  3. Select the "Download ZIP" option.

  4. Locate the zip file (the file name should be "NMDEdit-master.zip" or one that is similar to it) and unzip it if it is not unzipped automatically (you may move the file to a location, such as the desktop, that is easy for you to work from before unzipping it).
    Note: The unzipped files will be in a sub-directory named “NMDEdit-master”.

  5. Windows Linux or Mac
    1. Go to the directory to where you have unzipped files.

    2. Run the "apply_ncar_updates" batch file by double clicking on the "apply_ncar_updates.bat" file (a command prompt will start automatically). 

      Example:

    3. When prompted for the directory where the CatMDEdit program was saved, enter the full path as noted earlier from Step 2.

    4. Review the outputs displayed in the command prompt. If there are no errors, you are now ready to start using NMDEdit.

    5. NMDEdit could be started by double clicking on the "NMDEdit.bat" file under the directory where you have installed the NMDEdit.

    6. Example:
    1. Open a terminal window and change the directory to where you have unzipped files.

    2. Make sure the shell script, which is part of the unzipped files, is executable by typing in the following:
      chmod 744 apply_ncar_updates.sh

    3. Type the following command and hit "enter" to run the "apply_ncar_updates" shell file:
      ./apply_ncar_updates.sh

    4. When prompted for the directory where the CatMDEdit program was saved, enter the full path as noted earlier from Step 2.

    5. If there are no errors, you are now ready to start using NMDEdit.

      Example (Steps 2 through 4 are highlighted in red):

Note:

  • If for some reason the batch file or the shell script echoes back a directory that is not the correct one, type CTRL-C to kill the script and start over after checking your notes on the full path to the CatMDEdit program.

  • Once the installation is successfully completed, it is recommended that the NMDEdit-master.zip file and the NMDEdit-master directory (along with all the files within it) to be deleted.

  • Review the output from the script, and if there are any errors take a screenshot, or make a note, and contact datahelp@ucar.edu