Skip to content

Commit

Permalink
Update alerts and getting started page
Browse files Browse the repository at this point in the history
  • Loading branch information
gbaman committed Apr 22, 2017
1 parent 1368625 commit 8eef61b
Show file tree
Hide file tree
Showing 7 changed files with 45 additions and 33 deletions.
6 changes: 3 additions & 3 deletions _includes/danger.html
@@ -1,7 +1,7 @@
<!--
{% comment %}
{% include danger.html title="Title" message="Message!"%}
-->
{% endcomment %}

<div class="alert alert-danger">
<strong>{{ include.title }}</strong> {{ include.message }}
<strong>{{ include.title }}</strong> - {{ include.message }}
</div>
6 changes: 3 additions & 3 deletions _includes/info.html
@@ -1,7 +1,7 @@
<!--
{% comment %}
{% include info.html title="Title" message="Message!"%}
-->
{% endcomment %}

<div class="alert alert-info">
<strong>{{ include.title }}</strong> {{ include.message }}
<strong>{{ include.title }}</strong> - {{ include.message }}
</div>
6 changes: 3 additions & 3 deletions _includes/success.html
@@ -1,7 +1,7 @@
<!--
{% comment %}
{% include success.html title="Title" message="Message!"%}
-->
{% endcomment %}

<div class="alert alert-success">
<strong>{{ include.title }}</strong> {{ include.message }}
<strong>{{ include.title }}</strong> - {{ include.message }}
</div>
6 changes: 3 additions & 3 deletions _includes/warning.html
@@ -1,7 +1,7 @@
<!--
{% comment %}
{% include warning.html title="Title" message="Message!"%}
-->
{% endcomment %}

<div class="alert alert-warning">
<strong>{{ include.title }}</strong> {{ include.message }}
<strong>{{ include.title }}</strong> - {{ include.message }}
</div>
54 changes: 33 additions & 21 deletions articles/installation/getting_started.md
Expand Up @@ -14,40 +14,52 @@ Its key features include
- Network based user accounts - Any student can sit down at any Raspberry Pi and log in.
- Network based operating system - All Raspberry Pis boot a single master Raspbian operating system.
- Shared folders - Easy to use shared folder system for teachers and students.
- Work collection system - Simple work collection/submittion system to allow students to hand in work.
- Work collection system - Simple work collection/submission system to allow students to hand in work.
- Automated backups - Automatically backup all students work to an external drive periodically.
- Many more small features like batch user import, classroom management software integration etc.

The server software is installed on a computer running Ubuntu Linux 14.04 (legacy) or 16.04 (recommended). Ubuntu is completely free. You must then connect the server and Raspberry Pis together by using a [wired network](hardware.html).
**Note Wifi is not supported** - More information on WiFi [here](../faq.html).
The server software is installed on a computer running [Ubuntu Linux 16.04](https://www.ubuntu.com/desktop) (recommended). Ubuntu is completely free. You must then connect the server and Raspberry Pis together by using a [wired network](hardware.html).
{% include warning.html title="Note Wifi is not supported" message="More information on WiFi <a href='../faq.html'>here</a>"%}

## Ok, I am interested... How do I get started?
First you need to grab the required equipment. Full details of this can be found on the [hardware page](hardware.html).
- An old desktop/laptop computer for the server with a gigabit ethernet port.
- A network switch (requires at least a single gigabit or 1000/100/10mbit port for the server).
- A router (for a standalone network) or connection to your schools network.
- Some Ethernet cables.
- A Raspberry Pi and SD card with a size of at least 128mb (so yes, 2gb, 4gb, 8gb etc cards will also work).

### I dont have a spare old desktop/laptop computer sitting around currently..
**It is not recommended to use this method in a production environment and it is not officially supported.**
You can also install a virtual copy of Ubuntu onto another computer to try it out first. This comes with the advantage it is all self contained. If you don't like PiNet, you can just delete the entire
virtual machine (is contained in a single file).
Although there are a number of pieces of software for virtualization (and if you have your own you prefer to use, please use it), a few examples include Hyper-V, VMWare, Parallels.
I will be using Virtualbox, a free cross-platform virtualization platform.
For more info on Virtualbox setup with PiNet, check the [Virtualbox install guide](virtualbox.html)

## I am interested, what do I need to get started?
First you need to grab the required equipment. Full details of this can be found on the [hardware page](hardware.html).
- A network switch (with at least a [single gigabit or 10/100/1000mbit port](https://youtu.be/Wyy8wb2D_y4?t=79) for the server).
- A router (only if building a standalone network).
- Some ethernet cables to link it all up together.
- A [supported Raspberry Pi](http://pinet.org.uk/articles/key-info.html) with an SD card (or micro SD card) of at least 128MB in size.
- A computer to use for the PiNet server. For this, you have 2 options...

#### Dedicated computer for the PiNet server
PiNet can run on an old desktop/laptop you may have sitting around. Just make sure it adheres to the [minimum specs required for PiNet](hardware.html).

#### Virtual machine running on another Windows/Mac/Linux computer for the PiNet server
Not got an old machine you can dedicate to PiNet? No problem, PiNet can run in an isolated virtual machine on another computer running Windows, Mac OS or Linux. This method comes with a number of advantages including
- It is easy to delete or start again as PiNet/Ubuntu are stored in a single file on the computer.
- Given the PiNet/Ubuntu server is a single file, it can be easily moved to a different computer later down the line.
- Allows for virtual machine snapshots to be used, allowing the server to be easily reverted to an older saved copy.

There are some disadvantages though
- A computer with decent performance is required (see [hardware page](hardware.html) for minimum/recommended hardware required).
- When running the PiNet server, other software running on the computer may feel slower as it is running 2 complete operating systems.
- Additional hard disk space is required (recommended 40GB for PiNet) as the computer holds a full copy of Windows/Mac OS/Linux as well as PiNet/Ubuntu.

If you have a [powerful enough computer](hardware.html), creating a virtual PiNet server is a great way to try PiNet out without much upfront investment. There are a number of different software platforms for creating/running virtual machines including Hyper-V (Windows only and commercial), VMWare (cross platform and commercial) or VirtualBox (cross platform and open source).
The recommended platform for setting up a PiNet server is [VirtualBox](https://www.virtualbox.org/) given it is completely free and open source.

{% include info.html title="Want to try out PiNet with VirtualBox?" message="For more info on Virtualbox setup with PiNet, check the <a href='virtualbox.html'>Virtualbox install guide</a>."%}

Installing
-----------

Once you have the needed equipment, you will need to install Ubuntu 16.04 onto your server computer and then install PiNet.
Once you have the needed equipment, you will need to install Ubuntu 16.04 onto your server computer and then install PiNet.
Overall this takes roughly 2-3 hours. Of that 2-3 hours, you are required at the computer for 20-30 minutes.
Finally when the installation is complete you must copy the generated SD card boot files to a blank SD card.
Finally when the installation is complete you must [copy the generated SD card boot files to a blank SD card](sd-card-copy.html).
If your school or organisation uses any form of web filtering or a proxy to access the internet, make sure to first read the [web filtering information page](../advanced/web-filtering.html).

1. [Installing Ubuntu server](installing-ubuntu.html)
1. [Installing PiNet](installing-PiNet.html)
1. [Copying files to SD card](sd-card-copy.html)

Once completed, you may want to play with some of the other options in PiNet, the full documentation list can be found back on the [guides page](../guides.html).
**If you were previously running a Raspi-LTSP server and wish to migrate to a new PiNet server, check out the [user migration guide](../manage-users/migration.html)**.
{% include info.html title="Currently running Raspi-LTSP?" message="Raspi-LTSP is now no longer supported, check out the <a href='../manage-users/migration.html'>user migration guide</a> for details on how to upgrade to PiNet."%}
Binary file added assets/images/raspi-login-large.jpeg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/images/raspi-login.jpeg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 8eef61b

Please sign in to comment.