activemq-for-cloud-service

ActiveMQ messaging service installer for linking the security-cam CCTV NVR and cloud service

This is required when you want to access 1 or more security-cam NVRs through the ActiveMQ version of the Cloud Server. It is not required for direct access to the NVR

Note that this is experimental and has so far been found to be less performant than the original version where the NVRs make a direct socket connection to the Cloud server.

Overview

• Creates an installer (deb file) for ActiveMQ configured for ssl and authenticated access.

• SSL certificate and relevant ActiveMQ config files in deb-file-creation/conf.

  • if you want to update the broker certificate, see the ActiveMQ documentation. Note that the client truststores (client.ts) on both the security-cam NVRs and the Cloud server will have to be updated to include the new broker_cert..
  • To change the authentication credentials for ActiveMQ, see this document. The application.]yml files on both the NVRs and on the Cloud Service will need the mqUser and mqPassword parameters changes accordingly to bew able to authenticate on ActiveMQ.

• ActiveMQ can be run on the same device as the Cloud server or separately. In either case, you must ensure that mqURL on the Cloud server and all relevant NVRs are set to include the correct hostname or IP address.

Build the installer

• from the project home directory (activemq-for-cloud-service), run ./gradlew buildDebFile. The deb file will be created at the sub directory deb-file-creation. As supplied, this is set for installation on an arm84 Ubuntu 23.10 platform.

Install ActiveMQ

• Copy the .deb file created by the build to the target machine. The default build is for a Raspberry pi 4 or 5 running Ubuntu 23.10
• Install with the following command: -

  sudo apt install ./activemq-for-cloud-service_/[version]_arm64.deb
  
  # Where [version] is the relevant version part of the .deb file name.

• If this is the first installation, a user name and password will be shown towards the end of the installation text. This is a randomly generated password that the NVR and Cloud server must use to connect to ActiveMQ.

  Example: -
  
  ActiveMQ user: cloud
  ActiveMQ password: ueCqt4hxvdRZ5qnx2p0g
  

The credentials generated on initial installation should be noted as they will be required on the Cloud server and any NVRs which are to be accessed through the Cloud server.