How to setup Protege to access your local FMA

  1. Download and install the latest Protege Release.

    • Protégé installers can be found at http://protege.stanford.edu/download/download.html. You will want to select the latest stable release of Protege version 3.4. As a consequence of making the FMA's database backend compatible with Protege 3.4, it is no longer compatible with older Protege versions (version 3.3 and older).

    • A 'Warning - Security' dialog may pop-up. You will need to select the 'Yes' button.

    • If in doubt, select the basic installation. We have had some issues in the past with the full installation. Choose the version that is appropriate for your operating system and choose whether or not you would like to download the Java Virtual Machine (JVM) at the same time. If you do not know whether or not you need the JVM, select the 'includes Java VM' option. If you already have the JVM installed on your system, select the 'without Java VM' option and the installer will prompt you later for the location of your existing JVM.

    • After you select one of the download options, a file download dialog should appear (this will vary depending on your internet browser). You can either choose to save the installer to a temporary directory and launch it from there, or you can choose the 'open' option from the dialog box.

    • Accept all of the defaults as presented by the installer (by pressing next). If you have opted to install without the JVM, one of the installer windows will show you a list of the JVM installation currently found on your machine. Select the one that you would like Protégé to use. (Note: if there are no JVMs in the list, you probably do not have one installed. In this case, exit the installer and start over using the 'includes Java VM' option.) The last window will require you to click install.

    • Click 'Done' when the installer has completed.

  2. Download and set-up the UW FMA specific Protégé extensions.

    • Download the following zip archive: UW_Protege_extentions.zip

    • Unzip this archive to a temporary directory.

    • Open the newly created folder UW_Protege_extensions. Copy the file driver.jar to the main Protege installation directory, (ie. C:\Program Files\Protege-(Version # Release)).

    • Now open the subfolder 'plugins' in the UW_Protege_extensions directory. Copy the "edu.washington.sig.standard_extensions" directory contained here into the Protege plugins directory (ie. C:\Program Files\Protege-(Version # Release)\plugins).


  3. Download and run the Protégé project file.

    • Download the following Protégé project (.pprj) file: FMA.pprj.

    • You may need to modify this pprj file with the specifics for your copy of the database. If you chose the example values for your local FMA database from the "Setting up a local copy of the FMA" instruction page, then the values in the pprj are already set. The following entries in the pprj set the database url, table name, user name, and password respectively:

      ([ProjectKB_6090_00002] of String
      (name "url")
      (string_value "jdbc:mysql://localhost/fma_local"))

      ([ProjectKB_6090_00003] of String
      (name "table")
      (string_value "fma"))

      ([ProjectKB_6090_00004] of String
      (name "username")
      (string_value "fma_user"))

      ([ProjectKB_6090_00005] of String
      (name "password")
      (string_value "8_19_03"))

    • Save your changes if you made any.

    • Double click on this downloaded file to run Protege and view the FMA.

Please send any questions or corrections to det at u dot washington dot edu