diff --git a/_includes/danger.html b/_includes/danger.html index d8a87d6..1a28e63 100644 --- a/_includes/danger.html +++ b/_includes/danger.html @@ -1,7 +1,7 @@ - +{% endcomment %}
- {{ include.title }} {{ include.message }} + {{ include.title }} - {{ include.message }}
diff --git a/_includes/info.html b/_includes/info.html index ec7c894..b310e82 100644 --- a/_includes/info.html +++ b/_includes/info.html @@ -1,7 +1,7 @@ - +{% endcomment %}
- {{ include.title }} {{ include.message }} + {{ include.title }} - {{ include.message }}
diff --git a/_includes/success.html b/_includes/success.html index aa45ba5..63cc25e 100644 --- a/_includes/success.html +++ b/_includes/success.html @@ -1,7 +1,7 @@ - +{% endcomment %}
- {{ include.title }} {{ include.message }} + {{ include.title }} - {{ include.message }}
diff --git a/_includes/warning.html b/_includes/warning.html index 02794b0..b2190fa 100644 --- a/_includes/warning.html +++ b/_includes/warning.html @@ -1,7 +1,7 @@ - +{% endcomment %}
- {{ include.title }} {{ include.message }} + {{ include.title }} - {{ include.message }}
diff --git a/articles/installation/getting_started.md b/articles/installation/getting_started.md index 4b27975..fb9dba7 100755 --- a/articles/installation/getting_started.md +++ b/articles/installation/getting_started.md @@ -14,35 +14,47 @@ 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 here"%} -## 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 Virtualbox install guide."%} 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) @@ -50,4 +62,4 @@ If your school or organisation uses any form of web filtering or a proxy to acce 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 user migration guide for details on how to upgrade to PiNet."%} diff --git a/assets/images/raspi-login-large.jpeg b/assets/images/raspi-login-large.jpeg new file mode 100755 index 0000000..58cc6c3 Binary files /dev/null and b/assets/images/raspi-login-large.jpeg differ diff --git a/assets/images/raspi-login.jpeg b/assets/images/raspi-login.jpeg index 58cc6c3..ac3ef52 100755 Binary files a/assets/images/raspi-login.jpeg and b/assets/images/raspi-login.jpeg differ