Version 6 (modified by, 10 years ago) (diff)


OpenGENI Administrative Frequently Asked Questions

This page shows frequently asked question from administrators of OpenGENI racks and is part of the GENI Rack Administration pages.

User Administration

Q. I am the administrator. What can I access in my rack?

  • Local Administrator: Each OpenGENI rack is initially configured to allow ssh access for one administrator account to all rack devices. If you are this person, than you have access to the control node, compute nodes, and switches in the rack.
  • Additional administrative accounts: Any existing administrative account can be used to create additional administrative accounts. Procedure to create more Administrative accounts detailed in the OpenGENI Rack Administration instructions.

Q. I tried logging into the boss node with my administrative ID and got a "permission denied" error. What is wrong?

Access to the hosts and devices in the OpenGENI rack requires SSH public keys. Your SSH public key must be installed in the authorized_keys file to access the control and compute nodes.

If you want access the rack switches, you must first login to the control node and then ssh to the switches as detailed in your rack control plane details table. For example here is the Clemson rack details for the switches.

Rack Resources

Q. What types of servers are in the racks ?

The OpenGENI rack is implemented on Dell hardware, here is the parts list.

Q. How can I tell if experiments are running in my OpenGENI rack?

On the control node you can check the list of experiments that are currently active by issuing an OpenStack command as follows:

 $ source /etc/novarc && keystone tenant-list|egrep slice 
 | 8f38b505cbef4c4a82463f250d3f9ad6 |    |   True  |
 | cc16776ac7b44341a2430546c2907684 | |   True  |
 | 559624c7d7b043aeb3a3128bb393e9d3 |     |   True  |

The list returned shows that there are 3 experiments that have active resource allocations, the experiment names are OG-EXP-1, gr-clem-ig-gpo, and lnexp23.

Q. Are there OpenGENI logs?

The OpenGENI rack runs GENI Rack Aggregate Manager (GRAM) software to manage rack compute and network resources. There are 4 gram processes to provide these functions and their logs are:

  • /var/log/upstart/gram-am.log - The aggregate manager logs which AM API requests and the quantum commands used to allocate the requested resources.
  • /var/log/upstart/gram-ctrl.log - The OpenFlow Controller running on the OpenGENI rack which will capture request for OF resources.
  • /var/log/upstart/gram-opsmon.log - Monitoring log is created by the gram-mon daemon, file captures relevant information from the GRAM snapshots which are logged in this file easier readability.
  • /var/log/upstart/gram-vmoc.log - VLAN-based Multiplexing OpenFlow Controller (VMOC) is a switch to experimenter provided controller, that multiples based on VLAN tag and switch DPID/port. A default Layer2 Learning controller is used for slices that do not specify a controller.

Network Requirements

Q. Which ports will need to be open for my OpenGENI rack?

The list of required ports for the OpenGENI rack can be found in the OpenGENI Checklist. If your rack is inside a campus firewall then the following ports must be allowed through your campus network firewall to the entire rack subnet:

  • 22 - ssh
  • 25 - smtp (outbound connections only, from control node)
  • 80 - http (must also allow outbound connections from control node)
  • 443 - https (must also allow outbound connections from control node)
  • 843 - Flash Policy Server
  • 5001 - GRAM
  • 5002 - GRAM
  • 30000-65535 - Ports used by GRAM software.
  • ICMP - ping