GUI Java WOL Project.

Version : 1.2

Date : 1 Sept 2009

Author: Ferret Renaud

URL : here

1 - Aim of this project

Use a Wake On Lan interface in order to wake up network devices such as computer or NAS.

2 - Launch

Before starting

This software need a Java virtual machine installed on your computer.

The minimal version needed is 5.

In order to download a Java VM you can go to here.

If you want to check the current version running on your system, simply open a console window and type:

If you get no answer then you have no Java, if the version is bellow 1.5 then you've an inappropriate version of Java for this software.

At last, starting

Simply double click on start.bat (for windows) or start.sh (for unix).

Under Unix

• you may need to set x bit on file: chmod u+x start.sh
• you'll need a X server running for gui (note that there is no need for X server if you use the command line launcher)

Using the console mode

This is possible since version 1.2 only.

It allows you to ping or WOL a device (or many devices) without starting the GUI.

Basic command line is: java -cp GuiWakeOnLan.jar wol.WakeOnLanConsol -F:xxx -D:{MAC/MASK/IP} -A:zzz -V

Where options are (caution upper/lower cases, order has no meaning):

• -F:fileName a file name where to find devices information.
  For example -F:c:/toto.properties.
  You cannot use this option with -D. Format of the filde is as follow:
  #IP;MASK;MAC ADDR;BRD ADDR;LABEL;PORT FOR WOL;;
  10.0.0.3;255.255.255.0;00:09:6B:05:8C:21;10.0.0.255;Sample Computer 1;7;;
  10.0.0.5;255.255.255.0;00:08:6B:05:8C:21;10.0.0.255;;9;;
  
• -D:{MAC/MASK/IP} a device represented by its MAC address, MASK and IP.
  For example: -D:{00:09:6B:05:8C:21/255.255.255.0/10.0.0.3}.
  You can have more than on -D but you cannot use it with -F.
• -A:ping or -A:wake represents the action to execute on devices.
• -V indicates if you want to see result on stdout/sterr.
  If not set all information will be managed ONLY by log.

Examples:

• This will call ping to all devices listed in c:/myFile.properties and show result on output: java -cp GuiWakeOnLan.jar wol.WakeOnLanConsole -F:c:/myFile.properties -A:ping -V
• This will call WOL to all devices listed in c:/myFile.properties and show result in log file: java -cp GuiWakeOnLan.jar wol.WakeOnLanConsole -F:c:/myFile.properties -A:wake
• This will call ping to the device and show result on output: java -cp GuiWakeOnLan.jar wol.WakeOnLanConsole -D:{00:09:6B:05:8C:21/255.255.255.0/10.0.0.5} -A:ping -V
• This will call WOL to the device and show result in log file: java -cp GuiWakeOnLan.jar wol.WakeOnLanConsole -D:{00:09:6B:05:8C:21/255.255.255.0/10.0.0.5} -A:wake
• This will call WOL to the two devices and show result in log file: java -cp GuiWakeOnLan.jar wol.WakeOnLanConsole -D:{00:09:6B:05:8C:21/255.255.255.0/10.0.0.5} -D:{25:49:6B:06:8E:24/255.255.255.0/10.0.0.8} -A:wake

3 - Saving / Loading

3.1 - Saving

Using the gui, every thing is saved automatically when you quit the software.

All your information will be saved in the networkdevice.ini file. It will contain all your network devices.

This file can be used by console mode (since 1.2).

You may also notice a log file that will grow if warning/error occurred.

3.2 - Loading

The software will automatically load the networkdevice.ini file at startup.

4 - Known bug or issues

4.1 - Use of ping is slow

Yes I know, I am using Java Ping system.

Note that since v1.1 the timeout used should be more efficient.

4.2 - Awake says all is fine but my network device did not start

Software cannot tell if your network device went on or not, it will only tell that packet is gone.

Most of the time if your network device does not start it is because:

• your MAC address is not correct (has a direct influence on WOL packet)
• your network mask is not correct (has an influence on broadcast IP that is used for sending WOL)

4.3 - Log file shows only error when using console mode

This is not a bug, if you want to see more information in log file you need to change the log configuration.

A basic change is to replace log4j.rootLogger=WARN, localFile that is at the beginning of the log4j.properties file by log4j.rootLogger=INFO, localFile.

For more complex change you can read the Log4j project site.

5 - Historic

• v1.0 : First release
• v1.0.1 : Changed compilation option for Java5 compatibility in project
• v1.1 : Added popup for ping function
• v1.2 :
  • Updated documentation
  • Added command line functions
  • Changed pingAll method protocol
  • Added ping and pingAll method with a time out