Clone this wiki locally
Basic install instructions
Install Ubuntu Server to computer. Ubuntu Server Installation (Ubuntu 12.04 (LTS) is tested and currently supported. Debian 6 is also currently supported)
If you didn't follow the Ubuntu Server install instructions, or have installed a GUI, please check the Hardware Setup page for some important information about the network card setup.
When it boots you will be presented with a prompt. Login with the username and password you set.
Download the latest grase-repo package from http://packages.grasehotspot.org/pool/main/g/grase-repo/
Update this command to point to the latest grase-repo package at the above link
$ wget http://packages.grasehotspot.org/pool/main/g/grase-repo/grase-repo_1.5_all.deb
Install the grase-repo package you just downloaded (Update the filename to match what you downloaded above)
$ sudo dpkg -i grase-repo_1.5_all.deb
- Update the repository
sh $ sudo apt-get update
If you get a result similar to this at the end of the update:
"W:Failed to fetch bzip2:/var/lib/apt/lists/partial/it.archive.ubuntu.com_ubuntu_dists_precise-updates_universe_binary-amd64_Packages Hash Sum mismatch
E:Some index files failed to download. They have been ignored, or old ones used instead."
Then the grasehotspot #6 step will fail, if this happens to you enter these commands to get you updated for the next step:
sudo rm -rf /var/lib/apt/lists/* sudo apt-get update
- Then install the components. Currently for a full system, the following command should suffice
sh $ sudo apt-get install grase-www-portal grase-conf-freeradius grase-conf-openvpn
This will download all the requested packages and their dependencies and install them. It will ask a few questions which are needed to finish setting it up. See the below sections for answering these questions
If you have issues installing coova-chilli, see http://support.rstudio.org/help/kb/advanced/installing-openssl-098-on-debian-7-wheezy for more information on installing libssl0.9.8
IMPORTANT: In the interest of total openness, you should be aware that the grase-conf-openvpn package will connect your Hotspot computer to a virtual private network, that allows remote access to your computer on that virtual private network. This is used for 3 purposes:
- If you request assistance, we have a method of connecting to your Grase hotspot machine remotely to assist you. This connection is the same as if I was sitting on your WiFi network, so I am unable to access any other device other than your Grase Hotspot machine, and I am only able to access it's web interface. (This is also the reason for the support user in the web interface)
- Statistics gathering. Again, only the information that is publicly available on the web interface, in particular the version you are using. Used to track uptake of new versions
- So YOU can remotely administer your Grase Hotspot. If you need the ability to remotely login to your Grase Hotspot device, (i.e. from outside of your WiFi/Local network). If you need to do this, please contact me to arrange your side of the connection, so we ensure your computer remains secure
To be clear, I DO NOT have any more access to your computer, than the admin web interface provides. If you delete the support user, the only access I have is to get the version number for Statistics gathering.
Please do not install the grase-remote-assist-user unless you understand why you are installing and have discussed it with Tim first. It is in the repository to assist with installing it when remotely assisting someone
Attempting to setup the database manually is possible but should not be attempted without good reason.
- When it asks you if you want to use dbconfig-common to manage it, please answer yes.
- You will then need to enter the MySQL root users password which was set during the Ubuntu Server install. If you didn't select LAMP when installing Ubuntu Server, before you get to this question it will install MySQL and ask you to set a password.
- It will then ask you for and "MySQL application password for grase-conf-freeradius. You can leave this blank and a random password will be created. If you are going to want/need to poke around in the user database userself with SQL commands, then set this password to something you know.
See the above section for grase-conf-freeradius, all of that applies for this, it's just for the database for the web interface (mostly admin users and logs)
This should have installed the base system. If you have installed the
grase-conf-openvpn package, it will have automatically generated secure VPN keys, and connected to the VPN.
You should now be able to access the web interface at http://10.1.0.1/grase/radmin (from the LAN side). The LAN side is the network interface you are running your WiFi Access Point off.
Default username is admin and password is hotspotadmin