noMAX Day-to-Day Guide - maxviewlite.maxava.com · noMAX Day-to-Day Guide -...

Copyright 2000 - 2012 Maximum Availability Ltd.

The Maximum Availability and Maxava HA logos are trademarks of Maximum Availability Ltd.

Document Version Number: 1.4 Publication Date: September 2012

Review Date: September 2012 Type: Instructional

Security Classification Classified

maxView Lite

From

maxView Lite Guide

Document Version: 1.4 Copyright 2000 – 2012 Maximum Availability Ltd.

ii

Table of Contents

About this Document ................................................................................................................ 2

Introduction .................................................................................................................................................. 2 Objectives ..................................................................................................................................................... 2 Intended audience ........................................................................................................................................ 2 Related reading material .............................................................................................................................. 3

Security Settings ........................................................................................................................ 4

Must be read ................................................................................................................................................. 4 HTTPS Settings ............................................................................................................................................ 4

maxView Lite Introduction ...................................................................................................... 5

Introduction .................................................................................................................................................. 5

maxView Lite Implementation and Configuration ................................................................ 6

maxView Lite Software Initial Install ........................................................................................................... 6 Create MAXNZ Profile to Own Application Objects ................................................................................... 6 maxView Lite Configuration ........................................................................................................................ 8 maxView Lite Alert Thresholds and Auto Refresh Settings ........................................................................ 13 maxView Lite Edit System Details .............................................................................................................. 14 maxView Lite Program Which Adopts QSECOFR ..................................................................................... 14

maxView Widget ..................................................................................................................... 15

Running the maxView Widget..................................................................................................................... 15 Widget Information Details ........................................................................................................................ 17

maxView Lite Browser Client ................................................................................................ 19

Accessing the Browser Client ..................................................................................................................... 19 Browser Client Details – System Control Panel ........................................................................................ 21 Browser Client Details – System Summary ................................................................................................ 23

maxView iPhone & iPad or HTML5 Capable Smartphone or Tablet .............................. 33

iPhone VPN Connection ............................................................................................................................. 33 iPhone Safari Browser Client .................................................................................................................... 33 Other Device (Android or Blackberry) Browser Client ............................................................................. 33 iPhone Home Page Icon ............................................................................................................................. 35 Main Device Screens .................................................................................................................................. 37 Notification Centre ..................................................................................................................................... 39 Alert Thresholds and Summary Information .............................................................................................. 40 Main system reporting and action functions – IBM i Button ..................................................................... 41 System Dashboard ...................................................................................................................................... 42 Storage Dashboard .................................................................................................................................... 43 HA Button ................................................................................................................................................... 45

General System Runtime Considerations & Upgrade and Removal of maxView Lite

Software ................................................................................................................................... 46

Job’s 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

Appendix A – Set-up instructions for HTTPS ..................................................................... 49

maxView Lite Guide


iii

Must be Read .............................................................................................................................................. 49 Create System/Server Certificate ............................................................................................................... 49 Create Local Certificate Authority ............................................................................................................. 49 Create the Certificate for the App/System .................................................................................................. 51 Create a New Certificate Store with a Certificate ...................................................................................... 54 Add Application Identifier into the DCM ................................................................................................... 56 Assign Application to Certificate ............................................................................................................... 58 Edit the HTTPD.CONF file on each IBM i to allow the use of the HTTPS page ....................................... 60

maxView Lite Guide


1

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 customer’s ability to evaluate and integrate them into the customer’s 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.

maxView Lite Guide


2

About this Document

Introduction This document covers the installation and running of the Maxava

maxView Lite suite.

Objectives The objectives of this document are to provide information regarding

the installation and use of the various monitor components. Areas

covered include:

Widget installation

System Configuration

Threshold Values

Auto Refresh Settings

Browser Interface Access for HTML5 Tablets and Smartphones

iPhone and iPad Safari Interface Access and set-up requirements

Removal of product

Intended

audience This document is intended for iSeries / AS/400 / IBM i operation or

technical users. The user will be familiar with OS/400 and the use of

Smartphone technology.

maxView Lite Guide


3

Related reading

material

For full detailed information relating to the System i and your

Smartphone please refer to the following:

IBM AS/400 Online Library (For general OS/400 information)

http://publib.boulder.ibm.com/pubs/html/as400/online/homeeng1.htm

Smartphone User Manual

http://publib.boulder.ibm.com/pubs/html/as400/online/homeeng1.htm

maxView Lite Guide


4

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 For greater security the maxView browser sessions can be configured to

run using https:\\ (HTTP Secure). This is the recommended approach to

using the maxView browser clients. See Appendix A at the end of the

document for configuration instructions.

maxView Lite Guide


5

maxView Lite Introduction

Introduction maxView Lite has been designed to enable System i customers to

monitor their general system statistics via a HTML5 browser based

interface.

maxView Lite is supported on operating systems V5R3 and above and

requires the appropriate DG1 IBM HTTP Server for i5/OS LICPGM to

be present.

The PC installing the application requires Adobe Air to be installed and

to have JavaScript turned on for all browsers. Flash Player 10 or above

is also required.

This browser based technology therefore allows for monitoring from

HTML5 browser capable smart phones and tablets.

The following areas are Monitored:

WRKSYSSTS information

WRKACTJOB information

WRKDSKSTS information

ASP utilisation

CPU utilization

Interactive Users

Batch Jobs

IBM i Summary Information

Messages

Spool files

Performance Dashboard

Storage Dashboard

maxView Lite Guide


6

maxView Lite Implementation and Configuration

maxView Lite

Software Initial

Install

Create

MAXNZ

Profile to Own

Application

Objects

The maxView_AirLte.air package requires the Adobe AIR software in

order to be executed on a PC. This software is available from the Adobe

website. http://get.adobe.com/air/

To install maxView run the ‘maxView_AirLte.air’ executable on a PC

which has communications available to the required IBM i servers. The

installation uses FTP to load the required objects onto the IBM i. You

will need to ensure that the FTP servers are started and that you do not

have any third party software or similar blocking FTP requests between

the PC and the IBM i.

The software requires an object owner to exist on each of the IBM i

servers you will be installing on. The object owner profile is called

MAXNZ and should be created with no special authorities or sign on

capabilities.

On each system you will be installing the monitor create the following

user profile before installing the software.

CRTUSRPRF USRPRF(MAXNZ) PASSWORD(*NONE)

USRCLS(*SYSOPR) ASTLVL(*BASIC) LMTCPB(*YES)

TEXT('Profile Owner for Maxava application objects')

SPCAUT(*NONE)

You then need to create the library to install the maxView software

objects into. You can call the library by whatever name you chose,

however we recommend the name MXMNLITE.

On each system you will be installing the monitor create the

MXMNLITE library.

CRTLIB LIB(MXMNLITE) ASP(1) TEXT('maxView Lite Software

Library')

http://get.adobe.com/air/

maxView Lite Guide


7

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.

Select ‘Install’ and proceed.

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 Guide


8

maxView Lite

Configuration

As the product loads the screen above will be shown.

When the main PC install has been completed the maxView Lite

configuration screen will automatically be displayed.

maxView Lite Guide


9

Enter in the details for your first system to be monitored.

Details required are system name, system IP address, HTTP port

number to be used, defaults to 8024 and the name of the library to be

used on the system. The library should already exist and be empty. The

TCP Port being used, defaults to 4999. Enter the required license key

obtained from the www.maxviewlite.com website if not automatically

directed there by the install process. Enter the email address used when

registering at the website.

When you are happy with the details entered select ‘ADD’

http://www.maxviewlite.com/

maxView Lite Guide


10

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.

maxView Lite Guide


11

Enter your details and select ‘LOGIN’

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.

maxView Lite Guide


12

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.

maxView Lite Guide


13

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.

maxView Lite Guide


14

maxView Lite

Edit System

Details

maxView Lite

Program

Which Adopts

QSECOFR

The ‘View Systems’ view allows you to work with the specific system

connection details and also to remove a system from the monitor.

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.

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 the required owner of these objects can be changed to

one of your choosing that still has enough authority to perform the

required checks. The profile will need to be able to access PTF

information, etc.

maxView Lite Guide


15

maxView Widget

Running the

maxView

Widget

The maxView Widget is shown after the main configuration screens

have been closed or when started from the ‘START’, ‘All Programs’

menu on the PC.

It is installed as a program onto your PC and is accessed via the

‘START’ ‘All Programs’ ‘maxView_AirLte link.

To move the widget on your screen select the top or bottom bar and

drag the widget to the desired screen position.

The Widget also has a system tray icon visible when running which

shows a warning symbol if any of the monitored systems have warnings

for issues covered by the widget.

maxView Lite Guide


16

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.

maxView Lite Guide


17

Widget

Information

Details

The main Widget screen displays the following information.

Close Closes the Widget to the System Tray

Widget Settings Opens the ‘maxView Configuration Settings’

window. This allows the addition of new

systems, deletion of systems from the Widget,

setting of Alert Thresholds and Auto Refresh.

maxNews maxNews shows the latest news available from

MAXAVA. When a new news item is available

you will see the RED mail flag on the letter

icon. Click on the envelope to find out what

new offerings are available from MAXAVA.

System Selection

Icon

If you have multiple systems available via the

Widget you can select the system to be

displayed by selecting the appropriate icon.

Manual Refresh The refresh icon allows you to initiate a single

refresh of the system data for all defined

maxView Lite Guide


18

systems.

ASP1 Usage Shows the percentage of DASD utilised in

ASP1.

Users Signed on &

Number of Batch

Jobs in MSGW

Shows the number of interactive users currently

signed on and also the number of batch jobs in

MSGW status.

System Name Displays the current system name for which the

Widget is showing data for.

Tell a Friend Launches the default PC email client and

allows you to send a brief message to anyone

who may want to know about or use the

maxView Lite product.

CPU Usage Shows the CPU percentage currently utilised.

maxView Lite Guide


19

maxView Lite Browser Client

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.

maxView Lite Guide


20

maxView Lite Guide


21

Browser Client

Details –

System Control

Panel

.

DASD % Utilised Shows the percentage of DASD utilised for the

ASP’s on the particular system.

System Name Displays the current system.

Return to the

Previous Page

Returns you to the previous browser page.

NB: Please use this option rather than the

browser back button.

Return to the

‘SYSTEM

CONTROL

PANEL’ screen

Returns you to maxView Lite initial browser

screen.

Refresh the Data

from the

Connected

Systems

The refresh icon allows you to initiate a single

manual refresh of the system data for all

defined systems.

CPU % Utilised Shows the CPU percentage currently utilised.

This figure is an average from the time the

browser session has been started. If you wish to

reset the CPU statistics and start recording the

averages once more you will need to refresh the

page by performing a CTRL F5 page refresh.

Tell a Friend Launches the default PC email client and

allows you to send a brief message to anyone

who may want to know about or use the

maxView Lite product.

Users Signed On,

Number of Batch

Jobs in MSGW &

Number of Batch

Jobs Running

Shows the number of interactive users currently

signed on, also the number of batch jobs in

MSGW status and batch jobs running.

Notification Centre Show all alerts for system or systems in one

place. No alerts the ! is blue. Existing Yellow

or Red alerts the ! is the appropriate colour.

Commands &

Settings

Opens the command window for the selected

system and allows you to set alert thresholds

and run WRKACTJOB, WRKSYSSTS,

WRKDSKSTS, display messages, work with

spool files, work with messages, display

summary information, display performance

dash and display the storage dash.

maxView Lite Guide


22

You can save the browser page as a bookmark if required for future use

and call it maxView Lite.

Selecting a system takes you to the ‘SYSTEM SUMMARY’ page.

maxView Lite Guide


23

Browser Client

Details –

System

Summary

The SYSTEM SUMMARY page has the same information as the

SYSTEM CONTROL PANEL but in more expanded detail.

Also information on:

Batch Jobs running, Number of Batch Jobs in MSGW, Users signed on,

CMDS and Dashboards (WRKACTJOB, WRKSYSSTS, WRKOUTQ,

DSPMSG, WRKSBS, MXPATROL, Storage Dash, System

Performance Dash, IBM i Summary information and Alert and

Threshold settings) for this system display.

DISK POOLS Shows the percentage of DASD utilised for the

ASP’s on the particular system.

Return to the

Previous Page

Returns you to the previous browser page.

NB: Please use this option rather than the

browser back button.

Return to the

‘SYSTEM

CONTROL

PANEL’ screen

Returns you to maxView Lite initial browser

screen.

Refresh the Data

from the

Connected

Systems

The refresh icon allows you to initiate a single

manual refresh of the system data for all

defined systems.

CPU % Utilised Shows the CPU percentage currently utilised.

This figure is an average from the time the

browser session has been started. If you wish to

reset the CPU statistics and start recording the

averages once more you will need to refresh the

page by performing a CTRL F5 page refresh.

CFG Status

Display Shield

If you had one of Maxava’s HA products

installed and were running the maxView

maxView Lite Guide


24

Monitor or Managers products the greyed out

shield would show the highest warning status of

any of the monitored configurations for the

system shown. There would also be a remote

journal communications pipe attached to the

shield showing a moving data icon between the

CPU percentage wheel and the shield when

there are no remote journal communication

issues. If any of the remote journals for any of

the monitored configurations have an issue a

pipe ‘break’ icon would be displayed.

To view individual detailed information for a

given configuration, left mouse click on the

shield and the ‘CONFIGURATION DETAIL’

page would be shown.

CMDS and

Dashboards panel

This is a set of Commands that can be run on

the selected system.

WRKACTJOB Shows WRKACTJOB information for the

given system.

WRKSYSSTS Shows WRKSYSSTS information for the given

system.

WRKOUTQ Run the WRKOUTQ command for a selected

output queue and then work with the spool files

listed

WRKDSKSTS Shows the WRKDSKSTS information for the

given system

IBM i

SUMMARY

Shows general summary information for

system.

SETTINGS Allows you to set alert threshold values for the

system and also the auto refresh interval for this

particular client instance.

DASH System statistics dash

STG Storage dashboard.

Shows information gathered from running the

storage collection program. This program

should be scheduled to run in batch via the

JOBSCD or similar processes. The program

should be run from the maxView Lite software

library (normally called MXMNLITE) and has

two required parameters. The first defines how

many library servers are run during storage data

collection and the second defines how many

IFS servers will run.

In the example below there will be 15 library

and 15 IFS server jobs submitted. Depending

on how many servers are set to run these jobs

will use a certain amount of resource on your

maxView Lite Guide


25

system, so should be run at a time when their

impact is minimal. Or you can run with fewer

servers however the jobs will take longer to

complete retrieving the storage statistics.

It is important to note that if you require QDLS

information to be retrieved the profile running

the job must be enrolled in the system

directory.

SBMJOB CMD( CALL

PGM(<SFWLIB>/MXVWLCTL) PARM('15'

'15') ) JOB(MXVWLCTL)

JOBQ(QGPL/QS36EVOKE)

The information gathered by the storage server

jobs is stored in history files located in the

maxView software library.

The files are called :

MXIFSSIZ

MXIFSTOP

MXLIBASP

MXLIBCTL

MXLIBSIZ

MXLIBTOP

To purge information from the data statistics

files submit the following job. The job has one

parameter which is the date to clear data up to.

It is in the format of YYYY-MM-DD. So in the

example below data is being cleared up to the

1st of January 2012.

SBMJOB CMD(CALL

PGM(<SFWLIB>/MXVWLPRG)

PARM('2012-01-01')) JOB(MXVWPRG)

JOBQ(*LIBL/QS36EVOKE)

maxView Lite Guide


26

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.

maxView Lite Guide


27

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.

maxView Lite Guide


28

maxView Lite Guide


29

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.

maxView Lite Guide


30

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

The IBM i Summary tab provides information on high level system

details regarding Operating System, OS PTF levels, RDB information

as well as Maxava HA Summary details and information regarding

Product details, License Key, maxView Version, Autonomics Setup and

Status.

maxView Lite Guide


31

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.

maxView Lite Guide


32

Browser Client

Details – DASH

(Performance)

Dashboard

The Performance Dashboard shows you the system performance data

displayed by your browser session whilst connected. You can scrol

through the data using the arrows, collect another sample by pressing

the refresh stats button or restart the statistics by pressing the reset stats

button.

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.

maxView Lite Guide


33

maxView iPhone & iPad or HTML5 Capable Smartphone or Tablet

iPhone VPN

Connection

iPhone Safari

Browser Client

Other Device

(Android or

Blackberry)

Browser Client

In order to use maxView Lite on your iPhone, iPad, Android or

Blackberry etc, you will need to first ensure you have a connection to

your work network.

For most this will mean a VPN connection which will allow you access

via wireless and 3G.

To configure a VPN connection on your iPhone or iPad use the

‘Settings, General, Network, VPN, Add VPN Configuration’ and enter

in the relevant connection details for your network.

Once configured connect to your work network.

Then open a ‘Safari’ browser session and connect to your IBM i

maxView Lite HTTP server. This can be on any of the systems on

which the monitor is installed and running.

If you are using an Android or Blackberry use the relevant HTML5

browser and connect to the following appropriate addresses using that.

Save the link to your favourites and then access the pages from there in

the future.

maxView Lite Guide


34

Connect to the system IP address, followed by the HTTP port number

and then the ip.html or tablet.html page.

ip.html for smartphones and tablet.html for tablets.

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 for your iPhone or

smartphone:

http://192.168.0.98:8024/ip.html

You can also enter the address simply as http://192.168.0.98:8024 and

the bowser should auto detect which type of device you are using and

display the correct page.

For you iPad or tablet you would go to:

http://192.168.0.98:8024/tablet.html or http://192.168.0.98:8024

As you connect to each system you will be prompted for your IBM i

access details.

http://192.168.0.98:8024/

http://192.168.0.98:8024/tablet.html

http://192.168.0.98:8024/

maxView Lite Guide


35

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.

maxView Lite Guide


36

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.

maxView Lite Guide


37

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.

maxView Lite Guide


38

On the iPad it looks like this. Select the systems from the bottom

navigation bar.

The data displayed will automatically be updated on the device as per

the MXMNLITE server refresh interval set at the system level. You can

force a manual refresh by select the refresh icon at the bottom left of the

screen on both devices.

maxView Lite Guide


39

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.

maxView Lite Guide


40

Alert

Thresholds and

Summary

Information

To adjust the threshold alert settings and view IBM i Summary

Information select the settings sprocket at the bottom right corner.

maxView Lite Guide


41

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 OUTQ’s 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.

maxView Lite Guide


42

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.

maxView Lite Guide


43

Storage

Dashboard

The Storage Dashboard shows storage run information gathered by the

MXVWLCTL collection jobs.

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.

maxView Lite Guide


44

maxView Lite Guide


45

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.

maxView Lite Guide


46

General System Runtime Considerations & Upgrade and Removal of maxView Lite Software

Job’s Running

Under the

QHTTPSRVR

Subsystem

System Start-

up/Return

From

Restricted

Condition and

End

Considerations

maxView Lite

Upgrade

When installed on the IBM i the monitor runs under the QHTTPSVR

subsystem and you should have jobs that look like the following:

MXLTEDTA PKANIA BCH .0 PGM-MXVWCFST DEQW

MXLTETCP PKANIA BCH .0 PGM-MXVWTCP TIMW

MXMNLITE QTMHHTTP BCH .0 PGM-QZHBMAIN SIGW

MXMNLITE QTMHHTTP BCI .0 PGM-QZSRLOG SIGW

MXMNLITE QTMHHTTP BCI .0 PGM-QZSRLOG SIGW

MXMNLITE QTMHHTTP BCI .0 PGM-QZSRHTTP SIGW

MXMNLITE QTMHHTTP BCI .0 PGM-QZSRCGI TIMW

MXMNLITE QTMHHTTP BCI .0 PGM-QZSRHTTP DEQW

You will need to add a ‘MXVWSTR MAXLIB(MXMNLITE)’

command to the system start-up routine and or job schedule entries to

cover IPL’s or other system restricted commands etc.

To end use the ‘MXVWEND MAXLIB(MXMNLITE)’

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 PC’s

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.

maxView Lite Guide


47

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.

Once installed from the maxView Configurations Settings window and

the ‘View Systems’ tab, select the available systems and use the

‘DELETE’ button to remove their details from the Widget instance.

When all systems have been removed go to the ‘Add System’ tab and

re-add the required systems. As you enter in the individual system

details you will be prompted to log onto the relevant system and the

required program objects will be uploaded once more to the system and

the HTTP server started.

maxView Lite Guide


48

maxView Lite

Removal

To remove the maxView Monitor from your systems, simply remove

the Widget code form your PC using the PC Control Panel Add remove

Programs option and then 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 library installed into was called

MXMNLITE the command to run would be:

‘MXMNRMV MAXLIB(MXMNLITE)’

maxView Lite Guide


49

Appendix A – Set-up instructions for HTTPS

Must be Read

Create

System/Server

Certificate

Create Local

Certificate

Authority

NB: These instructions are for IBM i OS7.1 where no previous

certifcate store settings have been created. If you already have

certificate stores created or you are using an earlier version of the

Operating System some of the screens may differ to what you see

below, however the general steps should still be similar.

If you require assistance in configuring https:\\ on your systems the

MAXAVA service team can assist at our standard hourly rates.

Ensure the HTTP admin server is started on your IBM i. (STRTCPSVR

*HTTP *ADMIN)

Log into the DCM (Digital Certificate Manager) with this URL http://192.168.0.98:2001/QIBM/ICSS/Cert/Admin/qycucm1.ndm/main0

Replace 192.168.0.98 with your systems ip address.

Log into the DCM.

Create a certificate authority. (note the password as this will be needed

later on)

maxView Lite Guide


50

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

Set the policy date for the local certificate store.

maxView Lite Guide


51

Create the

Certificate for

the App/System

Log into the DCM once more.

Select the ‘Select a Certificate Store’ option.

Select ‘Local Certificate Authority (CA)’ and then ‘Continue’.

maxView Lite Guide


52

Log into the Local CA Store (using password created from the Create

Local Certificate Authority step above) and select ‘Continue’.

You should see the ‘Current Certificate Store’.

maxView Lite Guide


53

On left hand side menu select ‘Create New Certificate Store’.

Select ‘*SYSTEM’ and then ‘Continue’.

Select ‘Yes - Create a certificate in the store’ and then ‘Continue.

maxView Lite Guide


54

Create a New

Certificate

Store with a

Certificate

On the ‘Select a Certifcate Authority (CA)’ page select ‘Local

Certificate Authority (CA)’ and then ‘Continue’

On the ‘Create a New Certificate Store with a Certificate’ screen fill in

the form with the appropriate details adding a new password etc and

select ‘Continue’.

maxView Lite Guide


55

Your certificate has now been created.

maxView Lite Guide


56

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’.

maxView Lite Guide


57

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’.

Add the application ID ‘QIBM_HTTP_SERVER_MAXVIEW’.

Select Application description and enter the application ID then select

‘Add’.

maxView Lite Guide


58

Assign

Application to

Certificate

The ‘Add Application’ confirmation screen should be shown.

On the left hand side menu select ‘Manage Certificates’ and then select

‘Assign Certificate’ and ‘Continue’.

maxView Lite Guide


59

Select ‘MAXVIEW’ (created in the ‘Create a New Certificate Store

with a Certificate’ step above) and then select ‘Assign to Applications’.

On the ‘Select Applications’ screen scroll to bottom of the page and

select ‘QIBM_HTTP_SERVER_MAXVIEW’ and then ‘Continue’

maxView Lite Guide


60

Edit the

HTTPD.CONF

file on each

IBM i to allow

the use of the

HTTPS page

On the ‘Application Status’ screen you should see a confirmation

message ‘The applications you selected will use this certificate’. Select

‘OK’. You will return to the ‘Assign Certificate Page’. At this stage you

can navigate to another page or exit the browser session as you have

completed the necessary create and add certificate steps.

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

maxView Monitor - /www/mxmnsrvr/conf (only available with Maxava

HA SMB or Enterprise also installed)

maxview Manager - /www/mxmnmngr/conf (only available with

Maxava HA Enterprise+ installed)

maxView Lite Guide


61

On your IBM i perform the following:

Replace the first line of the HTTPD.CONF file which should look like

this ‘Listen 192.168.9.98:8024’

With these lines:

‘LoadModule ibm_ssl_module

/QSYS.LIB/QHTTPSVR.LIB/QZSRVSSL.SRVPGM

Listen 192.168.9.98:8024

Listen 192.168.9.98:8443’

(NB: You will need to change the IP address and port number to match

what is installed on your system. The (8443) port is a random port

number in this instance. Select a port number you know is available and

you wish to use for the secure connection)

Then, append these lines to the end of the file:

‘<VirtualHost 192.168.9.98:8443>

SSLEngine On

SSLAppName QIBM_HTTP_SERVER_MAXVIEW

SSLCacheEnable

SetEnv HTTPS_PORT 8443

ServerName mxmnlite

DocumentRoot /www/mxmnlite/htdocs

</VirtualHost>’

(NB: Once again, change the ip, port and product page address

information to what is installed on your systems. Port 8443 shown in

the example is a random choice)

Now as long as you have loaded the created certificate into your various

browser stores on your PC you can access the maxView pages using

HTTPS, e.g.:

https//192.168.9.98:8443/maxview.html

Using the example above will show you the maxView Lite browser

information now using the added security.

noMAX Day-to-Day Guide - maxviewlite.maxava.com · noMAX Day-to-Day Guide -...

Documents

Transcript of noMAX Day-to-Day Guide - maxviewlite.maxava.com · noMAX Day-to-Day Guide -...

*noMAX Day-to-Day Guide - maxviewlite.maxava.com · *noMAX Day-to-Day Guide -...

Documents

Transcript of *noMAX Day-to-Day Guide - maxviewlite.maxava.com · *noMAX Day-to-Day Guide -...

noMAX Day-to-Day Guide - maxviewlite.maxava.com · noMAX Day-to-Day Guide -...

Transcript of noMAX Day-to-Day Guide - maxviewlite.maxava.com · noMAX Day-to-Day Guide -...