the documentation is updated 21.3.2017
iRidium Sever for Raspberry Pi - it is a software implementation of iRidium Server. It is launched as a daemon or a console application on Raspberry Pi 2 and Pi 3 controllers.
To use iRidium Server you need a license for iRidium 3
- 15 of control panels
- up to 800 of iRidium Server tags
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.
Installation and Setting up
To install iRidium Server on Raspberry Pi, download and install the required software:
- Download the (*.deb) file of the server for Raspberry Pi
- Download and install the WinSCP software
- Download and install the PuTTY software
Connect and set up Raspberry Pi following instructions from the web site raspberrypi.org.
The device must have Raspbian OS (the operating system officially supported Raspberry Pi system on the base of Debian).
1 Start WinSCP. In the software interface set up:
- File Protocol: SCP
- Host name: the IP-address of Raspberry Pi (to learn the address, input
ifconfigin the pi console)
- Port number: 22
- User name: your login (by default: pi)
- Password: your password (by default: raspberry)
2 Save the settings with the
Save button. Connect to Raspberry by clicking the
Login button. If the connection properties were indicated correctly, you will see the window in the right part of which there is a menu for working with files of your Raspberry:
3 Copy the (*.deb) file which is downloaded by link #1 in the folder
4 Start PuTTY. In the software interface set up:
- Host Name (or IP address): the IP-address of your Raspberry
- Port: 22 (by default)
- Connection Type: SSH
- Saved Session: input the name of the current setting and click Save
- Close window on exit: Only on clean exit
5 In the set up PuTTY click Open to open the console. Input the login and password for connection to the server.
6 If the login and password are input correctly, you will see a message about successful connection to Raspberry
7 Install the package downloaded in Raspberry memory with the help of the command:
sudo dpkg -i /<path_to_package>/<packet_name>.deb
sudo dpkg -i /home/pi/iridiumserver_1.0.0-5934_PI.deb
you can set the static IP address for your Raspberry via Putty, using this instruction
Wait until the installation is finished. Do not switch off the device. As a result you will see:
After the installation the server is launched as a daemon - no information about its work will be output in the PuTTY log. At reload of Raspberry the server will start automatically.
You can click the Search button in Transfer and upload a project and license on it.
If Search does not work or you do not see the message about the launch:
Check the availability of the iridiumserver forlder: go to the root catalog with the help of the
Then input the
ls command to see the catalog
Go to the iridiumserver folder with the help of the
cd /iridiumserver command and input
ls again to make sure you are in the right catalog
8 Launch the server from the iridiumserver catalog. There are the following commands for that:
sudo ./iridium- to launch the server. When closing the console, the server will close too
sudo ./iridium hide- to launch the server in the background mode (as a daemon). When closing the console, the server will not close
The successful server launch:
Error: it can occur when trying to launch the server in the background mode again:
In case of such error input the command:
sudo rm /tmp/irdaemon.pid
and repeat the server launch (8).
9 Open the server settings: in order to do that follow the link in the browser
<host> - the local Raspberry IP-address
10 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).
Project Development and Launch
When the server is installed, you can start developing its configuration and logic:
You have to upload the ready project to iRidium Server: