Mega system Technologies Inc.
UPSilon2000 on Linux & Mac OSX Help Manual
UPSilon2000 (Linux & Mac OSX) is an intelligent UPS management software that works
on the Linux & Mac OSX terminal console. It can clearly display the real-time status of UPS
input and output voltage, frequency, load, temperature and battery capacity with data and
graphics. The user can monitor the quality of the power supply, and can also remotely
monitor the NetAgent through the network, so that the user can manage the power more
efficiently without the limitation of space. When the utility power is interrupted or the UPS
battery’s capacity is low, The UPSilon2000 can shut down system safely.
This document is the support manual of UPSilon2000 on Linux & Mac OSX System,
including installation, usage and problems.
1：Installation
UPSilon2000 on Linux & Mac OSX has 4 installation files, corresponding to different
operating systems:
1: linux-upsilon-5.5-x86.tar.gz -------------------------------------------- Linux 32-bit system
2: linux-upsilon-5.5-x64.tar.gz -------------------------------------------- Linux 64-bit system
3: darwin-upsilon-5.5-x86.tar.gz------------------------------------------ Mac OSX 32-bit system
4: darwin-upsilon-5.5-x64.tar.gz------------------------------------------ Mac OSX 64-bit system
Take the CentOS Linux release 7.8.2003 (Core) release as an example,
1）： File Installation
First enter the Terminal Console, create the “myapp” directory under the home directory,
copy linux-upsilon-5.5-x64.tar.gz to the directory, and decompress it with tar Figure (1).
1
Mega system Technologies Inc.
Figure (1)
After decompression, enter the directory linux-upsilon-5.5-x64, use “ldd” to check if
dependent libraries is complete (In MacOSX system, use the tool “otool” Refer to Figure
2-1), If “ncurses” and “usb” are missing, use [apt-get install libncurses5_dev] [apt-get install
libusb-dev] to install them. Installation requires root installation permission. If the current
user is a “sudoer”, you can “sudo ./install.linux”, otherwise you need “su” switch to the root
user, as shown in Figure (2) to enter the installation console. Follow the installation script
wizard and press Enter, you can finish file installation Figure (3), the default installation
target path is /etc/upsilon
Note: Source file’s path with spaces may cause the installation to fail.
2
Mega system Technologies Inc.
Figure (2)
Figure (2-1)
3
Mega system Technologies Inc.
Figure (3)
2）： Program Configuration
After the file installation, enter configuration of UPSilon2000. Press the [e] key, the
registration window will pop up Figure (4).
Enter the correct CDKey, Email, and Password, move the cursor to “OK”, press “Enter” to
save and exit.
Figure (4)
4
Mega system Technologies Inc.
Continue to complete the configuration of other parameters. The UPS can be connected
to the communication port by “hid”, “/dev/ttyS0”, and “/dev/ttyS1”. You can also use upsilon
to monitor NetAgent by press [k], Figure (5).
Figure (5)
After the parameter configuration is completed, Press [s] to save, [q] to exit the
configuration Figure (6).
Figure (6)
5
Mega system Technologies Inc.
3): Connect UPS
After configuration finished Figure (7), please connect UPS to USB port of computer, and
ensure that UPS is connected successfully.
Figure (7)
6
Mega system Technologies Inc.
2：Usage
upsilon start --------------- Manually start the upsilon, upsilon is a self-starting daemon
process at boot, and can also be started/stopped manually.
upsilon stop---------------- Stop UPSilon2000 manually.
upsilon config ------------- Configure parameters of UPSilon2000.
upsilon status ------------- Current upsilon status, input and output voltage, battery capacity,
load and other data.
upsilon issue -------------- Send command to UPS manually.
upsilon help---------------- Help document.
upsilon password -------- Retrieve the password, the password will be sent to the
registered mailbox.
upsilon register ----------- Registration or update registration.
Note: A CDKey can only be used on one computer at the same time. When you want to
switch computers, you must submit an electronic Email and Password to re-register for use
under the new system.
7
Mega system Technologies Inc.
3：Question
1）：Dependency Library Missing
Use “ldd” in the directory “/etc/upsilon” to check if dependent libraries are missing. If the
“ncurses” library is missing in Figure (8), you can use [apt-get install libncurses5_dev] to
install “ncurses” library. If it shows that “libtinfo.so.5” is missing after installation, you can
use ln -s can establish a symbolic link to “libtinfo.so.5”, Figure (9).
Figure (8)
Figure (9)
8
Mega system Technologies Inc.
2）Terminal Environment
Run the program on some systems, and the error is displayed: Error opening terminal:
vt100. This error may be caused by a missing dependency library or a terminal
configuration problem. Use “ldd” checks if dependent libraries are missing, and System's
optional terminal environment value, “ls /usr/share/terminfo/”, usually select “xterm” as
variable “TERM”, Figure (10).
Figure (10)
9
Mega system Technologies Inc.
3）Dependency Library Mismatch
On some systems, “libncurses” has been upgraded to version 6.0. We can also manually
create a soft link to version 5.0 of the “ncurses” library using the shell command “ln”. Figure
(11) / (12) / (13)
Figure (11)
10
Mega system Technologies Inc.
Figure (12)
Figure (13)
11
