If java 11 or greater is not found it will ask you whether you wish to continue the installation. Continuing permits you to resolve this issue later by either installing a valid version or linking JMRI to an absolute version as described in Using a specific java version section below.
Use the tables above to make sure the version of Java you are running is compatible with the version of JMRI you want to install. If you want to run a more current version of JMRI, consider installing Java 11 (see suggestions by clicking here). IF YOU HAVE JAVA 8 CURRENTLY INSTALLED, MAKE SURE TO UNINSTALL IT FIRST. [Multiple problems have been reported if both Java 11 and Java 8 are installed at the same time.]
JMRI also supports an offline installation - to set up, refer to the Offline Installation section below.
The JMRI project is continuously adding features, bug fixes, examples and tutorials to the release, and sonew "Test" versions appear every couple of weeks. You may find one of these has features that you really want.These are announced in the JMRI users Groups.io group.
The Windows JMRI installer for version 2.5.2 or later supports an offline installation of Java and JMRI. Typically, this would be used when the computer on which you wish to run JMRI does not have internet access.
If for any reason you wish to start totally clean and discard all previously stored Connections, Roster entriesand Panels, run "Uninstall JMRI", found in the Windows Start Menu > All Programs > JMRI > Tools and Demosbeforereinstalling a new version of JMRI.
(This shows the Start menu following a 'Typical' install - a 'Full' install will place additional icons in this menu)
With Windows XP, your Serial Port parameters might not be properly set for hardware flow control. To fix this, right-click on My Computer and select Properties. Go to the Hardware tab and click on Device Manager. Open up the section that says Ports (COM & LPT). Right-click on the Serial Port you have the LocoBuffer hooked up to and select Properties. Go to the Port Settings tab and set the options to:
19200, 8, None, 1, Hardware.
Click OK.
Depending on what it wants to display, JMRI can open up very large windows. Generally, JMRI uses the size of the screen and information about fixed things like the start bar to decide the maximum size for an opening window so that e.g. the corners can't be reached to resize the window.
Depending your Windows display operation, large JMRI windows will either resize to stay on the large part of the screen, clear of start bars and menu bars, or will be displayed at the full size of the screen, appearing under the start bar and menu bars.
If you're using a "skinning" utility which changes the appearance of programs running on your computer, you should tell it to ignore the "java.exe" program. That's how JMRI and DecoderPro will appear to it, and they weren't written with such "skins" in mind.
A backup copy of all your user files (Panel files, Roster entries, Preferences etc.)is saved when a new revision of JMRI is installed.This is done by the installer when it asks to save a backup copy which, ifselected, is saved in a folder named "JMRI_backup".
If problems occur with the new version and it is necessary to revert to thelast version in use, you should install the older version right over the versioncurrently installed. Then find the folder that holds the folder named "JMRI_backup".This will normally be located in your user-profile folder - a quick way tofind this is to follow the "Preferences" link in "JMRI > Tools and Demos" from the Start menu.
Once opened, navigate up one level to your user-profile folder.Depending on the version of Windows, this will typically be one of:
It's important to have enough memory and free hard disk space. We recommend you have at least 256 MB of memory for Windows 98, 512 MB of memory for Windows 2000 and 2 GB for the newer W7-W10 systems. Note that used PC hardware is available for very little money; it might be cheaper to buy a used computer than to update your existing one.
Note: Current versions of JMRI are developed with Java 1.8 (moving to Java 11). You may get a message if you are using later versions of Java:
"WARNING: An illegal reflective access operation has occurred"
or "WARNING: Please consider reporting this to the maintainers".
You can ignore the messages.
With JMRI a Windows utility called InstallTest.exe is installed. To execute a series of tests on your Windows JMRI installation, start InstallTest from the Start menu -> Programs -> JMRI -> Tools and Demos -> InstallTest. The following screen will open:
JMRI logs information about errors to a "messages.log" file in the "systemfiles" sub-directory of the JMRI preferences directory, and to a console window. This window is generally white text on a black background, and is labelled either "Java" or "DOS". If something is going wrong, look there for more information.
If a JMRI support volunteer ask you for a copy of the error messages, you can usually get them from the messages.log file. If you can't find it there, make a copy of the JMRI System Console log window:
b1e95dc632