Software Installation Setup

 

 

OK Jayfish install files have been completely re-written for Raspian Stretch, we no longer support fresh installs under Raspian Jessie as of 1 September 2017, Thank you for your patience in waiting for the change to Stretch Support.

STEP 1

PREREQUISITES

The first step is obtain your setup and install files. We do this by using the wget command from the command line.  You will notice when you have installed or started up Raspian Stretch, it would have booted straight to the desktop.  Simply open a terminal screen window so that you can execute commands from the command line.

Let’s start by downloading and running the primary setup file.  From your terminal window we are going to start by creating a jayfish install folder.  Run the following commands.

mkdir jayfish4

cd jayfish4

wget http://www.jayfish.net/setup/base-setup.sh

sh base-setup.sh

This would have effectively downloaded the latest install package.  Now that we have the base install files, lets move to STEP 2

THE FOUNDATION INSTALL

There are two ways you can proceed, either you can SSH (Remotely from your PC or MAC) or login in to your pi locally once you know the ip address.

To be clear we need you at the command prompt logged in as the user pi to proceed.  And you need to be In the terminal screen.

TIP: Make sure your keyboard is set correctly in raspi-config. If you are not getting the characters you want when you type, you need to setup your keyboard accordingly in raspi-config (remember to always launch this using sudo). Like this sudo raspi-config raspi-config is an administration tool and requires super user permission.

Now lets navigate to your jayfish install folder if your are not there already. To do this type in the following and press enter.

cd /home/pi/jayfish4


TIP:Lets validate your your current directory by typing in pwd and press enter.

It should return /home/pi/jayfish4

Now that we are in the right place , lets go ahead and run the first part of the installation.  The first part of the installation is going to update your pi to the latest file version and ensure your files are up to date.  It will then proceed to install the webserver (apache) and the database server (MariaDB) aswell as PHP scripting support.  To run this part of the install execute the following.

sudo sh install-stretch.sh

TIP: Answer Yes to any prompts.

On to Step 3

Let’s Validate the install.  What we would like to have accomplished at this stage is to have succesfully done the following.

  • downloaded the master install file (base-setup.sh)
  • run the master install file (base-setup.sh) to download supporting installation files.
  • run the LAMP stack install file (install-stretch.sh) to install Web Server, SQL & PHP.

Before we continue, let’s check to see that those services installed correctly.  First obtain your ip address, by running the following command from your terminal window.

ifconfig

  1. Goto your PC or Mac that is on the same network as your Raspberry Pi and try the following URL http://x.x.x.x (x.x.x.x = the ip address of your raspberry pi)
  2. If all went according to plan, you should see the following result.

Great !! now lets validate that MySQL/MariaDB install correctly.  In Raspian Stretch we now use MariaDB, it qorks quite differently as compared to before where you would use the root functionality.  This is no longer the case you simply just use sudo mysql and it automatically elevates your access to SQL.

    1. Let’s try it out.

sudo mysql

exit

    1. You should have seen MariaDB login, and the exit command should have kicked out out back to the command prompt.

WELL DONE YOUR DOING GREAT 🙂

LETS ADD THE WEBSITE & DATABASE

This setup will create the website itself, the database user and the database itself.  Note that this is based on a clean install and no existing installation of jayfish has been run.  If it is run again, it will not cause any problems but you will see an error on the screen about the user already existing.

Lets proceed.

sudo sh post-install.sh

After this step you should be able to see Jayfish itslef by accessing it via a browser http://x.x.x.x where x.x.x.x = the ip address of your raspberry pi. If you do not know your up address simply type in ifconfig

TIP: if your using wireless look for wlan0 if wired look for eth0

Let’s move on to the next step, Your doing Fantastic !!!

 

Services that talk to the hardware

Services need to be running in the background in order for the system to constantly monitor schedules and hardware devices, these services are what physically controls the relays and monitors the temperature settings. They essentially monitor the database for changes and constantly check the time to make decisions based on your settings.

Now execute the service install. And reboot when done.

sudo sh service-install.sh

sudo reboot

Once you access the webstie, it’s important to check your services, to do this goto the website navigation location. Modules – Services Check, and they should all register as GREEN

 

 

TEMPERATURE PROBES

Your temperature probes will not take readings if the 1 wire modules are not initialized so you need to configure you Rasperry Pi to run the 1 Wire protocol and start looking to find your temperature sensors.  The 1 Wire protocol is very literal its an electronic standard to read data from a simply 1 wire device, meaning data via one wire.  The 1 wire devices are also able to be bridged in parallel. meaning you join all their data pins together as one and they will each declare themselves to the Pi as separate units by serial number.  Pretty Neat.  You will understand more when you see how they are wired.

Run the following command to enable the 1 Wire protocol.

sudo raspi-config
Choose Interfacing Options

Choose P7 1-Wire

And Choose YES to enable it, after this step it will take you back to the main menu where you can choose Finish Setup after-which it will prompt you to reboot.

Great, now your system is ready to be able to accept temperature sensors on the 1-wire pin.  The Hardware guide will explain how to wire it up.

The last step will be a brief intro to what’s what in the site, so that you can make sense of it and understand the sections.

To See the Help Guide, navigate to Help Guide on this website under Support – Help Guide

 

 

 

!!! Remember after loading the default password is 123 – change once logged in.

If you forget your password you can restore the password to default by going to your install folder and run the following command.

You will first be asked to enter you MySQL Password.  After that it will be reset to 123.  (Reminder the password it asks you for is your root MySQL password .. not a new admin password !!!)

sudo mysql  <sqlpatch_password_reset.sql

 

Once you have your LCD connected, simply have your Raspberry Pi boot  up into the operating system, start Chromium browser, in the URL bar type in http://127.0.0.1/lcdmonitor.php and press enter.  If you are not already in the operating system and prefer to start the graphic environment manually type in startx from the command line.

You can do that same with any cell phone, or pc screen remotely .. or whatever you choose to use.  But the Pi 7″ Touch screen to me is the best and what I am specifically designing it for.  If you use something else like an old android tablet in the browser type in http://x.x.x.x/lcdmonitor.php

HOW GETTING RID  OF THE MOUSE CURSOR SO IT LOOKS LIKE TRUE KIOSK MODE.

Hide Raspberry Pi Mouse Cursor in Raspbian (Kiosk)

Here’s how we did it:

1. Install Unclutter

Log in to your Raspberry Pi via SSH – or open terminal directly on the Pi. Then install Unclutter, like this:

sudo apt-get install unclutter

2. Edit LXDE Autostart Script

Next we need to edit the LXDE Autostart script – for us this means running:

nano ~/.config/lxsession/LXDE-pi/autostart

3. Turn the Cursor Off

Finally you need to add this line to the autostart script:

@unclutter -idle 0

Press ctrl+X and then hit Y to save your changes.

4. Reboot

Finally, reboot your Pi using:

sudo reboot

You should find that the mouse cursor has entirely disappeared.

Simple!