fli4l documentation - Client/Server interface imond

8.2 Windows client imonc.exe

##### :::[ Introduction ][ Start parameters ]:::
:::pages... [ Summary | Config | Calls | Connections | Fax (facsimile) | EMail | Admin | Error ; Syslog ; Firewall ]:::

#### 8.2.1 Introduction

Development of the Windows client is now in the hands of Nico Wallmeier. (nico@fli4l.de)

From version 1.5 imond (and therefore imonc) uses two user modes: the user and the administrator mode. In the administrator mode all control elements are activated, i.e. it has all the functions of the imonc if the following variables are set in file `config.txt` : IMOND_ENABLE, IMOND_DIAL, IMOND_ROUTE and IMOND_REBOOT set to 'yes'. These configuration variables now control the user mode, i.e. the content of a variable controls availiability of a function. That means: If all these variables are set to 'no', all buttons - except exit mode button and admin mode button are disabled/de-activated. Decisions about usage of user or admin mode depend on the transferred password (IMOND_PASS). Using the admin mode button - which is located in the status line - switches from user to admin mode when the password was entered.

As soon as imonc was started, an additional tray icon will be displayed, which shows the connection status of existing channels.

Colors mean therefore: Red: Offline, Yellow: Dialing, Light green: Online and Traffic on the channel, Dark green: Online and almost no traffic on the channel.

On one hand side there is the opportunity to minimize imonc "the normal way", i.e.: entry in task bar will remain on screen. On the other hand - by using the additional button (the one with a 'dot') besides the minimize button - only the tray icon beneath the clock will remain. A double-click with the left mouse button onto the tray symbol will again move the imonc window to the foreground. Using the right mouse key/button enables the user to select main imonc commands from a context menu - without having imonc in the foreground.

If the explorer may disappear with a "access violation", the tray icon of imonc will disappear, too. If imonc is then restarted, the former instance of imonc will be restored and also the tray icon will be restored.

A lot of properties of imonc (ex.: column width of StringGrids) will be stored in the registry of Windows to be able to configure imonc for individual needs. Imonc will store its properties in the registry key: `HKEY_CURRENT_USER\Software\fli4l`.

In the meantime it is possible to set language of imonc (see Config/General). So we will use the english descriptions in this documentation (and not the german ones :o).

If - after having read the documentation very carefully - there are any problems left concerning imonc or the FLI4L router itself, choose option "system info" in "about page" of imonc and then option "support infos". After having done so the router password will be asked for (not the imond password!). Imonc will now generate a file `fli4lsup.txt`, which will include all important information about the FLI4L router and imonc. This file may be added to the support form on the homepage of FLI4L or maybe posted to the mailing list (if requested). This mximizes chances for fast help.

More details about development of Windows client imonc can be found on the homepage of FLI4L http://www.fli4l.de in area wish list and imonc. In this location you may find information about new features in the next imonc version. Additionally there is download location for the latest imonc version (if it is not already included in the distribution software package).

Those who have more ideas and hints for imonc may use the mailing list (to be found in www.fli4l.de) or may contact - via email - Nico Wallmeier (nico@fli4l.de). We (Nico and I) now cooperate in further development if imonc/imond. Nico will concentrate on the client part, I will concentrate on imond. If more information has to be transferred from imonc, almost each time it will be necessary to expand the communication protocol....and that means: software changes in client AND server software.

##### [ top ]

#### 8.2.2 Start parameters

Client program needs name or IP address of the FLI4L router. By default the software tries to establish a connection to the computer "fli4l". If this computer was correctly inserted in DNS, it just should work from the beginning. Otherwise you may add the follwing parameters to the shortcut:

- /Server:IP or host name of the router (abbreviation: /S:IP or host name)
- /Password:password (abbreviation: /P:Password)
- /log This is the log option for communication between imonc and imond. If this option is enabled, a file `imonc.log` will be written when imonc exits. This file will contain the complete communication between router and client and may therefore be quite large. You should only set this parameter if there are serious problems.
- /iport:port number The port number to which imond looks; default: 5000
- /tport:port number The port number to which telmond looks; default: 5001
- /rc:"Command" The command entered here will be transmitted to the router without any checks. After transmission imonc will be closed/finished. To be sure of correct function, you will have to hand over the imond password (if set). This is because there will be no request for a password. Possible commands are documented with imond, see chapter 8.1. Additionally to the command mentioned in that location there is a command dialtimesync. This command forces the router to dial and it initialzes time synchrinisation.
- /d:"fli4l directory" Using this option enables you to enter the FLI4L directory for startup. Thatīs mostly interesting for those who play around with more than one FLI4L version.
- /wait If the host name cannot be resolved, imonc will no longer exit - re-start connection just by doule-clicking on the tray icon.
- /NoStartCheck This will switch off check for an already running imonc. Thatīs only necessary (and maeks only sense) when there are more than one FLI4L routers in your network to be observed. If there are more than one instances of imonc, built-in syslog and email functions will be de-activated.

Usage (to be entered into the shortcut):

    X:\...\imonc.exe [/Server:host] [/Password:password] [/iport:port number] [/log] [/tport:port number] [/rc:"command"]

Example with IP address:

    C:\wintools\imonc /Server:192.168.6.4

or with name and password:

    C:\wintools\imonc /S:fli4l /P:secret

or with name, password and router command::

    C:\wintools\imonc /S:fli4l /P:secret /rc:"dialmode manual"

##### [ top ]

#### 8.2.3 Page: Summary

The Windows client imonc.exe will ask for some information about the LAN and will display them in a special window. Amongst others there are informations as:

    Local/Remote Date:  Windows/fli4l date and time
    Status:             Calling/Online/Offline
    Name:               Telephone number of partner or circuit name
    Direction:          Shows in display if it is an incoming or an outgoing connection
    IP:                 IP address which was given
    IBytes:             Received bytes
    OBytes:             Bytes sent
    Online-Time:        Actual online time
    Time:               Accumulated online time
    Charge-Time:        Accumulated online time with reference to the charge intervals
    Charge:             Calculated costs

Data will be actualized every two seconds. This interval may be changed (now). In the context menu of this overview you will be able to - for each existing channel with which the router is online right now - copy the actual IP address into the clipboard and to set-up the specified channel explicitely. This may be interesting if there are several different connections; ex.: one for surfing in the internet and another connection to your company and if you then want to disconnect any of these.

If additionally the telmond process is active on your FLI4L router, imonc is able to display information about incoming telephone calls (calling and destination telephone number). The last telephone call will be displayed above the buttons. A protocol of incoming telephone calls may be displayed by using the page Calls.

The above mentioned buttons will enable you to select the following commands:

    1. Dial/Hangup          dial connection/hangup
    2. Add link/Rem link    add/combine channels: yes/no
    3. Reboot               reboot fli4l !
    4. Halt                 correct shut down for fli4l to switch it off safely afterwards
    5. Exit                 end client

Commands 1, 2, 3 and 4 for the user mode may be switched on and off in the configuration file of your FLI4L router. If you did so, the buttons in imonc will be de-activated. In administrator mode all buttons will be de-activated.

Selection Dialmode controls dialing behaviour of the router:

    Auto     Router will automatically establish a connection to the internet if there will be a request from local network
    Manual   User has to establish connection manually
    Off      There is no connection possible, neither manually nor automatically. Dial button is de-activated.

Remark: FLI4L will - by default - dial automatically when you request for a connection to the internet. That means: You should never need to use the dial button...

There is also the option to switch the default route circuit manually; i.e. switch on/off the automatic LC routing. The Windows version of imonc offers the selection list "default route" for this option. Additionally the hangup timeout can be directly configured from imonc. Use the button "config" besides default route. All configured circuits of the router will be displayed there. Value in column hup-timeout may be edited directly in StringGrid for ISDN circuits (not functioning for DSL in the moment).

You may find an overview of LC routing in page TimeTable. There you can see which circuit will be selected at which time automatically.

##### [ top ]

#### 8.2.4 Page: Config

Configuration area can be reached through button Config in the status line. The window which will be opened then is divided into the following areas:

- Area: General:

- Seconds of Refresh: Set actualisation interval for page: Summary.
- Synchronize Time at Startup: Reads and stores time and date of router as local time when client is started. This function may also be called manually with button Synchronize on page: Summary.
- Start Minimized: Starts program minimized. You will only see the icon besides the clock.
- Start imonc together with Windows: You may enter in this field, if client shall be started when Windows is started. In field "Parameter" necessary start parameters may be entered.
- Get news from fli4l.de: Shall any news which are displayed in the news section of the FLI4L homepage be fetched by imonc and displayed automatically? References will then be displayed in the status line. Additionally there will be another page "news" which contains the complete news.
- Log Calls in a File: The file name you may enter here, will be used to store a call list locally in this computer. This menu option will only be visible if configuration variable TELMOND_LOG (see package ISDN) is set to 'yes' . This is also valid for the Calls list.
- Seconds of Refresh: Controls how often page: Summary shall be actualized.
- Log Connections in a File: The same as it is (see above) for Calls; except this time it is for Connections
- TimeOut for Router to respond: How long should we wait for an answer of the router before we suggest that connection is lost?
- Language: Select language for imonc.
- Confirm router commands: If this feature is activated, all commands which affect router operation must be confirmed; ex.: reboot, hangup, etc.
- Automatic Reconnect to router: Shall connection be restored automatically if connection to router has been interrupted (ex.: by reboot of router...)?

- Area: Calls:
  Position of Call Notification window will be stored in registry. That means: Move the window to the position you want it to be displayed. After this setting it will appear in exactly that position.

- Activate Call Notification: Controls signalisation of incoming calls.
- Show Call Notification: Shall there be - when any incoming calls exist - a message window containing: destination MSN, number of caller and date/time ? To get this information, be sure to set - in file `config.txt` the variable OPT_TELMOND (see package ISDN) to 'yes' .

- Seconds of Call Notification: This parameter inluences to the duration of Call Notification window. Entering "0" will not close this window automatically.
- Fontsize: Select font size of/for Call Notification window. This affects size of this window since size of window will be calculated depending on the real size of message.
- Color: Select text color for Call Notification window. I use red to really recognize it.

- Delete first zero: Some telephone machinery adds sometimes an additional zero to the telephone number of the caller. This may be suppressed by using this option.
- Own areacode: Store your own local telephone code here. If there is an incoming call with the same number it will be suppressed in display.

- Sub-area: Phonebook:
  Page: Phonebook contains the phone book which is used for resolving of telephone numbers for incoming calls and for the own MSN. This page will also be displayed when configuration variable TELMOND_LOG was set to 'no', because number resolution is used for the display of the last call on the Summary page. Instead of the phone book a local file on the router may be selected.

Construction of entries is as follows:

    # Format:
    # Telephone number=name to display[, wave file name]
    # 0241123456789=test user
    00=unknown
    508402=Fax
    0241606*=Elsa AG Aachen

The first three lines are comments. The value in the fourth line is used as a default value when there was no telephone number transmitted. The value in the fifth line causes the display of text "Fax" for MSN 508402. In all other cases the format is always: Telephone number=name, which shall be displayed instead of telephone number. The contents of the sixth line demonstrate the definition of a combined telephone number area. The result of this definition is: display of the (in the value) given name for all extensions of this number. Remember that the first entry in the phone book which is valid for the incoming call will be displayed. As an option you may choose a wave file per definition which will be played when there will be an incoming call from this telephone number.

From version 1.5.2 there is now the option to compare/check the local phone book with the routerīs phone book on page: Names. When doing so there will not only be a replacement of files, but also an insertion of missing entries. If there exists a telephine number in both phone books with different names, the user will be asked which entry is valid. The synchronisation of routerīs phone book will only be done in the RAM disk. That means: All changes will be lost after reboot.

- Area: Sound:
  Wave files which are inserted in this area will be played if the specified event occurs.

- Call Notification: The specified wave file will be played if Show Call Notification is activated and there is a new incoming call.
- EMail: The specified wave file will be played if EMailChecker finds emails on one of the given POP3 servers.
- EMail-Error: The specified wave file will be played if there occurs an error during receive of emails.
- Connection Lost: The specified wave file will be played if connection to router is lost (ex.: another client just reboots the router). If option "Automatic Reconnect to router" was not activated, an additional message box will appear. It will be containing the question if there shall be a retry for router connection.
- OnConnect: The secified wave file will be played if router established a connection to the internet.
- OnDisconnect: The specified wave file will be played if router disconnected its connection to the internet.

- Area: EMails

- Accounts: This area is meant for configuration of POP3 accounts.
- Enable Check: EMailChecker shall look automatically for new emails.

- Check every x Min: This option defines a time interval for new email check of EMailChecker.
  Attention: When defining a very short interval, the router may possibly be steady online! This will happen if the EMailCheckIntervall is less than hup-timeout of used circuit.
- TimeOut x Sec: How long should we wait for an answer of a POP3 server? Value "0" means: Do not set a timeout value.
- Check even if router is offline: This option enables the router to dial automatically and look for new emails. Connection will be disconnected after check of all POP3 accounts/mail boxes. To be able to use this feature, Dialmode must be set to 'auto'.
  Attention: This will cause additional costs if no flatrate is used!
  Circuit to use: Use this option to define which circuit shall be used for dialing to email check.
- Load EMail-Header: Shall only email headers be loaded or do you only want to count the number of emails? Loading of email headers is at least necessary if you want to delete emails on the mail server.
- Notify only new e-mails: Shall there be an acoustic message and a tray icon message for new emails?

- Run e-mail client program: The given email client shall be started if there are any new emails.
  Location of e-mail client: Enter the email client which has to be started.
  Param: Enter additional parameters which shall be transferred when email client is started. If Outlook is used as email client (NOT Outlook Express !), enter /recycle as parameter. This will use an already opened instance of outlook if there are any new emails.

- Area: Admin.

- General-Password: Enter router password (in file `config.txt`, parameter PASSWORD eingetragen) to enable local editing and storing of forwarding script `portfw.sh`.
- files on router to view: All files which are entered here and which are existing on the router can be shown on page Admin/Files with a single mouse click. That means: You will be able to display - in a simple way - the log files in imonc.

- Area: LaunchList is used for configuration of launch list. The launch list will be executed after a successful connect, if option "Activate Launchlist" is activated.

- Programs: All programs which are entered in this area will be started automatically if the router established a connection and the launch list is activated.
- Activate Launchlist: Shall launch list be executed after having successfully established a connection ?

- Area: Traffic is used for (personalized) configuration of the TrafficInfo window.
  One user told me there were some errors in displaying data with older DirectX versions.

- Show separate traffic info: Do you want a graphical display of channel usage in a separate window?
  In the context menu of this window you may decide if the window shall get the attribute StayOnTop. This will cause the window to remain above all other windows (in the foreground). This value will be stored in the registry and will therefore be available after a restart of the program.
- Colors: Define colors for the TrafficInfo window. Please keep in mind that DSL channel AND ISDN channel will use the same colors.
- Show Title: Show title bar in TrafficInfo window ? Title bar will show information about the circuit which is actually used by the router.
- Show CPU-Usage in title: Show CPU usage in title bar ?
- Limits: Enter maximum values for transmission rates for DSL - T-Online uses: DSL upload 128000 and DSL download 768000.

- Area: Syslog Is used for configuration of syslog message display.

- Activate Syslog-Client: Display syslog messages in imonc ? This option should be switched off when using an external syslog client - ex.: Kiwiīs Syslog client.
- Show all messages above level: Show syslog messages starting from which priority level ? It makes sense to start at first with debug level to learn which are the interesting messages for oneself. After this you should/may enter the level you need.
- Log Syslog-Messages in a File: Shall displayed syslog messages be stored in a file ? You may select messages in the GroupBox which shall be stored to this file.
- Show portnames: Shall there be a display of descriptions of ports instead of port numbers ?

- Area: Fax is used for configuration of facsimile display of imonc. mgetty must be installed on your router to get a display of this option (to be found as OPT package on FLI4L homepage).

- Log Fax in a File: The file name which you may enter here will be used to store the fax list locally on the computer.
- Refresh-Interval: Enter refresh rate of fax overview page. This value is not entered in seconds. It will be multiplied with the value in "General/Seconds of Refresh" .
- Localdirectory: To be able to display any facsimiles, they have to be stored locally. Enter data here.

##### [ top ]

#### 8.2.5 Page: Calls

Page Calls will only be displayed if configuration variable TELMOND_LOG (see package ISDN) was set to 'yes'. Otherwise there will be NO Calls log. On this page there will be a display of all stored telephone calls which came in during router was running. You may switch between display of locally stored calls and display of calls stored on the router. If you push the reset button during display of stored calls on the router, the routerīs log file will be erased.

In call overview you may - by using the right mouse key on the calling/incoming number or the own MSN - copy this data to the telephone book to add a name to this number or MSN which will be displayed instead.

#### 8.2.6 Page: Connections

Since version 1.4 there is a new display for connections to the internet over the router. This overview will be on page Connections. It will give you a good overview of behaviour of the router during dialing to the internet. To enable displaying of this page, variable IMOND_LOG must be set to 'YES' in file `config.txt` .

Identically to the Calls overview you may switch between locally stored connections and connections which are stored on the router. When in display of connections stored on the router you will erase routerīs log file by "pressing" the reset button.

Display shows per connection:

- circuit name
- start date and time
- end date and time
- online time
- charge time
- real costs
- number of received characters
- number of characters sent

Data about received and sent characters is not supported with DSL in the moment. Up to npw there will be sum-up for online time, online costs, received bytes and sent bytes.

Besides that you may also start the program FliStat (written by: Stefan Böhm). A link to this program can be found on FLI4Līs homepage. This program offers a lot of data about connection statistics - and mor data than imonc.

##### [ top ]

#### 8.2.7 Page: Fax (facsimile)

To be able to display page Fax, you will have to install OPT_MGETTY (by Michael Heimbach) on the router. It can be found on the FLI4L homepage in section: OPT packages (OPT-Pakete).
All incoming facsimiles will be listed on this page. Using the context menu of the overview will offer several options - only available in admin mode.

- Display a facsimile. To do so, you will have to set the path for FLI4L folder in Admin/Remoteupdate. This is needed since all facsimiles are available on the router in a compressed format. That means: you will need gzip from the FLI4L package to un-compress faxes. Alternatively you may copy `gzip.exe` and `win32gnu.dll` into imonc folder. If `gzip.exe` cannot be found in either of both locations, the web server of your router will be opened (directly by calling the correct CGI).
- Delete a single facsimile. That means thios fax will be deleted locally and also on the router (the original facsimile file AND the entries in log files).
- Delete all Faxes on the router. This will delete all facsimiles and log files on the router. Facsimiles will NOT be deleted from the local log file.

Similar to the Calls overview you may here switch between locally stored facsimiles and facsimiles which are stored on the router.

##### [ top ]

#### 8.2.8 Page: EMail

Page EMail describes itself. In this section the (now) integrated EMailChecker can be observed. If option "Check even if the router is offline" was not activated, EMailChecker will check all email boxes/accounts for emails when router is online and will use the given interval afterwards. If the router is actually on-line, it will use the selected circuit. If the router is NOT online, it will establish a connection by using the selected circuit. This connection will be closed after having done all email accounts. To use this option you will have to set Dialmode to 'auto'.

If there are any emails on the POP3 server, the selected email client will be started automatically or a new symbol will be displayed besides the clock. This is a hint for numbers of emails per server. A double-click will start the selected email client. If an error occured (with ine of the email accounts), an error message will be in the email history and and the email tray icon will be displayed with an upper right red edge.

The email overview enables you to directly delete emails on the server(s) without having loaded them (down) completely. This is done by opening the context menu with the right mouse key/click. You should before mark a cell of the email entry you want to delete. In context menu select the only choice: Delete MailMessage .

##### [ top ]

#### 8.2.9 Page: Admin

This part is only available if imonc is used in Admin mode.

First step offers an overview of circuits used - i.e. providers used - which were selected automatically by the router (via LC routing). By double-clicking on the provider entry in provider overview you will get a display of time interval definitions (in: `config.txt`) for this provider.

Second part offers the opportunity to install a remote update on the router. You may choose which of the four program packages (kernel, root file system, OPT file and `rc.cfg`) shall be copied to the router. To be able to do the remote update, you will have to enter the FLI4L directory from which imonc shall read necessary files to copy. Additionally you will have to enter the sub-directory with configuration files for re-generation of `opt.tgz` (by default this would be: `config`). To have the opportunity to work on the configuration files by using FliwizNG, you must copy FliwizNG to the FLI4L folder. Otherwise the button will be de-activated.
It is recommended that you will do a re-boot of the router after having done an update. This is necessary to be sure that all changes take effect.
The remote update no longer needs an installed FTP server on the router.
If there is any question for a password during update, this will be the password which was entered in `config.txt` in variable PASSWORD.

To get around the limitations of port forwarding in the point that it is bound to the connection to a client comper, there is now th possibility to edit the script `portfw.sh` on the router. To activated changes you will have to re-connect. Since the file will be replaced in the RAM disk, all changes will only be present until next re-start of the router. To store changes permanently you will have to install a new OPT file on the router which includes the changed file `portfw.sh`.

The fourth part on the Admin page "files" is used for displaying configuration and log files of the router by simply clicking with the mouse. Selection list can be configured via step Config/Admin and "files on router to view". After this you are able to select - via ComboBox on this page - which file shall be displayed.

##### [ top ]

#### 8.2.10 Pages: Error, Syslog and Firewall

Pages Error, Syslog and Firewall will only be displayed if there are corresponding entries in the spec. logs. Entries of pages Syslog and Firewall will only be displayed if you are in Admin mode.

On page Error all imonc/imond-specific errors will be stored. If there any problems you may have a look to this list to see if the causes for the errors you encountered are listed.

On page Syslog incoming Syslog messages will be displayed - except messages of the firewall. These are displayed on a separate page (see below). To get this working you will have to set variable OPT_SYSLOGD in configuration file `config.txt` to 'yes' . Additionally variable SYSLOGD_DEST must be set to the IP address of the client (more detailed: `SYSLOGD_DEST='@100.100.100.100` - IP address must be set to the IP address of YOUR client!).
Not only Syslog message but also date, time and priority level will be displayed.

Firewall messages will be displayed on a separate page. To give the opportunity to have the firewall messages displayed here, you must set in file `config.txt` the configuration variable OPT_KLOGD to 'yes' .

##### [ top ]