This page is a
translated version of the page
IRidium Server Raspberry and the translation is 100% complete.
iRidium server RPi
Installation and launch of iRidium server on the Raspberry hardware platform
the documentation is updated 21.4.2023
iRidium server RPi - software realization of iRidium server that is launched as a daemon or a console app on Raspberry Pi 3 model B and B+ , Raspberry Pi 4 model B controllers. For each model we have prepared an image. You can find instructions for each models below:
Technical specifications:
Recommended load:
- 15 of control panels
- up to 3000 tags of iRidium server (recommended number of tags is up to 5000 tags).
Warranty period: 12 months.
iRidium server connects to equipment and sends commands from control panels to it. The control panels connect to the server to control equipment through it, get feedback, download logs and databases.
The database can store information about server work for the time since the server was launched. The control panels can output logs from the database and build graphs of changes in server variables.
Installing and Setting Raspbian Buster Lite
This image of the system is meant for Raspberry 3 Model B+ and Raspberry 4 Model B servers. We do not recommend using this image on Raspberry 3 Pi Model B.
Prepare the following equipment:
- Raspberry Pi 3 B+/Raspberry Pi 4 B;
- MicroSD card, class 10, 8 GB;
- Power supply with 5 V/2 А MicroUSB output (for Raspberry Pi 3 B+) or with 5 В/3 А USB-С USB output (for Raspberry Pi 4 B);;
- PC with Windows OS with a card reader and an Ethernet-port;
- Ethernet-router with a turned on DHCP-server;
- Internet access (optional).
1Download Raspbian Buster Lite image that includes iRidium server.
2 Record the image on the memory card using a card reader and Win32 Disk Imager or balenaEtcher.
It's necessary to use MicroSD card, class 10 for no less than 8 GB.
3 Insert the memory card to Rapberry Pi and connect power supply via MicroUSB.
4 Connect Raspberry Pi, a PC and a router into one LAN-network. Network settings are defined automatically in the installed image. DHCP-server must be activated on the router.
In case you have no router, connect a PC to Raspberry Pi directly. To do it, install and launch on a PC any software DHCP-server, for example:
- Open DHCP Server;
- TFTPD32.
5 Define the IP-address of Rapberry Pi with the help of Advanced Port Scanner.
6 Connect to the device via the IP-address, defined earlier (see 5 ) with the help of Putty or enter via the Web-interface. The device is ready for work.
- Host Name (or IP address): the IP-address of the device defined earlier
- Port: 22 (always)
- Connection type: SSH (always)
You can also enter via Web-interface.
7 Update the server version to the latest one. You'll find a detailed manual in the " Server update" section.
Installation and Setting up Linux Debian Jessie
Recommended for Raspberry 3 Model B hardware.
Download iRidium server for Raspberry Pi
iRidium server works on OS Raspbian Jessie
Authorized partners have to do the following actions to a new Raspberry Pi 3 to upload i3 pro or i3 lite projects to it.
1 Prepare the following equipment:
- MicroSD memory card, 10 class, 8 Gb
- power supply with 5 V/2 А MicroUSB output
- a PC with Windows OS, a card-reader and Ethernet-port
- Ethernet-router with DHCP-server
- Internet access (optional)
2 Download the following software:
- archive with image of Raspbian Jessie Lite OS (Linux Debian Jessie for Raspberry Pi): Raspbian Jessie lite
OS Raspbian Stretch is not supported
3 Unpack the archived image of Raspbian Jessie OS. You'll get a file of .img format.
4 Record Raspbian Jessie image on the memory card using a card-reader and Win32 Disk Imager.
5 Add ssh.txt file (empty file) to the root folder of the card to activate SSH protocol.
Attention! You need to add the ssh.txt file to the root folder before starting RPi for the first time.
6 Insert the memory card to Rapberry Pi and connect power supply via MicroUSB.
Keep the order of actions: first insert a memory card then connect power supply!
7 Connect Raspberry Pi, a PC and a router into a LAN. DHCP-server must be active on the router.
If there is no router, a PC and Raspberry Pi can be connected directly to each other. Install any software DHCP server on a PC and launch it. The following software DHCP servers can be used:
8 Define the IP address of Raspberry with the help of Advanced Port Scanner.
9 Launch Putty and set it this way:
- Host Name (or IP address): the IP-address of the device defined earlier
- Port: 22 (always)
- Connection type: SSH (always)
Click Open
.
10 Update the server version to the latest one. You'll find a detailed manual in the " Server update" section.
Server Update
1 Start Putty, a command line of Linux Debian OS, installed on the server, appears on the screen of a PC. Enter the login (pi) and password (raspberry).
The password is not displayed on the console - it is normal. Press Enter after you enter the password.
2 Upload iRidium server for Raspberry on the device with the following name iridiumserver.deb:
wget -O /home/pi/iridiumserver.deb https://iridi.com/ru/redirects/?go=iRidium_Server_Rapsberry
wget -O /home/pi/iridiumserver.deb https://iridi.com/ru/redirects/?go=iRidium_SERVER_RASPBERRY_LITE
If you can’t download the distributive because of certificate error, add no-check-certificate parameter
wget -O /home/pi/iridiumserver.deb --no-check-certificate https://iridi.com/ru/redirects/?go=iRidium_Server_Rapsberry
wget -O /home/pi/iridiumserver.deb --no-check-certificate https://iridi.com/ru/redirects/?go=iRidium_SERVER_RASPBERRY_LITE
If there is no Internet access, do not do this action and follow the instructions in the "Uploading iRidium server without Internet access" section.
3 Check the contents of the current (/home/pi) folder with the help of the following command:
ls
4 Install iRidium server with the following command:
sudo dpkg -i iridiumserver.deb
5 The device is ready to upload i3 pro or i3 lite project.
Changing password
For security reasons change the default password (raspberry) with the following command:
sudo passwd pi
and enter a new password 2 times.
Deleting project data from server
In case of problems with server work you can delete a project data bases and log-files from the server and then try uploading them again.
1 Delete files.
sudo rm -rf /var/lib/iRidium\ Server/Documents/
2 Reset the device.
sudo reboot
Uploading iRidium server without Internet access
In some cases iRidium server may have to be uploaded to Raspberry Pi without Internet access. Do the following actions.
1 Download:
2 Launch WinSCP. Enter:
- File Protocol: SCP
- Host name: IP-address of the device defined earlier
- Port number: 22
- User name: pi
- Password: raspberry
Click Login
button.
3 Copy iRidium server file(iridiumserver_x.x.x_xxxxx_RPI.deb) from a PC to /home/pi folder of Raspberry Pi.
4 Check the contents of the current (/home/pi) folder with the help of the following command:
ls
5 Install iRidium server with the following command:
sudo dpkg -i iridiumserver_x.x.x_xxxxx_RPI.deb
6 The device is ready to upload i3 pro or i3 lite project.
Test mode
Authorize on the server using the integrator's login and password from the iRidium mobile web site. You cannot use the server without authorization.
Go through all authorization steps to get access to the server settings. Activate the option "Test Mode: ON" in the server settings to use it in the fully functional mode. You can see more information about the use modes in the section Licensing Policy.
With the activated Test Mode you can also test work of cloud projects and upload projects from iRidium Transfer (locally, without iRidium Cloud).
Adding a server to the i3 lite project
You may add the server to the project in two ways:
1 Adding the server during the creation of the project
Launch the i3 lite application and start to create a project. The application will ask you to add a server. You need to agree.
You will see a window with the servers available on the local network. You need to select your server
The application will ask you to enter the activation code using the QR scanner or manually
Now the server is added to the project.
2 Adding a server to the already created project
Open the project and go to the Config
Click the "server" tab and click the "Select Server" button.
You will see a window with the servers available on the local network. You need to select your server. The application will ask you to enter the pin code from the server (pin code is default 2007). After entering the PIN code, the server must be activated by clicking on the corresponding button
Server setting up
When the server is installed, you can start developing its configuration and logic:
Server Projects in iRidium Studio
You have to upload the ready project to iRidium server:
Launch of iRidium server configuration