https://github.com/fburato/redlsmsim

REDLSM simulator from the p3 course
https://github.com/fburato/redlsmsim

Last synced: about 1 month ago
JSON representation

REDLSM simulator from the p3 course

• Host: GitHub
• URL: https://github.com/fburato/redlsmsim
• Owner: fburato
• Created: 2015-02-22T10:27:21.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2015-02-26T16:36:14.000Z (almost 10 years ago)
• Last Synced: 2023-08-01T01:42:03.227Z (over 1 year ago)
• Language: Java
• Size: 531 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.txt

Awesome Lists containing this project

README

        
---------------------------

Description of the archive.

---------------------------

The archive is constituted of the following content:

- REDAME.txt: the current file.

- doc/report.pdf: pdf containing the project report.

- project/src/: directory containing the source code of the project.

- project/Project.jar: runnable jar containing a precompiled version of the

  application.

- project/build.xml: xml file use for compiling the project via ant.

For the content of directory project/src we suggest to read the project report

to know the content of the different packages.

-------------------------

Compilation instructions.

-------------------------

The compilation process has been automatized via the project/build.xml file.

Prerequisite to compile easily the project is to have the application 

'apache ant' installed in the system.

To compile the project it is necessary to navigate to project/ directory in a

terminal emulator and just type the command

ant

which will automatically produce the project/bin/ directory in which there will

be all class file needed for executing the different applications.

---------------------

Running instructions.

---------------------

In order to run the applications contained in the project it is necessary to 

know that there are two different java class with a main method. These are:

- server.Server: which is the rmi server.

- gui.MainWindow: which is the main window of the simulator client.

To run both of them it is necessary to do the following:

1. Add directory project/bin/ to the CLASSPATH environment variable (consult

system documentation to determine how to do that).

2. Start rmiregistry application in order to allow the server to be run.

3. Start rmi server with the command

	java server.Server 

Where  represents the path to the file which will be used to put

statstical data collected by clients in.

4. Start the client window with the command

	java gui.MainWindow

If the directory '.' is already in CLASSPATH variable is also possible to run

the application via navigating through directory project/bin and 

executing every step from 2 to 4 in that directory.

Since it is a distributed application note that steps 1,2,3 could be executed

in a different machine then the one in which steps 1,4 are executed. Obviously

in order to make system working it is necessary to start the rmi server before

a simulation is started.

If user wants just to execute the application using the jar file in project/

directory the following steps must be executed in a terminal emulator:

(0.) Navigate to project/ directory.

1. Run

	java -jar (project/)Project.jar

	

Obviously it is not necessary to execute step 0 if user wants to specify the

absolute path to the jar file.

Note also that since it is possible to bypass the rmi server in the client

simulator following the instructions present in project/report.pdf, the client

is completely stand-alone and it could be run using no server.