Basic install instructions
if you are interested in using the bleeding edge version as it’s developed, see nightly builds for more information
Install Ubuntu Server to computer (the guide is for an older version of Ubuntu, new installs should be on at least 14.04 or Debian 7. The installation guide is still somewhat useful as a guide). UbuntuServerInstallation (Ubuntu 14.04 (LTS) is tested and currently supported. Debian 7 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 latest grase-repo package from http://packages.grasehotspot.org/pool/main/g/grase-repo/
e.g. (Update 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.7_all.deb
install the package
$ sudo dpkg -i grase-repo_1.7_all.deb
Update the repository
$ sudo apt-get update
Then install the components. Currently for a full system, the following command should suffice
$ sudo apt-get install grase-www-portal grase-conf-freeradius grase-conf-openvpn
This will proceed to download all the dependencies as well 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.
Finally, if you have a support contract for full remote assistance, then install the remote assistance part. (Certain organisations currently get this, if in doubt please contact me first).
Please do not install the grase-remote-assist-user unless you understand why you are installing. I have purposely made the below command break if you copy and paste it and do not understand what it is.$ sudo apt-get install grase_remote_assist_user
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, and submit the systems key to a central server for remote admin. (But not the remote admin user setup, that will have to come later at this stage).
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