Howdy! We’ve been waiting for you! Glad you made it!
Congratulations on your new MiniPiRack™!
What To Do Next
- Unbox the MiniPiRack™. Everything you need to get started is included except for a network cable.
- Connect the MiniPiRack™ to your router. You can use either ethernet jack on the back of the MiniPiRack™. (See note below)
- 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.
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:
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>
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:
The ssh command to use is:
– 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.
More questions? Check out the FAQ!
If you have questions, comments or suggestions, we’d love to hear from you at email@example.com!
We’d also love to hear how you are using your MiniPiRack™. It helps us improve the product!