Starting a Net From an Installer

Once you have created a GenesisII installer as specified above or if you already have one...

Install Root Net

To run the installer in this phase you will need to be able to view the GUI installer pop-up. (Create .xml install description in the future to automate this.)
Make sure no java process is already running

ps auxww | grep java

Delete old files

GeniiNet>./clean.sh

Run installer

GeniiNet>java -jar UvaNetInstaller-0.x.0.jar

At this point the GUI installer will pop-up. Select to install

*Core
*Example JSDL Documents
*Documentation

Be sure to set the install path to

/gbg/GeniiNet/GeniiNetInstall

(You should be notified that this directory does already exist.)

Start Root Container and Bootstrap

We start the container by running the install container wrapper script. It takes the following two arguments: <deployment name> <container service name>

We bootstrap the grid with the appropriate UVa net settings by running the script tool with the following arguments to specify the GENII_INSTALL_DIR, DEPLOYMENT_NAME, and location of the bootstrap.xml script. (2 mins)

Leave the connection to the root node up while you add other nodes so that you can monitor success.

Adding Linux Containers

Connect to another Linux general (Titus, Sulla, or Camillus).
Make sure no java process is already running

>ps auxww | grep java

Delete old files

GeniiNet>./clean.sh

Run the installer. Note the install options differ from the install for the root container. (5 mins)

GeniiNet>java -jar UvaNetInstaller-0.x.0.jar install-desc.xml

A new smaller popup window will appear after about 30 seconds. You will be prompted to enter a password. It is imperative you type this correctly as there is no backspace. If you do mistype something, you will need to wipe the state for this container entirely (see the uninstall steps) and restart at the beginning. After this, you will be asked to enter the installer password a second time. Please do so as before.

Password for the installer.pfx:installer

As the script finishes, a good sign that the container setups correctly is if 'setting security' takes some time for each step.

To test if the new container has been properly hooked into the UVa Net, go back to the connection on the root and check if the newly added container appears.

Adding Windows Containers

To add a Windows Container to the UVa net, you need to get the installer for the net, run it, and make sure everything looks good. If the correct options are selected, the installer will do all the work!

First we check that no Genesis II service is up and running on this machine already. This is a good check if there is any chance that Genesis II has been run on this machine before. Go to

Start->All Programs->Administrative Tools->Services.

Make sure that no service starting with the name "Genesis II" appears.

Next we need to get the installer jar with all the security settings for the current UVa net. To do this you can get the installer from the Downloads] section of the website if it has been updated or bring up Cygwin and scp directly from the gbg home folder:

>cd Desktop
>scp gbg@cicero:~/GeniiNet/*.jar installer.jar

Run the installer (double-click!). Note the install options differ from the install above for the root container. The installation will take around 5 minutes.

Program Files/Genesis II(You should be notified that this directory does not yet exist.)

A new smaller popup window will appear. When prompted, enter:

Password for the installer.pfx:installer

Then you will be prompted again to enter the password for the machine you are on. This is referring to the windows password you used to log into that machine.
If you mistype either of these passwords, you will need to uninstall GenesisII and then start the installation from the beginning. You will be asked a second time for the installer password. Use the same value that you typed in the first time (not the windows user password). You can uninstall with the following command:

Testing the Net

Once the UVa net is setup, running some of the example jobs is a good way to test if things are working. One way to do this is to start up a net on your own machine and connect to the UVa net to run the jobs. For these instructions I'll be assuming you're creating a net on a Windows machine.

Get a copy of the installer used above to setup a local net.

scp gbg@cicero.cs.virignia.edu:~Geniinet/*.jar startup.jar

Install the net via the GUI. Make sure to select the example files for download. Do not select to start the NetFullContainer.

Go to where you installed the net and run the grid by selecting the grid.bat file.