From LittleFe

I have a LittleFe, now what do I do?

Taking Out of Case

• To take the LittleFe out of the case carefully follow the following directions. Unhook the bungee cords from the cluster, the bungee cord is not extremely stretchy, so it will take a little bit of strength to unhook them. After you've unhooked it, pick the cluster up (be careful: the side of the cluster with all the nodes is much heavier than the other side), and place it down on a flat surface.
• You can choose to set the LittleFe in whichever direction you prefer. You may choose horizontal, where the power buttons of the nodes are in a row, or you may choose vertical, where the power buttons are in a column. As for the pictures corresponding with this document, they were taken when the LittleFe was set up horizontally. With the LittleFe, there should have come Velcro strips. These strips are used to cut down on the pressure and force being put on the cords. Attach another Velcro strip next to the head node. Use this to hold the cords plugged into the node together and, drape it around the back of the cluster.

Here is all of the cords Velcroed together.

The Velcro strip next to the head node.

The cords are held together by the Velcro strip and laid on the top and around the back of the LittleFe.

Putting Back in Case

• Place the cluster inside the case, and make sure that the edges of the cluster are will be in the middle of the foam on the lid of the case when you close it. Next you will attach the bungee cords to holes on the cluster. When attaching the cords, it is easiest to pull both of them at once, for they are not very stretchy. After you have attached the bungee cords, if you have a wireless mouse and keyboard, place the items in the open space between the network router and nodes. Close the case.

Here I have attached the bungee cords to the holes on the cluster.

Here is the cluster in the case. Notice that, when closed, the edges of the cluster will be in the middle of the foam on the lid.

Getting Connected

• Before you can boot the LittleFe, there are essential pieces of equipment you must get connected. This section will tell you how and where to plug these accessories in: Monitor, Mouse, Keyboard, Booting devices, and Ethernet (depending if you want to boot from an external network). If you are booting from the head node then plug the accessories into the node with the black ethernet cord. If you are not booting from the head node, then plug the accessories into any of the other nodes.

Connecting a Monitor

• If you want to see anything you do on the LittleFe, then you need to connect a monitor. There will be a cord that gets connected to the back of the monitor of the screen, and the other end that will be plugged into the cluster. The blue port on the nodes is where you want to connect the cord, there will be a corresponding port on the monitor where you will connect the other end of the cord. To secure the monitor cord to the node, screw in the screw on the side of the cord.

Connecting a Mouse

• A mouse must be connected to the cluster in order to control anything on the screen. The cord to a mouse could come in different forms, but just plug the cord into the corresponding port on one of the nodes (the same one in which you plugged the other equipment in). I have used a mouse with a USB cord, so that is what is used in the pictures.

Connecting a Keyboard

• A keyboard must also be connected to the cluster. The cord of the keyboard could also come in different forms, but just plus the cord into the corresponding port on one of the nodes (again, the same one in which you plugged the other equipment in). I have used a keyboard with a USB cord, so this is what is used in the pictures.

Whole LittleFe cluster. If installing on head node, then plug into far right node. Otherwise, plug accessories into another node. Note: Head node has a black Ethernet cord, while the others have a red one.

The blue port is the port where the monitor cord gets plugged in.

I have plugged the monitor cord into the blue port on the node.

This is showing that the keyboard and mouse have been plugged into two USB ports. It does not matter what USB port you plug the two into, as long as it's the one that you have been using.

Equipment for Booting

• You need to make sure that whatever you are booting BCCD from is plugged into the cluster. Here, I have used a USB. In order to get connected to an outside network, you need to make sure you have an Ethernet cord plugged into the cluster. Since there is nowhere for an Ethernet cord to be plugged into a node, we have used a special USB that we can plug the cord into. Also, you need to make sure the power cord is plugged in. The power cord is plugged into an outlet and plugged into the cluster on the side of the power box on the bottom.

This is the USB in which you plug the Ethernet cord into. The other end of the USB is plugged into one of the nodes.

The Ethernet is plugged into the USB.

The monitor, keyboard, mouse, and Ethernet have been plugged in.

The Intel USB is what I am booting BCCD from. Now you are ready to boot, assuming that you have the power cord plugged in.

Booting

• First you need to turn on the monitor, and flip the switch on the power box on the cluster. Whichever node you are booting, hold down the red button on it and wait for the blue light to come on; this means that the node is powering on. If you are wanting to boot more than one node, the myth is wait thirty seconds between each one.

It powered on the node by pressing down the red button, and waiting for the blue light to come on.

Here I have booted the node on the left of the head node, indicated by the blue light. If you are booting the head node, the other light indicates the activity of the hard drive. It will not be a solid color.

Booting off USB

• You will now begin booting off of the USB, and to do that press F11 on the keyboard. A window will pop up asking you to choose your NIC and BCCD network. There will be two options that pop up that look similar to this :
  eth0()
  eth1(Some IP Address)
• Choose eth1(Some IP Address) option. It will now ask you if you want to skip this No DHCP eth0() . Choose no if you are wanting to connect to other nodes. If you are not wanting to connect to other nodes, then select yes.
• If you selected choice no to the previous question: It will ask you to enter the IP address for eth0(). Enter the IP address: 192.168.4.1 . It will now ask you to enter the net mask for eth0(). Enter the net mask: 255.255.255.0 The next window that pops up will tell you the IP Address that has been identified for eth1() and ask if you would like to take it. Select yes.
• If you selected chose yes to skipping No DHCP eth0() : It will tell you the IP Address that has been identified for eth1() and ask if you would like to take it. Select yes.
• BCCD will now begin loading. Be patient, and let load. You will know it's done loading when two terminals show up on your screen, one blue and one black.

How to Liberate

• You can now liberate by copying everything you just took off of the USB to your hard drive.Type the following command into the terminal: sudo perl /root/liberate.pl --libdev /dev/sda Where --libdev is what you are installing, /dev/ is your destination, and /sda indicates that you want it to go to the hard drive.
• You will be asked to enter the sudo password, which is bccd. Enter the password and let it liberate and copy everything to your hard drive. The green light on the head nodes indicates the hard drive activity, so it should be flickering.
• After it is done type command su , and you will be asked for a password, enter letmein
• The machine is now liberated, so in order to connect to other nodes, we must reboot. So now type reboot
• Before you power on the other nodes, you must set up your network. This time in order to set up your BCCD and NIC network type the command -bccd-nic-setup , followed by the command sudo /bin/bccd-reset-network You will be asked for the sudo password, and it's the same as before: letmein
• The same screen that showed up when you were choosing your NIC and BCCD network when booting off the USB will pop up again. This time choose eth0() The next window the pops up, choose to not skip it.
• You will be asked next if you want to make eth0() the PXE-capable NIC , for this question select yes. Next window is asking you if you want to skip No DHCP for eth0:1, for this question select yes. And the final question asked is if you want like to take the other IP found, and for this select yes.
• You can now turn on the other nodes. The myth is, after you turn one on, wait 30 seconds before turning on the next one.

Running a Basic Program

• In order to see the programs available type command : ls
• There are a few programs available but I will provide you with the steps in order to run the program GalaxSee.
• Type command : cd GalaxSee -- This allows you to change into the directory of GalaxSee.
• Type command: make clean -- This allows you to clean out unnecessary files.
• Type command: make -- You remake and compile all of the files in order to run GalaxSee.
• This next command you will actually run the program GalaxSee. Command: mpirun -np 2 -machinefile ~/machines ./GalaxSee 500 500 1000 O
• The mpirun is just telling you to run it. -np 2 refers to the number of processors you are using. In this example only the head node running, so it's two processors. -machinefile ~/machines tells you that you got this information about the nodes from the machinefile which is in the machines directory. ./GalaxSee in this directory run the program GalaxSee. The first 500 500 1000 refer to number of bodies, mass, and grow rotation. And the O at the end of the line is optional. It means to run with graphics. If you are doing testing or something then you could leave off the O so not to be bothered with graphics.