Page Comparison

SmartServer Pi is available with SmartServer 4.2 and higher.

This section describes how to set up your environment and install the SmartServer Pi software. You can also use the installation instructions (see Installing SmartServer Pi in this section) to update the software to another version. In the case of an update, you do not  need to recreate the /etc/smartserver directory or change the smartserver.ini file. 

...

Perform the following steps to prepare your hardware and operating system:

1. Image your SD card using the instructions provided in the Installing the Raspberry Pi OS for SmartServer Pi section.
   
   
2. Connect to your Raspberry Pi using SSH and login with the default apollo username and password that was set when you imaged your SD card. 
   
   

3. Confirm that the Raspberry Pi has Internet access using the following command from the SSH console:

   Code Block
   $ ping google.com

   
   

4. Use the following command to view the packages with available updates from the SSH console:

   Code Block
   $ sudo apt update

   
   

5. Complete a full upgrade of your Linux installation using the following command:

   Code Block
   $ sudo apt dist-upgrade -y

   
   

6. Clean up the installation files using the following command:

   Code Block
   $ sudo apt autoclean

   
   

7. Reboot your Raspberry Pi for the change to take effect using the following command:

   Code Block
   $ sudo reboot

   
   

...

1. Download the SmartServer Pi image archive file (i.e., SmartServer_SW.tar.gz) to the server. See Current Releases in the SmartServer Release Notes section for download links.
   
   
2. Create a home directory on the Raspberry Pi (e.g., apollo) where the SmartServer Pi image archive will reside.
   
   
3. Use an SCP client to move the SmartServer Pi image archive file to the Raspberry Pi home directory (e.g., apollo). 
   
   

4. Unpack the SmartServer Pi package using the following command from an SSH console. The name of SmartServer Pi image archive will match the name of the file that was moved to the Raspberry Pi.

   Code Block
   $ tar -xzf SmartServer_SW.tar.gz

   This command will unpack the following files:

   smartserver.ini
   SmartServer_SW_VN.NN.NNN.deb, where N.NN.NNN is the version number
   
   

5. Remove the SmartServer Pi image archive using the following command:
   

   Code Block
   $ rm SmartServer_SW.tar.gz

   
   

6. For SmartServer 4.3 Update 1 and prior, edit the smartserver.ini file using the following command. For SmartServer 4.4 and higher, the default CMS username and password is apollo / apollo. 

   Code Block
   $ nano smartserver.ini

   
   Configure the SMARTSERVER_PASSWORD=<your_password> parameter by setting <your_password> to the password you would like to use for the SmartServer Pi CMS apollo user. Use CTRL-O and CTRL-X to save and exit nano.   
   
   Unlike the SmartServer IoT, SmartServer Pi does not provide a mechanism through the Configuration page for synchronizing the Linux apollo user password with the CMS apollo user password. You can keep the passwords synchronized manually by setting <your password> to the same password that you used when you imaged the Raspberry Pi OS. Enhanced Security is enabled by default for SmartServer Pi; therefore, when you first log into the SmartServer Pi CMS, you will be prompted to set a strong password. You can disable Enhanced Security and then reset your SmartServer Pi CMS password.
   
   
   
   

7. Create the /etc/smartserver directory on the host where the SmartServer will run using the following command and move the smartserver.ini  file to the /etc/smartserver directory:

   Code Block
   $ sudo mkdir /etc/smartserver $ sudo mv smartserver.ini /etc/smartserver

   
   

8. Verify Internet connectivity for the Raspberry Pi by pinging google.com in the SSH console. Use CTRL-C to stop pinging. 

   If there is an issue with internet access, then correct the problem as needed.

   Code Block
   $ ping google.com

   
   

9. Install SmartServer Pi using the following command, where N.NN.NNN specifies the release version and <directory> specifies the path where the .deb package resides:

   Code Block
   $ sudo apt install /<directory>/SmartServer_SW_VN.NN.NNN.deb

   
   

   Info
   title Example
   $ sudo apt install /home/apollo/SmartServer_SW_V4.20.016.deb

   The apt command will prompt you to continue.

   
   Allow at least 17 minutes for the SmartServer Pi installation to complete.   You should scroll back in the console output from software install to find the Install code for this SmartServer Pi device.  After reboot, the raspberry Pi will have the host name of smartserver-[install code].local.
   
   

10. If you are using SmartServer Pi 4.3 and higher, then the following message appears prompting you to reboot the server. Enter Y and press RETURN.

    Code Block
    Machine needs to be rebooted to finish the installation. [Y/n]:

    If you are using SmartServer Pi 4.2, then reboot the server using the following command:

    Code Block
    $ sudo reboot

    
    

11. After the server restarts, enter the following command in the SSH console to check the status of running components:

    Code Block
    $ smartserverctl status

    
    

    Code Block
    title smartserverctl status example results
    pi@smartserver-hsbcw69:~ $ smartserverctl status alarm active since Tue 2023-07-18 16:39:59 EDT; 31min ago bacnet inactive chirpstack-bridge inactive chirpstack-gateway inactive chirpstack-postgresql inactive chirpstack-redis inactive cms active since Tue 2023-07-18 16:39:14 EDT; 31min ago core active since Tue 2023-07-18 16:39:54 EDT; 31min ago datapoint-connection-manager active since Tue 2023-07-18 16:39:59 EDT; 31min ago datapoint-controller active since Tue 2023-07-18 16:39:56 EDT; 31min ago datapoint-get active since Tue 2023-07-18 16:39:58 EDT; 31min ago enocean inactive formatter active since Tue 2023-07-18 16:39:57 EDT; 31min ago housekeeper active since Tue 2023-07-18 16:40:00 EDT; 31min ago iap-controller active since Tue 2023-07-18 16:39:58 EDT; 31min ago init active since Tue 2023-07-18 16:39:54 EDT; 31min ago lim active since Tue 2023-07-18 16:39:57 EDT; 31min ago loader active since Tue 2023-07-18 16:39:58 EDT; 31min ago logger active since Tue 2023-07-18 16:39:59 EDT; 31min ago lorawan inactive modbus inactive monitoring active since Tue 2023-07-18 16:39:58 EDT; 31min ago mosquitto active since Tue 2023-07-18 16:39:13 EDT; 31min ago nginx active since Tue 2023-07-18 16:39:59 EDT; 31min ago node-red active since Tue 2023-07-18 16:39:58 EDT; 31min ago opc-ua inactive postgresql active since Tue 2023-07-18 16:39:13 EDT; 31min ago query active since Tue 2023-07-18 16:39:59 EDT; 31min ago redis-server active since Tue 2023-07-18 16:39:13 EDT; 31min ago resource-publisher active since Tue 2023-07-18 16:39:57 EDT; 31min ago scheduler active since Tue 2023-07-18 16:39:58 EDT; 31min ago services active since Tue 2023-07-18 16:39:54 EDT; 31min ago smartserver active since Tue 2023-07-18 16:39:54 EDT; 31min ago storage-manager active since Tue 2023-07-18 16:39:15 EDT; 31min ago

    
    Your Raspberry Pi is now running the SmartServer Pi software.
    
    The hostname in the .local address it will advertise through mDNS includes is now smartserver-<SID>.local.  
    
    

12. If the SmartServer Pi CMS does not display, then manually set UFW to allow port 8443 using the following commands:
    

    Code Block
    sudo ufw enable sudo ufw allow 8443/tcp

    
    

...