The procedures for installing MOMI the first time or updating an existing installation are virtually the same.
In prior releases, MOMI installation software was packaged as an EXE or ZIP. The new MSI format performs all of the same features, plus allows the client to be installed under the current user which does not normally require administrator access.
The MOMI PC Client installs by default into its own version specific subdirectory and is accessed from the Windows Start menu under BWS MOMI n.nn (where n.nn is the version number).
It is recommended that a new version of the MOMI server software or an update to an existing version is installed into the same subvolume on the NonStop System. By default, existing startup and configuration information is not changed. Existing files are renamed as necessary to allow for installation while the MOMI server is running and to provide for fallback.
The installation process starts by obtaining MOMI software from either our website or perhaps a flash drive handed out a conference (we can also send you the software on a flash drive on request). MOMI installation software is a standard Windows MSI file and can perform either a new install or update an existing installation. The installation program also contains utilities for transferring MOMI server software to the NonStop System (MomiFTP) and for placing MOMI software on a shared drive location (CentralServer).
The following steps describe installing MOMI software on the local PC and on the NonStop System:
1) Obtain MOMI software and double click on the MSI file. The initial screen provides allows display of the ReadMe and detailed installer Help.
2) Click though the Welcome screen. Please read and accept the License Agreement. Click through to continue.
3) The Utilities screen allows the option to run MOMIFTP and CentralServer (can be run now or later). Click Install Client > to continue.
4) The next screen selects the Setup Type. The default is Complete. Click through to continue.
5) The Ready to Install the Program screen allows MOMI software on this PC to be installed Only for me (<user>) or Anyone who uses this computer (all users). Choose the desired option. Note the Anyone... selection prompts for an administrator logon if needed. After the installation completes, click Finish.
6) Press the Windows Start button and under BWS MOMI n.nn (where n.nn is the version just installed) select MomiFTP.
7) From a TACL prompt, logon with the User ID and password that $MOMI will operate under. Volume to the location where the MOMI files were placed.
8) Edit the file OBYMOMI. This is a TACL obey file used to start MOMI and provide initial configuration information. Page down to the section "vvv set values below here vvv". This marked portion of the obey file is used to change the initial start up values for the $MOMI server portion.
Check the process name, CPU $MOMI operates in, priority and home terminal. Default values are usually valid for most systems.
9) Edit the file CONFMOMI. This edit file is used to set various MOMI attributes using keywords. Set the System-Description and check TCPIP-LISTEN which defines the TCP/IP process name, optionally the address and port that MOMI will listen on for PC Client connections.
10) SQL/MP compile MOMI (if you don't use SQL, ignore this step):
from a TACL prompt: OBEY OBYCSQL
11) Create / update BWSSG (the Super Group helper process) (see Security / General considerations to determine if you need this step):
(BWSSG is a PROGID'ed copy of the MOMI server. The following steps show you how to rename out any existing BWSSG, keeping a backup copy, create a new file - details such as required logon security to perform these operations is not covered).
Purge BWSSG2
Rename BWSSG1, BWSSG2
Rename BWSSG, BWSSG1
FUP DUP BWMOMI, BWSSG, sourcedate (BWMOMIi on TNS/E - BWMOMIx on TNS/X)
FUP Give BWSSG, <Super.Group>
FUP secure BWSSG, NGNG, PROGID
If used, BWSSG must be updated any time BWMOMI is updated.
The FUP DUP option of SOURCEDATE or SAVEALL must be used.
12) Start MOMI:
From a TACL prompt: OBEY OBYMOMI
(wait at least 1 minute before proceeding to the next step)
13) On your PC, press the Windows Start button and under BWS MOMI n.nn (where n.nn is the version just installed) select MOMI. The first time a Client is started on a PC, it will prompt for the TCP/IP address and port of the NonStop System (the port is defined in the CONFMOMI file and has a default of 2010).
Shortly after startup, MOMI on the NonStop System defines a measurement (DCPUS file) configured with a variety of entities (CPU, Process, TMF, etc...). This measurement does not specify an interval but is effectively used for LISTACTIVE purposes. This file may become 100% full which is not a concern.
On older NonStop Systems, sometime after starting MOMI, the following EMS message, one per processor, may be logged:
07-08-19 09:47:46.200 \SYSTEM.$XMnn TANDEM.MEASURE.G09 4016 Measurement 0 $vol.subvol.DCPUS: write to datafile failed. File error 45.
These messages are not a problem and may be ignored. No action is required.