The last steps: Difference between revisions

From Global Meteor Network
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
'''WARNING: THIS IS A PAGE IN PROGRESS! DO NOT FOLLOW IT IF YOU ARE LOOKING FOR THE BUILDING OF A CAMERA FROM SCRATCH'''
'''WARNING: THIS IS A PAGE IN PROGRESS! DO NOT FOLLOW IT IF YOU ARE LOOKING FOR THE BUILDING OF A CAMERA FROM SCRATCH'''
  Ahoj! In this section, you will put your camera into the production stream on the server side.
  Ahoj! In this section, you will put your camera into the production stream on the server side by finishing configuration of RMS software in Linux.


= header1 =
The script will guide you through this process, but you will need these in advance:
== Header2 ==
== Header2 ==
== Header2 ==


You are now done with this section and now you are going to focus your camera and put all bits and pieces together for the first test. Exciting, isn't it? [https://globalmeteornetwork.org/wiki/index.php?title=Build_%26_Install_%26_Setup_your_camera_-_The_complete_how-to Back to the signpost page.]
 
 
= Automated setup via script =
 
= Manual setup via command line =
 
== Capture software ==
The recording program is called RMS.StartCapture. A script that auto-updates the code is called RMS_FirstRun and it will start automatically when the RPi boots up, after which the recording loop will start. Note that during the update procedure, the config file will be reset. Please wait until the update is done, and your old config file will be copied back.
 
The capture will automatically start with sundown and stop with sunrise, although this is very dependent on the correct location of the camera being entered in the configuration file (see the Configuration section below).
Configuration
Changing the system password
If you haven’t changed your password during the initial configuration through the terminal window, so we strongly recommend that you change it.
 
 
== How to do it: ==
Boot up your RPi.
Open the terminal by clicking Start (RPi icon) → Accessories → Terminal
In the window that pops up, type passwd and press enter.
You will be asked to enter your current password - which is raspberry or rmsraspberry - and then your new password. Keep this new password in a secure place.
 
== Determining the location of the camera ==
To participate in the network you will need a unique station code. We will generate one for you once you let us know the exact geographical location of the camera. Measuring the precise location of the camera is very important for triangulating meteor trajectories - the location of you camera will not be shared with anyone without your consent.
 
How to do it:
Use a GPS app on your smartphone to measure the location by holding the phone close to the camera and write down the latitude, longitude and elevation. In the worst case, use Google Maps. Please use the precision for the longitude and latitude of at least 5 decimal places (or to within one “), and the elevation to a meter.
 
== Generating an SSH key ==
Every morning all meteor detections from the previous night are uploaded to the server, where trajectories and orbits of meteors are estimated. The system uses a secure way of talking to our server at the University of Western Ontario, and for that to work you need to generate an SSH key for your RPi and send it to us.
 
How to do it:
Boot up your RPi
Open the terminal by clicking Start (RPi icon) → Accessories → Terminal
Type: ssh-keygen -t rsa -m PEM and press enter
You will be asked where to save the SSH key, but just press enter.
If it asks you to overwrite the existing key, type y and press enter.
You will be asked for a passphrase two times. Don’t type anything and just press enter both times.
Type cat ~/.ssh/id_rsa.pub and press enter.
Your SSH key will be printed to the terminal. The key starts with “ssh-rsa”, followed by a long string of characters, and it ends with “pi@raspberry”. Copy the whole key and send it to yourself via e-mail, or in any other way to keep it for later.
 
== Obtaining the station code ==
Send an e-mail to denis.vida@gmail.com with a short description of your camera, the country where the camera is located in, the geographical coordinates and the SSH key you have generated and copied in the step above. Also, send an approximate pointing of the camera - the azimuth measured from due North, and the elevation. You can measure the azimuth using a compass (or an compass app), and you can eyeball the elevation (0 degrees being the horizon, 90 degrees the zenith, i.e. straight up).
You will receive your unique station code within a period of several days at most. The station code consists of the ISO Alpha-2 country code followed by four alphanumeric characters, e.g. US00A2.
 
== Modifying the configuration file ==
Boot up your RPi
On the desktop there is a file called “RMS config”, open it.
Under the “[System]” section, write the station ID and the coordinates of your camera, which should look something like this:
[System]
stationID: CA0003
latitude: 42.7961 ; +N in degrees
longitude: -81.84219 ; +E in degrees
elevation: 312 ; meters
 
Make sure to leave a space before the semicolon at the end of the line! For example:
Good: latitude: 42.7961 ; +N in degrees
Bad: latitude: 42.7961; +N in degrees
 
Under the “[Upload]” section, change:
 
upload_enabled: false
 
To:
 
upload_enabled: true
 
Save the file by pressing File → Save.
All done!
 
You are now done with this section and now you may proceed with the optional steps, please make sure to at least go through the optional steps. [https://globalmeteornetwork.org/wiki/index.php?title=Build_%26_Install_%26_Setup_your_camera_-_The_complete_how-to Back to the signpost page.]

Revision as of 13:31, 17 April 2023

WARNING: THIS IS A PAGE IN PROGRESS! DO NOT FOLLOW IT IF YOU ARE LOOKING FOR THE BUILDING OF A CAMERA FROM SCRATCH

Ahoj! In this section, you will put your camera into the production stream on the server side by finishing configuration of RMS software in Linux.

The script will guide you through this process, but you will need these in advance:


Automated setup via script

Manual setup via command line

Capture software

The recording program is called RMS.StartCapture. A script that auto-updates the code is called RMS_FirstRun and it will start automatically when the RPi boots up, after which the recording loop will start. Note that during the update procedure, the config file will be reset. Please wait until the update is done, and your old config file will be copied back.

The capture will automatically start with sundown and stop with sunrise, although this is very dependent on the correct location of the camera being entered in the configuration file (see the Configuration section below). Configuration Changing the system password If you haven’t changed your password during the initial configuration through the terminal window, so we strongly recommend that you change it.


How to do it:

Boot up your RPi. Open the terminal by clicking Start (RPi icon) → Accessories → Terminal In the window that pops up, type passwd and press enter. You will be asked to enter your current password - which is raspberry or rmsraspberry - and then your new password. Keep this new password in a secure place.

Determining the location of the camera

To participate in the network you will need a unique station code. We will generate one for you once you let us know the exact geographical location of the camera. Measuring the precise location of the camera is very important for triangulating meteor trajectories - the location of you camera will not be shared with anyone without your consent.

How to do it: Use a GPS app on your smartphone to measure the location by holding the phone close to the camera and write down the latitude, longitude and elevation. In the worst case, use Google Maps. Please use the precision for the longitude and latitude of at least 5 decimal places (or to within one “), and the elevation to a meter.

Generating an SSH key

Every morning all meteor detections from the previous night are uploaded to the server, where trajectories and orbits of meteors are estimated. The system uses a secure way of talking to our server at the University of Western Ontario, and for that to work you need to generate an SSH key for your RPi and send it to us.

How to do it: Boot up your RPi Open the terminal by clicking Start (RPi icon) → Accessories → Terminal Type: ssh-keygen -t rsa -m PEM and press enter You will be asked where to save the SSH key, but just press enter. If it asks you to overwrite the existing key, type y and press enter. You will be asked for a passphrase two times. Don’t type anything and just press enter both times. Type cat ~/.ssh/id_rsa.pub and press enter. Your SSH key will be printed to the terminal. The key starts with “ssh-rsa”, followed by a long string of characters, and it ends with “pi@raspberry”. Copy the whole key and send it to yourself via e-mail, or in any other way to keep it for later.

Obtaining the station code

Send an e-mail to denis.vida@gmail.com with a short description of your camera, the country where the camera is located in, the geographical coordinates and the SSH key you have generated and copied in the step above. Also, send an approximate pointing of the camera - the azimuth measured from due North, and the elevation. You can measure the azimuth using a compass (or an compass app), and you can eyeball the elevation (0 degrees being the horizon, 90 degrees the zenith, i.e. straight up). You will receive your unique station code within a period of several days at most. The station code consists of the ISO Alpha-2 country code followed by four alphanumeric characters, e.g. US00A2.

Modifying the configuration file

Boot up your RPi On the desktop there is a file called “RMS config”, open it. Under the “[System]” section, write the station ID and the coordinates of your camera, which should look something like this: [System] stationID: CA0003 latitude: 42.7961 ; +N in degrees longitude: -81.84219 ; +E in degrees elevation: 312 ; meters

Make sure to leave a space before the semicolon at the end of the line! For example: Good: latitude: 42.7961 ; +N in degrees Bad: latitude: 42.7961; +N in degrees

Under the “[Upload]” section, change:

upload_enabled: false

To:

upload_enabled: true

Save the file by pressing File → Save. All done!

You are now done with this section and now you may proceed with the optional steps, please make sure to at least go through the optional steps. Back to the signpost page.