Publication Date:
Review Date:
Type:
1.4
September 2012
September 2012
Instructional
maxView Lite
From
Table of Contents
About this Document ................................................................................................................ 2
Introduction .................................................................................................................................................. 2
Objectives ..................................................................................................................................................... 2
Intended audience ........................................................................................................................................ 2
Related reading material.............................................................................................................................. 3
General System Runtime Considerations & Upgrade and Removal of maxView Lite
Software ................................................................................................................................... 46
Jobs Running Under the QHTTPSRVR Subsystem ................................................................................... 46
System Start-up/Return From Restricted Condition and End Considerations ........................................... 46
maxView Lite Upgrade ............................................................................................................................... 46
maxView Lite Removal ............................................................................................................................... 48
ii
iii
The Maximum Availability and Maxava HA logos are trademarks of Maximum Availability Limited.
The AS/400, iSeries, IBM i, System i, OS/400, OS/400 Journaling and OS/400 Remote Journaling are
products and trademarks of the International Business Machines Corporation. Other trademarks and
registrations are the properties of their respective companies.
This document should not be copied, distributed or material extracted for other uses without the written
approval of Maximum Availability Ltd.
References in this document to Maximum Availability Ltd. products, programs or services do not imply
that Maximum Availability Ltd. intends to make these available in all countries.
Maximum Availability Ltd. may have patents or pending patent applications covering subject matter in this
document. The furnishing of this document does not give you any license to these patents.
The use of this information or the implementation of any of these techniques is a customer responsibility
and depends on the customers ability to evaluate and integrate them into the customers operational
environment. While each item may have been reviewed by Maximum Availability Ltd. for accuracy in a
specific situation, there is no guarantee that the same or similar results will be obtained elsewhere.
Customers attempting to adapt these techniques to their own environment do so at their own risk.
Introduction
Objectives
Intended
audience
Widget installation
System Configuration
Threshold Values
Removal of product
Related reading
material
http://publib.boulder.ibm.com/pubs/html/as400/online/homeeng1.htm
Security Settings
Must be read
For maxView Lite there are two programs which are required to adopt
QSECOFR authority in order to be able to retrieve the required system
information. They are programs MXMNCFST and MXVWCFST.
After installation, if required, the owner of these objects can be changed
to one of your choosing that still has enough authority to perform the
required checks.
HTTPS
Settings
maxView Lite
Software Initial
Install
Create
MAXNZ
Profile to Own
Application
Objects
When you run the executable the first screen you will see is the
software authentication screen. If you do not see this screen do not
install the application and please contact Maximum Availability
Limited to confirm the version you have is correct.
At this point you can either accept the defaults or change the installation
preferences. Once satisfied with the settings select Continue to
proceed.
maxView Lite
Configuration
When the main PC install has been completed the maxView Lite
configuration screen will automatically be displayed.
You will then be required to accept the maxView End User Licence
Agreement.
The next screen will prompt you to enter your IBM i logon information.
10
At this point the transfer of required code from your PC to the IBM i
will take place. You can keep track of what is occurring via the progress
window in the lower half of the screen.
11
When the install has finished and the servers started successfully the
following message is displayed.
Select OK. The next screen will show your added system listed on the
left hand side of the window.
If you wish to add another system at this time, or in the future, simply
select the Add System button at the top right of the screen.
12
maxView Lite
Alert
Thresholds and
Auto Refresh
Settings
When you have finished adding your systems you will see them all
listed on the left hand side of the screen. To work with the threshold
alert settings and the auto refresh options, select the General button to
go into the general view and then select the required system. If you
have made any changes to the the threshold alert values and wish them
to be applied you need to select the UPDATE button.
Threshold values for the Widget are unique for each Widget instance
and do not affect the system settings which are controlled via the
Browser/Tablet/Smart Phone settings options.
13
The View Systems view allows you to work with the specific system
connection details and also to remove a system from the monitor.
maxView Lite
Edit System
Details
When you have made all your required additions and changes exit the
configuration screen by selecting the windows top right close button.
The main maxView Widget is then shown.
maxView Lite
Program
Which Adopts
QSECOFR
14
maxView Widget
Running the
maxView
Widget
15
The Widget when minimised stays active in the system tray. If you right
click on the Widget it allows you to Restore to maximise the Widget
to your desktop, News to open the maxNews page, Settings to open
the configuration screens and Exit to close the Widget completely.
16
Widget
Information
Details
Close
Widget Settings
maxNews
System Selection
Icon
Manual Refresh
17
systems.
ASP1 Usage
System Name
Tell a Friend
CPU Usage
18
Accessing the
Browser Client
The maxView Lite Browser client can be launched in one of two ways.
You can either left mouse click on the CPU dial shown on the maxView
Lite Widget, or you can navigate directly to the required system and
HTTP server.
So to open a browser session and connect to your IBM i maxView Lite
HTTP server using your PC, connect to the system IP address (if you
are external to your companies network you may need to have a valid
VPN connection started), followed by the HTTP port number and then
the maxview.html page.
This can be performed on any of the systems on which the monitor is
installed and running.
So for a system with an IP address of 192.168.0.98 running the monitor
on port 8024 you would enter the following address:
http://192.168.0.98:8024
When accessing the systems you will be prompted with logon screens
for each of the systems the monitor is attempting to connect to. If your
user profile exists on all systems being connected to you will only
receive the one logon request.
Enter your IBM i logon details. Once authenticated the main maxView
Lite browser window will be shown.
19
20
Browser Client
Details
System Control
Panel
DASD % Utilised
System Name
Return to the
Previous Page
Return to the
SYSTEM
CONTROL
PANEL screen
CPU % Utilised
Tell a Friend
21
You can save the browser page as a bookmark if required for future use
and call it maxView Lite.
22
Browser Client
Details
System
Summary
DISK POOLS
Return to the
Previous Page
Return to the
SYSTEM
CONTROL
PANEL screen
CPU % Utilised
CFG Status
Display Shield
23
CMDS and
Dashboards panel
WRKACTJOB
WRKSYSSTS
WRKOUTQ
WRKDSKSTS
IBM i
SUMMARY
SETTINGS
DASH
STG
24
25
Browser Client
Details
System
Summary WRKACTJOB
The WRKACTJOB button shows the Work with Active Jobs details for
the given system.
Double clicking on a job will provide more details. If a job is in MSGW
selecting the joblog option will also allow you to answer the message.
To refresh the statistics select the Refresh Stats button to the right of
the screen.
26
Browser Client
Details
System
Summary WRKSYSSTS
The WRKSYSSTS button shows the Work with System Status details
for the given system.
To refresh the statistics select the Refresh Stats button to the right of
the screen.
Browser Client
Details
System
Summary DSPMSG
The DSPMSG button allows you to select a Message Queue and will
display the messages in that message queue.
Click on a message to drill down to second level text.
If the message is in message wait, you can reply to the message.
27
28
Browser Client
Details
System
Summary WRKOUTQ
The WRKOUTQ button allows you to select an Output Queue and view
the spooled files within the output queue.
You can drill down into the spool data by clicking on the listed entry.
29
Browser Client
Details
System
Summary WRKDSKSTS
The WRKDSKSTS button allows you to view the Work with Disk
Status display information. A Refresh or Restart button is provided for
the statistic information.
Browser Client
Details
System
Summary
SYSTEM i
SUMMARY
30
Browser Client
Details
System
Summary SETTINGS
The Settings button accesses the Set System Alert Thresholds display,
which allows you to work with the threshold alert settings and the auto
refresh options.
When you make any changes to the threshold alert values and wish
them to be applied you need to select the UPDATE button.
The Auto Refresh option controls the frequency of the refresh runs on
the system. If the value is set to 4, then a refresh of the data for the
monitor will run every 4 minutes on the defined system.
Browser Client
Details STG
(Storage)
Dashboard
The Storage Dashboard shows you the data collected by the previously
submitted MXVWLCTL storage detail jobs. You will see the latest run
displayed or you can select the required date from the drop down box.
Selecting one of the pie charts or an item from any of the tables will
show you the statistics for that particular item from all available runs.
31
Browser Client
Details DASH
(Performance)
Dashboard
Browser Client
Details
MXMNALRT
Alert Control
File
You can colour code your alerts in the browser either red or yellow by
updating the MXMNALRT file via DFU. The file resides in the
maxView Software library. Change the ALERT_LVL field to 1 for
yellow or 2 for red. When the alert threshold is reached the relevant
item will change to that colour on your browser.
32
iPhone VPN
Connection
iPhone Safari
Browser Client
Other Device
(Android or
Blackberry)
Browser Client
33
34
iPhone Home
Page Icon
Once connected if you wish to add an icon to your iPhone home page
screen simply select the + icon at the bottom of the screen and then
select the Add to Home Screen button. You follow a similar process
for the iPad.
35
Then give your new icon a name, e.g. maxView Lite. Then add it.
You should now have an icon which looks something like this on your
iPhone.
Now when you wish to check your systems all you need to do is enable
your VPN connection and press the maxView Lite icon to connect.
36
Main Device
Screens
Once connected you will see an initial splash screen followed by the
main screen which will show system being monitored.
Select the system by touching either the dial icon or its name beside it.
Where you are monitoring multiple systems scroll down to see the
additional systems etc.
37
On the iPad it looks like this. Select the systems from the bottom
navigation bar.
38
Notification
Centre
The following screens are available for the iPhone and smartphone
devices. Similar iPad and tablet screens are also available.
Notification Centre You can display this by selecting the exclamation
mark at the bottom of the screen. This shows alerts for the systems.
39
Alert
Thresholds and
Summary
Information
40
Main system
reporting and
action functions
IBM i Button
To access the main system reporting and action functions select the
IBM i button at the top right of the screen. These all function in a
similar way to the PC Flash version. You can display OUTQs and then
the spool files within them. Bring up the WRKACTJOB information
and drill down to see lower level job information and answer messages,
check your WRKSYSSTS information, look at your WRKDSKSTS
information and display message queues.
41
System
Dashboard
The Sys Dashboard option shows you graphs of collected data from the
period the session has been active on the device. You can scroll down to
see more charts and graphs.
42
Storage
Dashboard
Selecting one of the pie charts or an item from any of the tables will
show you the statistics for that particular item from all available runs.
43
44
HA Button
The HA button at the bottom of the screen will take you to the
maxava.com website where you will be able to see more information on
High Availablility and request a demo of the MAXAVA software range
if you so desire.
45
When installed on the IBM i the monitor runs under the QHTTPSVR
subsystem and you should have jobs that look like the following:
Jobs Running
Under the
QHTTPSRVR
Subsystem
MXLTEDTA
MXLTETCP
MXMNLITE
MXMNLITE
MXMNLITE
MXMNLITE
MXMNLITE
MXMNLITE
System Startup/Return
From
Restricted
Condition and
End
Considerations
maxView Lite
Upgrade
PKANIA
PKANIA
QTMHHTTP
QTMHHTTP
QTMHHTTP
QTMHHTTP
QTMHHTTP
QTMHHTTP
BCH
BCH
BCH
BCI
BCI
BCI
BCI
BCI
.0
.0
.0
.0
.0
.0
.0
.0
PGM-MXVWCFST
PGM-MXVWTCP
PGM-QZHBMAIN
PGM-QZSRLOG
PGM-QZSRLOG
PGM-QZSRHTTP
PGM-QZSRCGI
PGM-QZSRHTTP
DEQW
TIMW
SIGW
SIGW
SIGW
SIGW
TIMW
DEQW
For the MAXLIB parameter use the name of the library you installed
the software into.
If a new version of the monitor software is made available there are two
upgrade options.
Firstly where only the Widget software client has had a change made
all you will need to do is uninstall the Widget on the appropriate PCs
prior to installing the new maxView_AirLte.air package. From the PC
Control Panel use the Add Remove Programs option. Alternatively
when installing the new package if an old version is detected you will
be prompted to uninstall automatically first.
46
The second option is where the code on the IBM i systems needs to be
updated. The code required for this is also contained within the
maxView_AirLte.air package and means that you will need to not only
re-install the Widget software onto the PC however also then re-upload
the required objects to each of the IBM i systems being monitored.
To do this you will need to first remove the maxView HTTP server on
each of IBM i systems using the MXMNRMV command specifying the
library name used at the time of install. The MXMNRMV command is
located in the maxView Lite product library on the system, so this
library will need to be added to your library list before running. So if
the libarary installed into was called MXMNLITE the command would
be MXMNRMV MAXLIB(MXMNLITE)
Then remove the Widget from the PC to be used to re-send the code to
the IBM i systems and install the new version from the new
maxView_AirLte.air file.
47
maxView Lite
Removal
48
Must be Read
Create
System/Server
Certificate
Create Local
Certificate
Authority
49
Install the Certificate in your browser (you can skip this step and
continue if you wish). The browser certificate is located in your IFS and
can be downloaded and installed on your PC at any time.
/QIBM/UserData/ICSS/Cert/Download/CertAuth/CA.CACRT
50
Create the
Certificate for
the App/System
51
Log into the Local CA Store (using password created from the Create
Local Certificate Authority step above) and select Continue.
52
53
Create a New
Certificate
Store with a
Certificate
54
55
Add
Application
Identifier into
the DCM
Use the Select a Certificate Store option once more and choose
*SYSTEM and log in using the password from the Create a New
Certificate Store with a Certificate step above.
Select Manage Applications from the left hand side menu. Then select
Add Application and Continue.
56
On the Add Application page you select the type of application that
you want to add. In this instance select Server Add a server
application and then Continue.
57
Assign
Application to
Certificate
On the left hand side menu select Manage Certificates and then select
Assign Certificate and Continue.
58
59
Edit the
HTTPD.CONF
file on each
IBM i to allow
the use of the
HTTPS page
You now need to update the HTTPD.CONF file for the version of
maxView you have installed on your system.
This file is located on your IBM i system under the IFS under the
ROOT directory in the www/<maxView_version> directory.
maxView Lite - /www/mxmnlite/conf
60
61