$ Usage [ Version mpp-2.0 ]
4. Starting MPP
4.1. Shell scripts and Batch files
MPP comes with more than one way of starting up depending on which interface you wish to load,
and which operating system you are using. Linux and Unix users will need to start MPP with one
of the following shell scripts:
Each will have options that you can specify either from a console or as options when setting up
a link on your main panel or start menu. Depending on your window manager (Gnome, KDE, Fluxbox etc)
there will be different ways of adding icons to your desktop, panel or start menu.
Windows users will be able to start MPP by using the mpp_gui.bat.
Again, each will have options that can be specified.
To start MPP from the command line on either operating system, you need to open up a shell (a sh variant under
Unix/Linux, or cmd.exe under Windows 2000 and above) and use a command like the following in the directory that
you unzipped / installed MPP, substituting <version> for the particular POI library and MPP versions you
wish to use, and also appending the following options to the end of the previous command:
-c : convert an xls file or directory of xls files into csv
-c <file> <delim> : convert all sheets in an xls file using specified parameters
-c <file> <delim> <sheet> : convert a single sheet in an xls file using specified parameters
-c <dir> <delim> : convert all sheets in a directory of xls files using specified parameters
-c <dir> <delim> <sheet> : convert single sheets in a directory of xls files using specified parameters
-cli <file> : analyse a csv or xls file using the default.properties file
-cli <dir> : analyse a directory of csv or xls files using the default.properties file
-cli <file> <properties> : analyse a csv or xls file using a specified properties file
-cli <dir> <properties> : analyse a directory of csv or xls files using a specified properties file
-gui : open the GUI using the default.properties file
-gui <properties> : open the GUI using the specified properties file
For example:
java -classpath lib\poi-<version>.jar;lib\JRclient-<version>.jar -jar mpp-<version>.jar -gui : start the MPP gui
java -classpath lib\poi-<version>.jar;lib\JRclient-<version>.jar -jar mpp-<version>.jar -cli test.xls : analyse the test.xls file via the MPP CLI, using the default.properties file
java -classpath lib\poi-<version>.jar;lib\JRclient-<version>.jar -jar mpp-<version>.jar -c test.xls t 2 : convert sheet 2 of the test.xls file, and separate using the tab delimiter
4.2. GUI or CLI?
Which interface should you use?
Using mppGUI provides extra functionality over mppCLI in that you can view analysis output and plots before
saving or exporting, in addition to the fact that some users will not be comfortable using a CLI to process
their data.
Using mppCLI provides extra functionality in that it can be installed on one server and many users can access
that server to process their data. Furthermore, a web-based frontend could be written to submit jobs to MPP
that could run from the same server. This is outside the scope of this project at the moment, but could
become a feature in future.
4.3. Problems starting MPP
It should be very straightforward to get MPP up and running.
One of the most common problems is incorrect R and dependent R package versions. Ensure you have the correct packages listed in Section 3 and that they are installed and fuctioning.
If starting MPP from Linux, Mac or Unix, a console window should stay open which will list any runtime errors, or a java alert dialogue box will pop up informing you of the error. In Windows, when MPP breaks, the console window may close. If this happens, run mpp_gui.bat from a command prompt (cmd.exe) which will ensure that the window stays open and any console error messages are logged. If you do experience problems, please copy the stack trace of the error from the console window and email it to me so I can help diagnose and solve the problem.
|
|