Welcome

Howdy! We’ve been waiting for you! Glad you made it!

Congratulations on your new MiniPiRack™!

What To Do Next

  1. Unbox the MiniPiRack™. Everything you need to get started is included except for a network cable.
  2. Connect the MiniPiRack™ to your router. You can use either ethernet jack on the back of the MiniPiRack™. (See note below)
  3. Turn on the MiniPiRack™.

* NOTE: The LEDs on Ethernet ports will NOT light up! This is a known issue (Whoops!) and will be addressed in a future hardware revision. To see link status, check the six LEDs on the side of the MiniPiRack™. The two lower green LEDs indicate the link status of the Ethernet ports.

If you have you questions not answered here, check out the FAQ! or drop us a line.

Two very important numbers are included on the insert that’s included in the box with the MiniPiRack™:

  • Serial Number (format like XXXXXX-XXXX-XXXXXX)
  • User Token (format like YYYYYYYY)

Don’t lose these! You’ll see how to use these shortly.

How to find the IP Addresses of each host in your MiniPiRack™
The MiniPiRack™ is a headless device by design. Each host ships with DHCP enabled for the ethernet port. It’ll take a little sleuthing to find the ip address of each host.

The host names of the hosts are:

  • p1-r1
  • p2-r1
  • p3-r1

The hostnames follow the format <pi one>-<rack one>, <pi two>-<rack one>, etc.  Since the MiniPiRack™ is designed to scale, this naming convention allows for easily addressable racks as the cluster expands.  Of course, like everything about the MiniPiRack™, this can be changed to what ever you’d like.  It’s 100% customizable to your needs.  It’s just Linux, after all!

If you are using OS X or most versions of linux, you might be able to find the IP address by pinging the hostname of one of the hosts with “.local” appended like so:

>> ping p1-r1.local
PING p1-r1.local (10.1.2.139): 56 data bytes
64 bytes from 10.1.2.139: icmp_seq=0 ttl=64 time=5.914 ms

If that fails, you can use the MiniPiRack™ auto-registration server to discover the IP address of each host. To use the auto-registration server, use curl along with the serial number and user token like follows:

curl http://register.minipirack.com/rack/<serial number>/?token=<user token>

For example:
curl http://register.minipirack.com/rack/0000000/?token=1234ABCD

The auto-registration server should return the current local IP address of each host.

Once you have the IP address of each host, you can ssh default credentials for the Hypriot OS:
Username: pirate
Password: hypriot

The ssh command to use is:
ssh pirate@p1-r1.local
– or –
ssh pirate@<ip address>

Note: The MiniPiRack™ auto-registration server is an optional convenience feature to help make discovering the IP addresses of the MiniPiRack™ quick and simple. If you would prefer to disable the auto-registration feature, refer to /etc/network/if-up.d/update_ip on any MiniPiRack™ host for more information or just delete that file.

Enjoy!

More questions? Check out the FAQ!

If you have questions, comments or suggestions, we’d love to hear from you at support@minipirack.com!

We’d also love to hear how you are using your MiniPiRack™. It helps us improve the product!