The procedure for installing MOMI the first time or updating an existing installation are virtually the same.
The MOMI PC Client installs by default into its own version specific subdirectory and is accessed from the Windows Start menu as BWS MOMI n.nn (where n.nn is the version number).
The MOMI server software or an update to an existing installation is recommended to be installed in the same NonStop subvolume. By default, existing startup and /configuration information is left unchanged. Files are renamed as necessary to allow for installation while the MOMI server is running and to provide for fallback.
The process usually begins by downloading MOMI software from our website. The same software download performs either function of a new install or an update of an existing installation. A launcher utility is initially invoked first which presents the options to install the MOMI PC client on the local PC, install the MOMI server files on the NonStop System (which uses the MOMIFTP utility), or copy the MOMI PC Client files to a shared file location (read more about this here)..
If necessary, information to manually install MOMI Server files on the NonStop are found here.
Steps:
1) If you need MOMI software, download the latest version of MOMI from our web site.
2a) If you downloaded an EXE from our web site:
double click on the downloaded file
2b) If you downloaded a ZIP from our web site:
expand the ZIP file to an empty subdirectory on your PC and double-click on Launcher.exe
2c) If you have a MOMI DVD / Flash drive:
double click on the file Launcher.exe
3) Once the installation process starts your given the options to a) Install the MOMI Client, b) Install the MOMI Server files on NonStop Server, c) Copy Client to shared server, or d) View ReadMe file for MOMI. Select Install MOMI Client. Click though the initial and Welcome screen. Please read and accept the license agreement.
4) The next screen is Choose the Destination Folder, or location, where the MOMI files on the PC are to be installed (default recommended). By default, each version of MOMI installs into its own version specific subdirectory.
5) The next screen selects the Setup Type. Choose Complete Installation.
6) Choose the name of the program group for shortcut on the Start menu (default recommended). By default, each version of MOMI creates its own version specific shortcuts.
7) Click Next to begin the installation (which may take some time).
8) Click Finish.
9) Select Install the MOMI Server files on NonStop Server. The program MomiFTP is started to perform the FTP or SFTP transfer of files from the PC to the NonStop System.
10) From a TACL terminal emulator, logon with the User ID and password to operate $MOMI. Volume to the location where the MOMI files were placed.
11) Edit the file OBYMOMI. This is a TACL obey file used to start MOMI and provide initial configuration information. Page down to the section "set values below here". This marked portion of the obey file is the place to change the initial start up values for MOMI.
Check the process name, CPU $MOMI operates in, priority and home terminal. The default values are usually valid for most systems.
12) Edit the file CONFMOMI. This edit file is used to set various MOMI attributes using keywords. Set the System-Description and check the TCPIP-LISTEN which defines the TCP/IP process name, optionally the address and port that MOMI will 'listen' on for PC Client connections.
13) SQL/MP compile MOMI (if you don't use SQL/MP, ignore this step):
From a TACL prompt: OBEY OBYCSQL
14) Create / update BWSSG or 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 - but changing your logon to different users that may be required in your environment is omitted.)
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
An existing BWSSG must be updated any time BWMOMI is updated.
The FUP DUP option of SOURCEDATE or SAVEALL must be used.
15) Start MOMI:
From a TACL prompt: OBEY OBYMOMI
(wait at least 1 minute before proceeding to the next step)
16) On your PC, start the PC MOMI Client (Start / Programs / BWS MOMI_n.nn / MOMI). The first time a Client is started, it will prompt for the TCP/IP address of the NonStop System and port (the port is defined in the CONFMOMI file and has a default of 2010).
MOMI configures and starts on the NonStop System a measurement (DCPUS file) configured for a variety of entities (CPU, Process, TMF, etc...). This measurement does not specify an interval but is effectively used for LISTACTIVE purposes. However, MEASURE will write data to this file such as processes stopping.
On older systems, sometime after starting MOMI on the NonStop System, the following message, one per processor, may be logged to EMS:
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.