How To - eeeUbuntu 8.04 - Elmax Main Page
1. eee Environment o Ubuntu o Get Started
2. Elmax Control Center o Main Window o Lamp Configuration Window o Setup Window o Advanced Line View o Simple Line View o Show Log Files o Show Error Lamps o Advanced INI FILE Modifications
3. Web Administration 4. User / Group / Password Policies
o User o Passwords
5. Location of key Programs 6. Terminal
o Basic Shell Commands o Web Server o Closing Elmax
7. VNC Remote Desktop o Set up VNC remote desktop on EEE-server o connecting to VNC remote desktop
8. FAQ (Frequently Asked Questions) o How to connect to EEE-server with SSH o Getting EEE-server's IP address o USB link to COM o How to kill processes o Using CSV File Format
eee Environment1. Ubuntu 2. Get Started
Ubuntu
eee's operating system is modified Ubuntu called eeeUbuntu (version 8.04), continue reading about Ubuntu:
eeeUbuntu wiki http://www.ubuntu-eee.com/
Ubuntu is a community developed, Linux-based operating system that is perfect for laptops, desktops and servers. It contains all the applications you need - a web browser, document and spreadsheet software and much more.
Ubuntu Home Page http://www.ubuntu.com/Ubuntu Documentation (official) https://help.ubuntu.com/What is Ubuntu? http://www.ubuntu.com/products/whatisubuntu
Get Started
Press the Power button, you will see the booting procedure, after which the EEE-server will start the GUI (graphical user interface), the default's X-window manager in this distribution is called GNOME
After you'll see this window, the Elmax controller should autostart:
to see whether the web server is working start your default Web Browser, (eee-servers's default browser is Mozilla Firefox - on the top panel a circular icon with a red fox represents this application) and type into the address bar:
http://localhost/
or from another computer:
http://EEE-IP-ADDRESS/
Elmax Control Center - Main Window Window Areas
As you have already noticed, the Elmax Control Center Main Window after startup look like this:
1) Main Menu File -> Lamp Configuration / Setup / Exit
Action ->
Write Remark To Log Short Test on All Lamps Long Test on defined Group of Lamps Turn ON Alarm Mode Turn OFF Alarm Mode Unlock Administrator Section Lock Administrator Section
View ->
Show Line 1 2 3 4 Show Simple Line View Show Log Files Show Lamps With Errors
Help -> About
2) Tool Bar
Setup Lamp Configuration Show Log Files Write Remark To Log Show Simple Line View Show Lamps with Errors Turn Alarm ON Turn Alarm OFF Short Test on All Lamps Long Test on defined Group of Lamps Enter Maintenance Mode Leave Maintenance Mode Unlock Administrator Section Lock Administrator Section
3) Main View
Line: Line 1 Line 2 Line 3 Line 4
This is the larges area in Main Window of ECC, after clicking on each line, a new window called Advanced View pops up for each Line ( 1 - 4 ) with further information for each configured lamp
4) Communication Status
Processing Line - actual line which is being processed Processing Lamp - actual lamp which is being processed Com Port - configured communication port External Alarm Input State - state of the external (hardware) alarm controller ( on / off / error ) Alarm Send Info - communication status of sending alarm state every (approximately) 8 seconds
5) Test / Mail / User Information
Last Short Test - Date and Time of last global short test of all Lamps Last Long Test - Date and Time of last long test on specified group ( user / automatic ) Planned Long Test - if Automatic Tests is on, displays Date and Time of next Automatic Long Test Mail Information - displays status of mail communication ( disconnected / sending / failure ) Admin Section - user state ( Unlocked / Locked )
User Information - User ID Number / time remaining ( automatically logs off after 5 minutes )
Lamp ConfigurationLamp Configuration Window:
Main Menu
File :
Open - Open Lamp Configuration File *.csv Save As - Save As Actual Lamp Configuration Window to specified File *.csvClose - Close Lamp Configuration Window
Edit :
Undo - Take back last StepRedo - Redo the last Step Find - Find in Lamp Configuration tableInsert Line - insert line after selected row of the TableDelete Selected Lines - delete selected rows of Table ( to select more rows, click on row, hold down SHIFT and press DOWN as many times as you want Fill Selected Cells in Column with .. - prompts user to fill in Edit Box, which contents will fill cells of selected rows
Lamps :
Search All Lamps - clears Lamp Configuration table ( prompts the user to back up ) and a wizard to search lamps is executedSearch Remaining Lamps - a wizart is executed to find only lamps not found / configured in Lamp Configuration Table Send MT Flag to All Lamps (Update) - Updates all Lamps with Selected MT StatusReset Life / Burns Counter for Selected Lamps - Reset Life / Burns counters only for selected lampsBulk Reset Life / Burns Counters - user is prompted to enter minimum value of burns, to reset lamps with at least this value Switch All Lamps to Physical Addresses - Sends a command for all lamps found in Lamp Configuration Table to switch to Physical Address ( after this, lamp is able to communicate )Swich All Lamps to Virtual Addresses - Sends a command for all lamps to switch to Virtual Address ( warning ! in this mode, lamp is not able to communicate )
Local Menu
Send MT flag to Selected Lamps - Update MT of selected LampsReset Life / Burns for Selected Lamps - Reset Life / Burns counters only for Selected LampsReplace Lamp - execute wizard for replacing lamp (unplug old lamp, plug new lamp, press hardware reset, wait until app finds the lamp
Select Picture File - Dialog to select picture fileShow Picture and Set Position - Dialog to show all lamps configured for selected picture and set position of selected lampAdd Remark - Add Remark to selected Lamp
Undo - Take back last StepRedo - Redo the last Step
Find - Find in Lamp Configuration table
Insert Line - insert line after selected row of the TableDelete Selected Lines - delete selected rows of Table ( to select more rows, click on row, hold down SHIFT and press DOWN as many times as you want Fill Selected Cells in Column with .. - prompts user to fill in Edit Box, which contents will fill cells of selected rows
Editing Features
After a New Row is inserted you can fill in these values :
Addr - Physical Address -> 6 digit address, contains these characters : 0,1,2..9 , A,B,C,D,E Name - Lamp Name -> edit value at your willLine - Numbers of 1, 2, 3, 4MT - Main Time Mode ON / OFF ( lamp tube always on / off ) Picture - Picture File, if you know exact name, just type in, if you don't know, press right mouse button and select "Select Picture File"
NOTE: To upload pictures, copy them to /usr/local/elmax/pictures directory
Remarks
right click -> Add Remark | Tool Bar -> Add / modify Remark:
Escape / OK button will popup a save prompt
Lamp Position on Schematic
To set a new position for actual lamp, left click into the window, to view information, move mouse towards the lamp circle, a hint will popup about simple information
Setup Window1. General 2. Lamp Control 3. Tests 4. Sounds 5. Mail 6. SNMP 7. Identifying SNMP traps 8. Receive SNMP message traps
General
ComPort - on windows platform, install ftdi-driver, on eee-linux, leave default settings Number of Lamps ... - if Number of Lamps with Errors exceed this limit, a warning dialog is shown, if mailing enabled, a mail is sent, a log event is executed Minimize to Tray Bar - not fully functional on EEE-Ubuntu
Change Password - only for user with ID number 0000 (administrator)
Default password is 45640811
Lamp Control
Lamp Period - pause between PC -- LAMP requestFind Lamp Period - pause when finding lamps between PC -- LAMP requestNumber of repeated requests - number of requests, when lamp does not respond
Tests
Short Test Time - Duration of Short Test in secondsLong Test Time - Duration of Long Test in minutesPerform automatic long test ( on / off ) - allow executing automatic long testAutomatic Long Test on Hour - Performs automatic long test on specified hour (24h Time Format)Period in Days - Time between each automatic test in days
Sounds
Program Sounds - on / off sounds
Send Error information by Mail - Turns on / off sending error mailsHost - smtp mail serverPort - port of smtp mail serverUser ID - user ID for smtp mail server ( usually 0 )Name - mail nameFrom - virtual mail addressSubject - subject of error mailResend after - if number of errors is still high, resends mail after 'minutes'To - mail addressCC - carbon copyBCC - blind carbon copy
SNMP
Local Settings IP Address: - type in ip address of EEE-PC Device Name: - name of EEE device, to be identified as in the SNMP trap message Device Location: - helps to recognize server's location (Wing A, South Corridor, etc.) Remote Settings IP Address: - type in ip address of machine with trap receiver, to receive SNMP trap messages sent by EEE - Elmax Control Center Community Name: - is the group that devices and management stations running SNMP belong to, it helps define where information is sent the default setting for Community name is public
Identifying SNMP traps
The core of the message is the id code of Event executed on Elmax (011 - Lamp CFG EDIT, 021 - Setup file elmax.ini SAVED, etc.. ) Elmax also sends KEEP-ALIVE messages with id = 254 every hour )
Receive SNMP message traps
Note, that default windows firewall does not allow SNMP traffic, fastest solution to getting SNMP trap receiver work, is to disable this firewall (or add an Exception for port 162)
Messages are sent to Remote IP Address, which can be set in Setup Window. Many trap receiver applications are available, one of the most known is Trap Receiver, which can be found and downloaded at:
http://trapreceiver.com/
Warning: trap receiver has to be executed on another machine (not EEE-PC with Elmax Control Center)
Advanced Line View
In this view, you can view all lamp's parameters and perform tests on selected lamps, view Picture information (if set) and display remark information
If you want to perform tests on selected lamps, you have to log in in the main Window, to select more lamps, hold down left mouse button and select lamps by moving the mouse along the ADDRESS column
Simple Line View
Read the legend to learn color and shape meanings
To show detailed information on lamp, click on the Lamp Mark (circle / square), a hint will popup
Show Log FilesLogs are stored in /usr/local/elmax/www/web/log/.. with a format of YYYY-MM.txt Each month is stored into one text file, for easier searching actions.
After clicking "Show Log Files" a new window will pop showing actual month
Filters
After enabling checkbox called "Filter" you are able to proccess log files by actions and user IDs specifically
Note! When filters enabled, program searches all actions from selected year and month until now. Note! The "ALL" option in year drop down menu is accessible only with Filter enabled.
Show Error Lamps
This Window shows lamps with at least 1 error, also displays type of error in hint.
Elmax Control Center - INI FileElmax ini file is located at:
/usr/local/elmax/elmax.ini You can directly modify its contents by opening file browser or in terminal, by nano /usr/local/elmax/elmax.ini
to exit nano press CTRL + X to save changes press "y", then "ENTER", discard is performed by typing "no"
Structure of INI file:
[GLOBAL]
DEBUG=0 // debug mode, if DEBUG=1 Elmax will not communicate with lamps, // but will make up, own random values for testing COMPORT=1 // specifies comport connection, default is 1 // changing not reccomended LAMP_PERIOD=200 // time in miliseconds, in which // Elmax waits for Lamp respond FIND_LAMP_PERIOD=200 // time in miliseconds, in which Elmax waits // for Lamp respond while SEARCHING NEW LAMPS LAMP_REQUEST_NUMBER=1 // number of times, which will Elmax repeatingly // communicate with lamp, when not responding TRAY=0 // show elmax tray icon, works well in MS windows // but sometimes collides in ubuntu, default off SOUNDS=1 // application sounds on / off
MINERRLAMPS=1000 // minimum lamps with errors to trigger // a special error event PASS=****** // encrypted password, do not change
LOGS=1 // saving logs to local drive, viewable also in web interface
SDLOG="Z:/media/disk/elmax.log" // special logging into sdcard, writes data about // all lamps after finishing each cycle // if you don't want to have this type of log, just // comment out this line, by putting ; // in the beginning of the line like next line explains // ; SDLOG="Z:/media/disk/elmax.log"
[MAIL]
ON=0 // mailing on / off (1 / 0)
HOST= // specify SMTP server for email sending
PORT=0 // server port
USERID=0 // user id to log in into the server
INTERVAL=1 // interval of error mail sending in minutes
NAME=ELMAX // email name
[email protected] // email FROM data, which will show // when an email is received from Elmax SUBJECT= // subject of email
TO= // email address of receiver
CC= // email address - Carbon Copy
BCC= // email address - Blind Carbon Copy
LASTMAIL= // time and date of last mail sending event
[TESTS]
STIME=20 // short test time in seconds
SLASTTIME=29. 12. 1899 // last short test
LENABLED=1 // automatic long tests on = 1, off = 0
LTIME=30 // long test time in minutes
LHOUR=3 // define hour [24h format] when automatic test is executed
LPERIOD=1 // define long test period in days, to reexecute test // on next group of days LLASTGROUP=3 // last tested group
LLASTTIME=24. 10. 2008 9:48:35 // last long test executed
LNEXTTIME=25. 10. 2008 3:00:00 // next planned long test
[SNMP]
ENABLED=1 // SNMP trap messages on = 1, off = 0
LOCALIP=30.29.28.27 // local ip address to correctly identify in network
LOCALNAME=EEEPC1 // name of eee-pc, to send with trap message
LOCATION=Building1 // location, to send with trap message
REMOTEIP=192.168.0.4 // ip address, to which will be trap message sent
COMMUNITY=public // is the group that devices and management stations // running SNMP belong to, it helps define where information is sent, the default setting for Community name is public
Web Administration - for Admin PHP My Admin (PMA)
PMA is a MySQL database backend to manage databases, users, etc..
Logging In
first, you need to log in, open your WEB Browser and type http://eee-ip-address/phpmyadmin.. Getting EEE-server's IP address
You will see a login screen:
Please note, that this tutorial is for English (utf-8) language, therefore keep in mind, that Function Names may be different from your local settings (you can always select English utf-8 in this main login window)
Login Data:
Username: root Password: 123456 (default password, you should change it to something more secure)
Successful Login
Changing global password for ROOT user
after successful login click PRIVILEGES:
click on the "user/pen" icon to modify login data,
!! DO NOT MODIFY THE ELMAX-USER, IT IS USED FOR WEB - DATABASE CONNECTION !!
Scroll down to the THIRD TABLE whith "Change Password" title
Type and Retype new password, Click GO
!!! You should change passwords for both ROOT users (linux and localhost) !!!
Adding New User
Select the "ELMAX_DB" database in the left of the screen
Select the "USERS" table:
Select the "INSERT" function from the upper center:
Type in Username and new Password:
(there is already one USER in the database => (user_id = john / password = smith)
!!! Don't forget to select PASSWORD FUNCTION TO "MD5", passwords will be crypted for security reasons !!! Click "GO" Now you have a new user, with User Name "john" and Password "smith" (will work only in ELMAX WEB, not in the Elmax Control Center Application)
Removing User
follow previous instructions LOG IN -> select ELMAX_DB database-> select USERS table
select BROWSE:
you will see a list of users, UserName / crypted Password
to remove a user, click the Red Cross and click OK:
Editing User Login Data
follow previous instructions LOG IN -> select ELMAX_DB database-> select USERS table -> select BROWSE
Click the PEN image for editing a user:
An edit dialog will pop up ( similar to the dialog when adding new user ):
change values at will !!! NOTE, that when you don't want to change PASSWORD, leave "PASSWORD FUNCTION" empty (when changing password, select the MD5 function !!! Click GO
You have just edited user login data
User / Group / Password Policies1. User 2. Passwords
User
default users in eee-server are:
secadmin ora root
secadmin this is default user, whom is logged automatically after the eee-server is started
ora this user is created for maintaining the system by creator
root super user, can create, modify, delete system files (another users don't have access to such things)
Passwords
default passwords for these users are:
secadmin: 45640811 ora: 123456 root: 123456
We strongly recommend to change these passwords, because they are defaults, on every eee-machine Changing passwords: - you can change passwords using GUI or text-based Terminal
Terminal password change
If you would like to change password for the current user (secadmin by default), please type into the Terminal:
passwd
and follow shell insctructions
if you would like to change password for another user, you have to have super user privileges:
sudo su passwd [user-name = secadmin / ora / root] exit
GUI-based password change
CLICK -- UNLOCK --
TYPE PASSWORD FOR "SECADMIN" USER AND CLICK -- AUTHENTICATE --
NOW YOU CAN CHOOSE USER AND CLICK PROPERTIES
TYPE NEW PASSWORD AND CLICK -- OK -- DONE
Location of Programs Elmax controller located at:
/usr/local/elmax/elmax.exe
Elmax Plan (Schematic) Image Directory
/usr/local/elmax/pictures
Elmax local website:
/usr/local/elmax/www
script for Elmax check (executed at start-up)
/bin/elmax-check
Elmax shutdown script (closes Elmax application)
/bin/elmax-kill
some files are generated and stored to temporary disk: (will be deleted on reboot)
/dev/shm
TerminalTerminal is a text-based application, which allows running scripts, file managing, changing file, user, group policies.
to start Terminal: press CTRL + ALT + T or press ALT + F2 then type gnome-terminal or from the Menu bar choose
Terminal (console) window looks like this sreenshot:
Basic shell commands you can browse throught previous commands with up / down
arrows, left and right keys are for moving the cursor along the line to automatically fill your already half-typed command / path press tab if you accidentally misuse some terminal program and you would like to close it, try pressing q or ctrl + c
cd DIRECTORY - changes the current working directory to the typed one, .. will bring you one directory up in the structure
ls -al - prints summary of the current working directory, switch a shows hidden files and switch l shows details
pwd - print working directory mkdir -p DIRECTORY - creates new directory, switch p creates all
directories of upper level, if they do not exist in the structure pwd - print working directory rmdir DIRECTORY - removes directory cp SOURCE TARGET - copy source to target, parameters are files or
directories mv SOURCE TARGET - move source to target, parameters are files or
directories cat FILE - print content of file (or files, separated by spaces) chmod MODE TARGET - sets attributes of target (files or directories) chown USER TARGET -R - sets owner of target (files or directiories),
switch R means recursively chgrp USER TARGET -R - sets group of target (files or directiories),
switch R means recursively ps aux - shows running processes, switch a shows foreign processes,
switch u shows names of users, switch x shows processes with no terminal assigned to them (daemons)
pidof PROGRAM - prints PID of a program top / htop - system manager, htop with color kill -9 [pid] - kills a process with [pid] killall -9 NAME - kills all processes with name dmesg - prints messages of kernel ln -s SOURCE TARGET - creates symbolic link mount DEVICE DIRECTORY - mounts an external device to specified
directory umount DEVICE or DIRECTORY - unmounts device sudo su - log as SUPER USER shutdown -P now - shutdowns computer reboot ssh USER@COMPUTER - SSH client, connects to specified PC grep -v WHAT - takes whole output and prints lines with identifier
what found in them find FROMDIRECTORY -name FILE - finds all files in directory with name
FILE
df -h - prints information about mounted partitions
Web Server web server is located at: /opt/lampp
it is started automatically on system boot to restart the server start Terminal and type:
sudo /opt/lampp/lampp restart
shutdown:
sudo /opt/lampp/lampp stop
start:
sudo /opt/lampp/lampp start
Closing Elmax the fastest way to close Elmax is to go to main menu bar in the
bottom of the screen:
or press
ALT + F2
and then type
elmax-kill
Note, that classic program termination by clicking the Cross in the upper right corner will close application only for a short time (the process elmax-check will restore it within 5 minutes)
or open Terminal (by pressing ALT + F2 and typing gnome-terminal or Applications -> Accessories -> Terminal)
type:
elmax-kill
This will kill all ELMAX processes, comprising elmax-check and elmax.exe
IF you want to be sure, that all elmax processes were killed, type:
ps ax | grep -v grep | grep elmax
IF you get no output, there is no elmax process running
IF you get output similar to this:
[pid] 6220 ? S 0:00 /bin/sh /bin/elmax-check6250 ? S 0:00 /bin/sh /bin/elmax-check6251 ? S 0:45 /usr/local/elmax/elmax.exe
then login as root:
sudo su
type as many times as you get lines (varying the PID number):
kill -9 [pid] (first number from each line)
Exit super-user mode by:
exit or by pressing ctrl + d
VNC remote desktop1. Set up VNC remote desktop on EEE-server 2. connecting to VNC remote desktop
Set up VNC remote desktop on EEE-server
to get VNC remote desktop working start Remote Desktop Application by:
Then set your options like following screen image:
You can type any password you like, when connecting to Remote Desktop, you will be prompted to type this password (most preferably type password for secadmin user)
connecting to VNC remote desktop
You will need a program to get access to VNC remote desktop running on your eee-server, to get some free applications, try these:
Ultra VNC viewer DOWNLOAD site http://www.uvnc.com/download/index.htmlTight VNC viewer DOWNLOAD site http://www.tightvnc.com/download.htmlReal VNC DOWNLOAD site http://www.realvnc.com/
When you run a client application, you will be prompted to type: 1) ip address of eee-server 2) password
FAQ1. How to connect to EEE-server with SSH 2. Getting EEE-server's IP address 3. USB link to COM 4. How to kill processes
How to connect to EEE-server with SSH
First, you will need a program to get your PC connected to the eee-server
Windows programs:
Putty DOWNLOAD site: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
mRemote DOWNLOAD site: http://www.mremote.org/wiki/Default.aspx?Page=Downloads&AspxAutoDetectCookieSupport=1
WinSCP DOWNLOAD site : http://winscp.net/eng/index.php
or a great Total Commander plugin for file management using SSH:
SFTP plugin DOWNLOAD site http://developer.berlios.de/projects/sftp4tc/
then open program and find text area where you will type eee-server's IP address, when prompted to enter port, type 22, username is secadmin and your password
Linux programs: - you don't need any 3rd party applications, simply open Terminal and type:
ssh USER@EEE-IP-ADDRESS where USER = secadmin EEE-IP-ADDRESS = ip address of EEE-server
you will be prompted to type password
Getting eee-server's ip-address:
right click on network in the top right of the screen and click Connection Information eee-server's ip address are those four number delimited with a dot in the line calles IPPAddress
USB link to COM
The Elmax applications works with serial port, but on the machine there is none, so to bypass this complications you have to link the serial port to the USB device, to do so, follow these instructions: Open Terminal and simply write:
sudo su
this command will log you in as administrator you will be prompted to type password (45640811 -- this is default password, if you have changed it, type your new password) In case, that COM1 in Elmax Application is coloured red, try linking the COM device to /home/secadmin: (as root)
ln -sb /dev/ttyUSB0 /home/secadmin/.wine/dosdevices/com1 ln -sb /dev/ttyUSB0 /home/secadmin/.wine/dosdevices/COM1
How to kill processes
processes started by "user" can only be killed by the same user with there is one exception, when the user is logged in as root (not Sec
Admin), he has the power to terminate even processes started by other users
kill -9 [pid-number] killall [process-name]
You can get the [pid] with (it is the first number in line):
ps ax | grep -v grep | grep [process-name]
or type pidof ProgramName
when you cannot kill a process and terminating it is essential, try becoming root (super-user privileges) and then terminate the process
sudo su kill -9 [pid] / killall [process-name] exit
the exit command stands for exiting the super user mode (root)
to kill ELMAX type into the terminal as SECADMIN user:
elmax-kill
if errors occured, try becoming root (super user privileges) and then killing ELMAX:
sudo su elmax-kill exit
Using CSV File Format Some random lines from already set lampcfg.csv: Addr,Name,Line,MT,Picture,PosX,PosY,Remark7A0011,Lamp 2,1,0,pic1.jpg,461,138,""7A0012,Lamp 4,1,0,pic1.jpg,155,290,"remark for lamp 4"7A0013,Lamp 4,1,0,pic2.jpg,386,115,""7A0014,Lamp 1,1,0,pic2.jpg,75,223,"reset 21.11.2008~local inspection"7A0015,Lamp 2,1,0,pic2.jpg,128,336,""7A0016,Lamp 123,1,0,pic2.jpg,350,222,""7B0001,Lamp 0,2,1,"","","",""
As you can see, values are delimited by commas (CSV -> Comma Separated Values)
Empty values, or remark strings are enclosed in double quotes "", remark strings, which contain New Line (Enter / Carriage Return) mark are exchanged for ~ (file readibility issues)
Warning! Don't use Microsoft Word for any file manipulation (it doesn't respect the CSV format, and causes readibility issues)
You can always use the default installed table editor - GNumeric or text applicationGedit, just follow these simple guidelines:
first line must start with column definitions (Addr,Name,Line,MT,Picture,PosX,PosY,Remark) values are separated by comma "," and strings whith spaces - like Remarks, must be enclosed in double quotes "", NewLine symbol in remarks is represented by Tilde "~"
Top Related