How to Install MXview One on LinuxMoxa Technical Support Teamsupport@moxa.com

Contents1Introduction .............................................................................................................. 22

Offline Installation .................................................................................................... 23

Online Installation .................................................................................................... 243.1
Online Installation on Ubuntu 18.04 ............................................................... 2
3.2
Online Installation on Ubuntu 20.04 ............................................................... 3
3.3
Online Installation on Ubuntu 22.04 ............................................................... 4
Uninstalling MXview One in Linux ............................................................................. 5

Copyright © 2024 Moxa Inc.

Released on Jul 30, 2024

About Moxa
Moxa is a leading provider of edge connectivity, industrial computing, and network infrastructure
solutions for enabling connectivity for the Industrial Internet of Things. With 35 years of industry
experience, Moxa has connected more than 82 million devices worldwide and has a distribution andservice network that reaches customers in more than 80 countries. Moxa delivers lasting businessvalue by empowering industry with reliable networks and sincere service for industrial
communications infrastructures. Information about Moxa’s solutions is available at www.moxa.com.
How to Contact Moxa
Tel:
Fax:

1-714-528-6777
1-714-528-6778

Moxa Tech Note

1MXview One Linux Installation GuideIntroduction
There are two ways to install MXview One on systems running Linux Ubuntu: offline andonline installation.
We recommend installing MXview One using the offline method first to avoid any
compatibility issues. If you are unable to activate MXview One using the online installation
method, install the software using the offline method.

2Offline Installation
To perform an offline installation of MXview One on systems running Linux, do thefollowing:
1. Put the following MXview One files in the “~” directory.
 MXview_One_Linux_Vx.x.x_xxxxxxxx.deb
 installer.sh mxview-one-deps_xxx.deb
2. Execute the following command to start the installation process:#sudo OFFLINE_DEP=mxview-one-deps_xxx.deb ./installer.sh
MXview_One_Linux_Vx.x.x_xxxxxxxx.deb

3

Online Installation
MXview One can be installed on Linux systems using the online method. Steps varydepending on the version of Ubuntu used.

3.1

Online Installation on Ubuntu 18.04
To perform an online installation of MXview One on systems running Linux Ubuntu 18.04,
do the following:
1. Put the following MXview One files in the “~” directory.
 MXview_One_Linux_Vx.x.x_xxxxxxxx.deb
2. Install the database package:# sudo apt install -y curl ca-certificates# sudo install -d /usr/share/postgresql-common/pgdg# sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc --failhttps://www.postgresql.org/media/keys/ACCC4CF8.asc# sudo sh -c 'echo "deb[signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc]
https://apt-archive.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" >/etc/apt/sources.list.d/pgdg.list'

Copyright © 2024 Moxa Inc.

Page 2 of 5

Moxa Tech NoteMXview One Linux Installation Guide# sudo apt update -y# sudo apt install -y postgresql-15
3. Install the environment that runs Node.js:# sudo apt install -y curl
# cd ~# curl -sL https://deb.nodesource.com/setup_16.x | sudo bash # sudo apt install -y nodejs
4. Install the MQTT communication software package:# sudo add-apt-repository -y ppa:mosquitto-dev/mosquitto-ppa# sudo apt install -y mosquitto
5. Install the dependency software for Nginx:# sudo apt install -y make libssl-dev libpcre3-dev zlib1g-dev gcc
6. Install the MXview One Linux software:# cd ~# sudo systemctl stop postgresql# sudo dpkg -i ./MXview_One_Linux_Vx.x.x_xxxxxxxx.deb
7. Configure MXview One as a system service and restart Linux:# sudo /usr/mxview/mxview-control-panel/MXControlPanel service --action activate# sudo reboot now
8. After restarting, open a web browser and navigate to https://[host IP address].
The host IP address is the IP of the computer running MXview One. The default IPaddress is: 127.0.0.1
9. Log in using the default credentials:
 Username: admin
 Password: moxa

3.2

Online Installation on Ubuntu 20.04
To perform an online installation of MXview One on systems running Linux Ubuntu 20.04,
do the following:
1. Put the following MXview One files in the “~” directory.
 MXview_One_Linux_Vx.x.x_xxxxxxxx.deb
2. Install the database package:# sudo apt install -y curl ca-certificates# sudo install -d /usr/share/postgresql-common/pgdg# sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc --failhttps://www.postgresql.org/media/keys/ACCC4CF8.asc# sudo sh -c 'echo "deb[signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc]

Copyright © 2024 Moxa Inc.

Page 3 of 5

Moxa Tech NoteMXview One Linux Installation Guide

https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" >/etc/apt/sources.list.d/pgdg.list'# sudo apt update -y# sudo apt install -y postgresql-15
3. Install the environment that runs Node.js:# sudo apt install -y curl
# cd ~# curl -sL https://deb.nodesource.com/setup_18.x | sudo bash # sudo apt install -y nodejs
4. Install the MQTT communication software package:# sudo add-apt-repository -y ppa:mosquitto-dev/mosquitto-ppa# sudo apt satisfy -y "mosquitto (>= 2.0)"
5. Install the dependency software for Nginx:# sudo apt install -y make libssl-dev libpcre3-dev zlib1g-dev gcc
6. Install the MXview One Linux software:# cd ~# sudo systemctl stop postgresql# sudo dpkg -i ./MXview_One_Linux_Vx.x.x_xxxxxxxx.deb
7. Configure MXview One as a system service and restart Linux:# sudo /usr/mxview/mxview-control-panel/MXControlPanel service --action activate# sudo reboot now
8. After restarting, open a web browser and navigate to https://[host IP address].
The host IP address is the IP of the computer running MXview One. The default IPaddress is: 127.0.0.1
9. Log in using the default credentials:
 Username: admin
 Password: moxa

3.3

Online Installation on Ubuntu 22.04
To perform an online installation of MXview One on systems running Linux Ubuntu 22.04,
do the following:
1. Put the following MXview One files in the “~” directory.
 MXview_One_Linux_Vx.x.x_xxxxxxxx.deb
2. Install the database package:# sudo apt install -y curl ca-certificates# sudo install -d /usr/share/postgresql-common/pgdg# sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc --failhttps://www.postgresql.org/media/keys/ACCC4CF8.asc

Copyright © 2024 Moxa Inc.

Page 4 of 5

Moxa Tech NoteMXview One Linux Installation Guide# sudo sh -c 'echo "deb[signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc]
https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" >/etc/apt/sources.list.d/pgdg.list'# sudo apt update -y# sudo apt install -y postgresql-15
3. Install the environment that runs Node.js:# sudo apt install -y curl
# cd ~# curl -sL https://deb.nodesource.com/setup_18.x | sudo bash # sudo apt install -y nodejs
4. Install the MQTT communication software package:# sudo apt satisfy -y "mosquitto (>= 2.0)"
5. Install the dependency software for Nginx:# sudo apt install -y make libssl-dev libpcre3-dev zlib1g-dev gcc
6. Install the MXview One Linux software:# cd ~# sudo systemctl stop postgresql# sudo dpkg -i ./MXview_One_Linux_Vx.x.x_xxxxxxxx.deb
7. Configure MXview One as a system service and restart Linux:# sudo /usr/mxview/mxview-control-panel/MXControlPanel service --action activate# sudo reboot now
8. After restarting, open a web browser and navigate to https://[host IP address].
The host IP address is the IP of the computer running MXview One. The default IPaddress is: 127.0.0.1
9. Log in using the default credentials:
 Username: admin
 Password: moxa4Uninstalling MXview One in LinuxTo uninstall MXview One from any version of Linux, do the following:
1. Execute the following command: #sudo apt remove mxview

Copyright © 2024 Moxa Inc.

Page 5 of 5