1,122
edits
(Created page with "== Using the pre-built Raspberry Pi Image == We have created an customised version of the Raspberry Pi Lite image with Cumulus MX pre-installed and ready to go. This is desig...") |
No edit summary |
||
Line 9: | Line 9: | ||
:A minimum size of 16GB is recommended. Be sure to buy a good quality card. | :A minimum size of 16GB is recommended. Be sure to buy a good quality card. | ||
* An image installer to copy the image file to the SD card | * An image installer to copy the image file to the SD card | ||
:The [https://www.raspberrypi.org/documentation/installation/installing-images/ Raspberry Pi site] has a list of suitable software for your operating system. Scroll down to "Writing the image". | :The [https://www.raspberrypi.org/documentation/installation/installing-images/ Raspberry Pi site] has a list of suitable software for your operating system. Scroll down to "Writing the image".<br /> | ||
: This guide with use Win32DiskImager | |||
* The image file to install | * The image file to install | ||
:Download the latest image file [from here]. | :Download the latest image file [from here]. | ||
* An SSH terminal program to configure your Raspberry Pi | * An SSH terminal program to configure your Raspberry Pi | ||
: For Windows we recommend using [https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html PuTTY] | : For Windows we recommend using [https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html PuTTY] | ||
* A file transfer program - though you will not need this right away, you will need it at some point. The main uses will be... | |||
:* Copying Cumulus MX updates to your Raspberry Pi | |||
:* Extracting the diagnostic files from Cumulus MX if this go wrong | |||
:* Setting up a web site<br /> | |||
:A popular program for Windows is [https://winscp.net/eng/download.php WinSCP] | |||
Line 44: | Line 50: | ||
:* Save the file<br /><br /> | :* Save the file<br /><br /> | ||
* Eject the SD card from your computer and insert it into your Raspberry Pi | * Eject the SD card from your computer and insert it into your Raspberry Pi | ||
=== First Boot === | === First Boot === | ||
* Connect the Pi to your wired network if you did not configure the WiFi as per the steps above. | * Connect the Pi to your wired network if you did not configure the WiFi as per the steps above. | ||
* Power on the Pi. | * Power on the Pi. | ||
* Now wait 5 minutes. The first boot will be resizing your disk and optionally configuring your WiFi | * Now wait 5 minutes. The first boot will be resizing your disk and optionally configuring your WiFi | ||
* Start your browser and see if you can connect to this URL: http://cumulusmx:8998 | * Start your browser and see if you can connect to this URL: http://cumulusmx:8998 | ||
:* If you can great - you should now see the Cumulus MX console | :* If you can great - you should now see the Cumulus MX console | ||
:* If not, then you will have to find out the Raspberry Pi's IP address from your router. Then try connecting to this URL: http://<ip_address>:8998 | :* If not, then you will have to find out the Raspberry Pi's IP address from your router. Then try connecting to this URL: http://<ip_address>:8998 | ||
=== Verify your SSH Connection === | |||
* Fire up your SSH Client - we use PuTTY here | |||
:* Enter the hostname as "cumulusmx", and check the protocol is set to SSH. Then open the connection.<br /> | |||
: (You can use the IP address instead of the hostname if that does not work) | |||
:*; [PuTTY-01.png] | |||
* You will have the accept the SSH key the first time you connect | |||
* Enter the username "pi" and password "raspberry" - these are the default Raspberry Pi username credentials | |||
* When you login it will display a warning about you using the default password and ask you to change it | |||
:* Use the '''passwd''' command to do this now... | |||
<nowiki>pi@cumulusmx:~ $ passwd | |||
Changing password for pi. | |||
Current password: | |||
New password: | |||
Retype new password: | |||
passwd: password updated successfully</nowiki> | |||
* Check the status of the Cumulus MX service with the command '''sudo systemctl status cumulusmx'''<br /> | |||
: You will get some information back, the important bit to note is the line starting '''Active:''', it should say '''active (running)''' | |||
* You can leave the SSH session open, you will need it again soon... | |||
=== Configure Cumulus MX === | |||
Now it is time to configure Cumulus MX for your station. | |||
* Start your browser and connect to the same URL as before - http://cumulusmx:8998 | |||
* From the menu select '''Settings | Station Settings''', then follow the guide on [this page?] for configuring your station | |||
* Once your have completed all the settings for for station, and successfully saved them, Cumulus MX will need to be restarted. | |||
* Back in your SSH session, send the command '''sudo systemctl stop cumulusmx''', this stops the Cumulus MX service. | |||
* Wait a few seconds, then enter the command '''sudo systemctl start cumulusmx''', this starts the Cumulus MX service again. | |||
* Back to your browser and check that URL - http://cumulusmx:8998 - again. If all is well, the default dashboard page should start showing the data from your weather station. | |||
:* If it does, congratulations, you have successfully started recording your weather data | |||
:* If it doesn't, then check back over this process carefully for any mistakes or omissions you may have made. | |||
:* If you cannot resolve the problem, then ask for [https://cumulus.hosiene.co.uk/ help on the forum] | |||
=== Additional Steps === | |||
* Configuring WiFi from SSH | |||
* Stopping Cumulus MX starting up when the Pi boots | |||
* Give your Pi a fixed IP address | |||
:* Add a DHCP reservation | |||
:* Assign a static IP address | |||
=== Information === | |||
* Install location | |||
* systemctl commands | |||
* Starting Cumulus MX from the command line |