Windows install

From Jmri

Revision as of 04:28, 9 March 2012 (edit) 192.162.19.21 (Talk) (k44TOj I really enjoy the blog article.Really thank you! Really Great.) ← Previous diff		Revision as of 14:25, 17 January 2014 (edit) (undo) 37.233.27.142 (Talk) (tathyQ Major thanks for the article.Really looking forward to read more. Great.) Next diff →
Line 63:		Line 63:
	k44TOj I really enjoy the blog article.Really thank you! Really Great.		k44TOj I really enjoy the blog article.Really thank you! Really Great.
-	== Debugging ==	+	tathyQ Major thanks for the article.Really looking forward to read more. Great.
-		+
-	Sometimes things go wrong. The information in this section can help.	+
-		+
-	'''The Log Screen'''	+
-		+
-	JMRI logs information about errors to a "messages.log" file in the JMRI distribution directory, and to a console window. This window is generally white text on a black background, and is labeled either "Java" or "DOS". If something is going wrong, look there for more information.	+
-		+
-	If asked for a copy of the error messages, you can usually get them from the messages.log file. If not, to make a copy of the log window:	+
-		+
-	1. In the command prompt window, left-click on the JMRI icon to the left of the words "DecoderPro" (or "PanelPro"). You will get a drop-down menu.	+
-		+
-	2. In that menu, put your cursor over "Edit" to get a sub-menu.	+
-		+
-	3. Left-click on "Select All" in that sub-menu. All the text in the window will reverse colors with the background, and the menus will disappear. Alternately, you can left click on "Mark" in that sub-menu. The menus will disappear. Then, left-click and hold while dragging the cursor over the text to be copied. Only the selected text will reverse colors with the background.	+
-		+
-	4. Repeat Steps 1 and 2 above, then left click "Copy" on the sub-menu. The text and window will revert to their original colors. The text is now on XP's clipboard.	+
-		+
-	5. In your e-mail client, the Yahoo! "Post Message" pane, Notepad, Wordpad, favorite word processor, etc, position your cursor and left-click on Edit and then Paste, or press the "Ctrl" and "V" keys.	+
-		+
-	'''Keeping The Log Window Open'''	+
-		+
-	Usually the log window closes when the program ends, and that's what you want. Sometimes, you want it to stay around so you can see error messages that happen during shutdown, or even caused the shutdown.	+
-		+
-	To get the window to stay open:	+
-		+
-	1. Right click and select "show properties" on the program icon	+
-		+
-	2. Deselect "Close window on program end"	+

---

Revision as of 14:25, 17 January 2014

JMRI Install Guide: Windows

This information is being moved from it's original location at [1]. This might take some time.

1. Determine if your hardware supports Java and JMRI

We have had a report that a 100MHz Pentium is too slow to use, and another that a 120MHz Pentium II is fine, so somewhere around there is the minimum machine configuration, but it's important to have enough memory. We recommend you have at least 96MB of memory for Windows 98, and 128MB of memory for Windows 2000 or later. Having 128MB or 256MB respectively would give better performance. For the more complicated programmer screens, a display with a resolution of 800x600 or larger is strongly recommended. 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.

2. Get and Install Java (if needed)

Start by making sure you have an appropriate version of Java on your system by typing

java -version

You need to have Java 1.4 or later installed on your machine. We test with JRE 1.5 and recommend you use it or a later version.

If you don't yet have Java installed, you can also get installers from Sun by going to this link: [2]

You must run the Java installer (or have previously done so) before running the JMRI installer in the next step, or it will issue an error message and stop.

Sun offers both an "online" and an "offline" installer for the Java Runtime Engine (JRE). The online installer is about 1.5MB, but needs an Internet connection to complete the install. The offine installer is about 20MB, but includes everything.

As the size of software you can download from the Internet has increased, distributors have looked for ways to decrease the time it takes to do this. Since a software package may include features a user doesn't need or want, one way to decrease the time is to make the installation "live". You initially download a small program, which is an Internet installer. When you run the program you are asked what components of the package you want to install. Only those components are downloaded and installed.

Here's what Sun has to say about this:

---

Windows Installation

Saves download time if installing only some of the features. This install first downloads and runs a small program that prompts the user for options to download and install. The user must be connected to the Internet in order to complete this installation. Includes support for additional languages, fonts and media. This choice downloads and installs Microsoft Windows Installer 2.0 if not already installed. If you are behind an authenticated proxy server, you must use the Windows Offline Installer instead. Before making this choice, turn off any download managers, other than the Sun Download Manager, if you are using it.

Windows Offline Installation

This downloaded file includes everything required to perform a complete installation. It can be copied to a machine that is disconnected from the network and executed to perform a complete or custom install. Includes Microsoft Windows Installer 2.0 and support for additional languages, fonts and media. Use this installer if the normal Windows Installer does not work.

---

If the "java" command doesn't work after you've installed Java, there might be a problem with the Windows "path" variable. This is particularly common on 64-bit Windows systems. For more information, go to [3].

3. Get JMRI

Download a version of JMRI at [4], either the latest production version, or a "test version". Since the version numbers change with every release, this link takes you to the general JMRI download page, where you can select whichever version you like.

The JMRI project is continuously adding features, bug fixes, examples and tutorials to the release, and so a new "test" versions appear every couple of weeks. You may find one of these has features that you really want. These are announced in the "jmriusers" Yahoo discussion group at [5].

4. Run the JMRI installer

It will ask you to read some licensing information, and then install the needed libraries, plus add a "JMRI" program group to your Start menu and put a shortcut to the DecoderPro program on your desktop.

5. Installation is complete.

You can start the programs from the JMRI group under Programs in your Start menu.

6. Configure the program to connect to your layout

The JMRI hardware page lists the various types of layout equipment that JMRI can connect to, and gives links to instruction pages. Go there next to complete your setup.

---

k44TOj I really enjoy the blog article.Really thank you! Really Great.

tathyQ Major thanks for the article.Really looking forward to read more. Great.