Machine Type and Overview
This page will display information about the host server, such as the operating system version and the machine's name.
For example:-
Operating system | OS version | Node name | Platform | Processor cores | Physical Memory |
Linux | 2.6.18-274.12.1.el5PAE #1 SMP Tue Nov 29 14:16:58 EST 2011 | myhost | i686 | 4x Intel(R) Xeon(TM) CPU 2.40GHz | 4056 Mb |
CentOS release 5.7 (Final)
Licensing Infomation
The Customer's name and address, from the KCML licence file, and the server's Machine ID will also be displayed.
The licence file is usually lic.txt.
However, if SYSTEMID has been set then lic.n.txt will be used first.
Licence allocations for KCML, KClient, SOAP & ODBC are shown in a table:-
The product names in the first column are links to pages that display a detailed breakdown of licence allocations.
View System Logs
Next will be a table of System Logs.
The filename of each system log is a link which will display the log in a table, newest entry at the top.
You can also search a system log with the View with filter links.
Super-users, such as root on Unix or Administrator on Windows will also have links to configure the system logs.
View an example system log.
Useful Commands
Useful commands is a group of commonly used diagnostic tools
-
Free disk space :- display a table of all filesystems with their size and free space.
Under Unix operating sytems, the filesystem's inode usage will also be displayed.
The column headings in this table are themselves links to change the order in which the table is displayed.
-
Current process list :- table of all processes that are running on the server.
Like the Free disk space table, the column headings are links which will change the order in which the table is displayed.
- Program Name :- Process's program name
- Process ID :- Unique process identifier (PID)
- Parent PID :- Process identifier of the process that created this process
- User name :- User account that owns the process
- State :- Process state
- Run :- process is currently executing
- Wait :- process is waiting on disk I/O
- Stop :- process has been stopped, eg by job control
- Defunct:- process is terminating
- Sleep :- process is not currently executing, eg waiting on keyboard input
- Mem usage :- Estimate of the resident set size (RSS) in kilo-bytes
- Shared Mem :- How much of the RSS can be shared with other processes.
- Private Mem :- How much of the RSS is for its own use.
- Swap :- How much of the process's memory has been swapped out to disk. Only available when running on Linux kernel 2.6.32 or later.
- Age :- How long the process has been running in hours, minutes and seconds. Tooltip is the start date & time in ISO-8601 timestamp format: CCCC-MM-DD HH:MM:SS.mmm
- I/O wait time :- Amount of time the process has spent waiting on disk I/O
- Avg I/O wait :- Percentage of the process's lifetime it has spent waiting on disk I/O
- System time :- Amount of time the process has spent executing operating system code
- User time :- Amount of time the process has spent executing its own code
- Total CPU time :- Sum of System time + User time
- Avg CPU usage :- Total CPU time expressed as a percentage of the process's lifetime
This can be useful in tracking down processes which are using lots of memory or are taking up a lot of processor time.
The Process ID and Parent PID columns are also a links which will displayed more detailed information about that particular process.
Unix versions also show the User Name column as a link to a page showing information about the owner's account.
Note: Not all columns are available on all operating systems.
-
Current system load :- The amount of processor utilization & memory usage can be viewed with this page.
A number of samples are displayed, similar to the Unix sar command:-
- User :- Percentage of CPU time spent executing user code
- Sys :- Percentage of CPU time spent executing system calls
- Wait :- Percentage of CPU time spent waiting for disk I/O
- Idle :- Percentage of CPU time spent doing nothing
- Run Queue :- Real-time processor run queue
- I/O Queue :- Number of processes waiting on disk I/O
- Read :- Rate at which data is read from disk
- Write :- Rate at which data is written to disk
- Received :- Amount of network traffic read since the start of the sample
- RX rate :- Rate at which network traffic is being read
- Transmit :- Amount of network traffic sent since the start of the sample
- TX rate :- Rate at which network traffic is being written
- Physical memory :- Amount of RAM installed in the system
- Used memory :- Amount of memory used by running processes.
- Free memory :- Amount of memory available to execute processes, this does not include memory used for the operating system's file cache.
- Swap :- Size of the swap file.
- Swap used :- Amount of memory that has been paged out to the swap file.
- Swap free :- Amount of space left in the swap file
Some metrics are not available on all operating systems.
On Unix systems the process run queue for the last 1, 5 & 15 minutes will be shown.
When Free memory is small, and Memory usage is high, the operating system will begin to swap processes between memory and the page file.
This has a detrimental impact on performance as the system is restricted by the rate of disk I/O.
In these situations Sys, Wait & the I/O queue will be high.
-
netstat -a :- Display the status of network ports & connections.
-
netstat -rn :- Display network routes.
-
mount :- Display list of mounted file systems.
-
ipcs -a :- Display shared memory & semaphore keys
Account Properties
On Unix versions of the Connection Manager, there are two links for displaying the properties of user's accounts on the system; Look up user details and Look up every user's details.
The first link will show a form in which a list of usernames, separated by a space, comma or semi-colon, can be entered.
When the form is submitted the properties of the user's accounts will be displayed.
The Look up every user's details link will show details of every account on the system.
The properties shown by both links include the username, full-name (or comment), numeric user- and group-IDs and the account's home directory.
The Access column of this table also shows which accounts are authorized to use the connection manager, ie those accounts whose home directory has a .kcmlLogin file.
Selecting the link in this column adds or removes the .kcmlLogin file thus enabling or disabling access for the selected account.
When a .kcmlLogin file is created by these pages it will have the contents
# KCML Connection Manager access key
to indicate its purpose.
See Also:
Remote Adminstration Functions