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

Mail

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

FROM=report@elmax.com // 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 "~"