Setup Ubuntu Installation for Use with Beam Cruncher Camera System - crunchtec/Beam-Cruncher-Wiki GitHub Wiki

Before beginning: Connect the computer that this Ubuntu installation is on to the internet via a Ethernet cable with a route to the LAN's modem - i.e. plug it into the RJ45 wall jack.

Create Beam Cruncher Directory

Create the Beam Cruncher directory in the Home folder for the user 'crunch' - this can be done with the command "mkdir ~/'Beam Cruncher'" (note the encapsulation of 'Beam Cruncher' in single quotes).

Install Beam Cruncher Software

In the Beam-Cruncher repository, find the release section. Select the tree for the latest release of the Beam-Cruncher software. This tree should appear similar to the one below (for v1.0.0): https://github.com/crunchtec/Beam-Cruncher-Wiki/blob/master/install_screen.png

Download the 'BeamCruncher' executable (the largest file in the release), the 'LICENSE.txt' file, the 'readme.txt' file and the 'resources.zip' file and place them in the newly created Beam Cruncher directory on the Ubuntu installation. Right click the 'resources.zip' file and click 'Extract here'. This will create a folder named 'resources' in the Beam Cruncher directory. Now delete 'resources.zip'.

Next, download the 'Beam.Cruncher.desktop' file and place it in the ~/Desktop directory (i.e. place it on the Ubuntu Desktop). Right click on the 'Beam.Cruncher.desktop' file and select 'Properties'. Then, select the 'Permissions' tab. and check the 'Allow executing file as a program' box.

Double-click the 'Beam.Cruncher.desktop' file and accept any message/warning, if prompted. The Beam Cruncher software should now launch and the desktop icon should change to a Crunch 'C' logo.

Setup Wired Static IP

Disconnect the Ubuntu installation from the internet by unplugging the Ethernet cable from the RJ45 wall jack. Instead, now plug the ethernet cable into the UniFi port switch. Click the internet icon at the top-right of the Ubuntu desktop and select "Wired Disconnected" to bring up the wired internet options tree. Select 'Wired Settings'. Then, click the gear button to the right of the On/Off switch under "Wired". You will be presented with the Wired connection details. Select the 'IPv4' tab at the top of this window.

Wired Static IP Settings

Select the IPv4 Method as 'Manual'. Under Addresses, enter '192.168.88.251' into the 'Address' box, '255.255.255.0' into the 'Netmask' box and '192.168.88.1' into the 'Gateway' box. This will instruct the Ubuntu wired internet connection to assign itself an IP address of 192.168.88.251 and connect to the Camera Servers via the 'Gateway' 192.168.88.1, which is the static IP address of the port switch - Note: if the port switch has not been setup with a static IP address yet, follow the instructions on this wiki to do so under 'Setup Static IP Address on UniFi PoE Managed Port Switch'.

Leave the DNS and Routes options as 'Automatic' on. Select 'Apply'.

Next, select the Wi-Fi menu tree and then 'Turn Off'.

Disable Screen Lock/ Screen Dimming

Click on 'Activities' at the top-left of the Ubuntu Desktop. Then type 'power' in search bar and click the 'Power' icon to open the Power settings menu. Change 'Blank screen' setting to 'Never' and turn off the 'Dim screen when inactive' switch. Next, click the 'Privacy' tab in the Settings window. Turn off 'Screen Lock'.

Exit the settings menu window.

Delete Browser History/Github Login Keychain

So the customer does not have access to our Github private repository!

Also, empty the "Rubbish Bin" and 'Organize Desktop by Name' for style points.

Test

This system is ready to be used as a Beam Cruncher client. Test the CrunchCam module network connections by opening the Beam Cruncher software from the Desktop and editing the Network Settings within the Crunch Cam client software to add the hostnames of all the connected CrunchCam modules. Then, restart the software and confirm that all CrunchCams are able to connect to this client computer.