installingtroubleshootingthemunisclientmsa5 by dBI8Y9J

VIEWS: 8 PAGES: 17

									Installing & Troubleshooting the MUNIS Version 6 Client

MUNIS®
Last Updated: February 4, 2008




Department of Education
MUNIS®                                                                         Installing the MUNIS Client


                             TABLE OF CONTENTS
OVERVIEW ............................................................................................................... 3

OBTAINING THE CLIENT ......................................................................................... 3

INSTALLING THE MUNIS CLIENT (GDC) ............................................................... 4

COPYING CLIENT SETTINGS.................................................................................. 9

MANUALLY ADJUSTING CLIENT SETTINGS ........................................................ 9

TROUBLESHOOTING MUNIS CONNECTION ISSUES ......................................... 15




Last Updated: February 4, 2008                                                                      Page 2 of 17
MUNIS®                                                       Installing the MUNIS Client


OVERVIEW
Each workstation requiring access to MUNIS must first install the appropriate MUNIS
client. The client, referred to as the Genero Desktop Client or GDC, provides a
communication link between the workstation and the MUNIS server. The following
instructions direct a user through the steps of installing the GDC Version 1.33.1g on a
Microsoft Windows workstation.

Note: These instructions are written for a client installation that works with all
      versions of MUNIS Version 6.


Obtaining the Client
The Genero Desktop Client may be downloaded from the MUNIS web site. To
download the client software:

   1. In your web browser go to www.tyler-munis.com
   2. Login to the site. If you do not have a login and password you may register for
      one.
   Note: When registering for a new login/password you will need to provide your
          Customer Account Number. This is found within any MUNIS program by
          selecting Help -> About MUNIS.
   3. Once logged in select Customer Tools -> OSDBA -> Downloads -> select the
      category MUNIS Client Software and click submit.
   4. Select MUNIS Version 6 Client Package to initiate downloading the software.
      You are presented with this screen:




       You may choose to save the package to a shared drive to eliminate future
       download delays.




Last Updated: February 4, 2008                                               Page 3 of 17
MUNIS®                                                          Installing the MUNIS Client


Installing the MUNIS Client (GDC)
After the client is downloaded you will initiate the installation of the client. The
installation may automatically initiate if you selected the Run button during the
download. Following are the screens and steps to loading the client:

Note: Before starting the process, make sure the user installing the software has
      administrative rights on the workstation.




   -   Click Next to continue




Last Updated: February 4, 2008                                                  Page 4 of 17
MUNIS®                                                     Installing the MUNIS Client




   -   Select Default (recommended for All Users) and click Next




   -   Select New Install (No previous clients exist on PC) and click Next


Last Updated: February 4, 2008                                               Page 5 of 17
MUNIS®                                                    Installing the MUNIS Client




   -   Enter the IP address of your MUNIS server and click Next.




   -   Review the EULA and click Yes to agree to the terms of the agreement.


Last Updated: February 4, 2008                                            Page 6 of 17
MUNIS®                                                       Installing the MUNIS Client




   -   Progress screens will show the progress of the installation. This should only take
       a couple of minutes.




Last Updated: February 4, 2008                                               Page 7 of 17
MUNIS®                                                         Installing the MUNIS Client


   -   The final screen appears indicating completion of the installation. Click Finish.




   -   After the installation is complete the user workstation will show two MUNIS
       icons on the desktop. Remove the icon labeled “MUNIS Train” since the user
       selects the Live or Train option after they have logged into the RS6000 server
       using the MUNIS Live icon.
   -   Additional steps are required to adjust the default client installation settings. The
       client settings can be adjusted by following the instructions in Copying Client
       Settings to copy the settings from a properly configured workstation or by
       following the instructions in Manually Adjusting Client Settings.




Last Updated: February 4, 2008                                                  Page 8 of 17
MUNIS®                                                       Installing the MUNIS Client


Copying Client Settings
Client settings are contained within a configuration file named config.xml located in a
folder on the workstation. If you have a workstation configured properly you may
choose to copy this file to the recently installed workstation. To copy the configuration
file:
     - On a workstation with the GDC properly configured run Windows Explorer (right
        click on the Windows Start button and select Explore).
     - Change to the folder C:\Program Files\FourJs.
     - Here you will find a folder named GDC and possibly a folder named GDC-13x.
        Change to GDC-13x if present otherwise change to the folder GDC.
     - Change to the etc folder.
     - Copy the file config.xml.
     Note: If you wish to email this file you may have to change the file extension
            (.xml) as the attachment may be quarantine by your email firewall/virus
            software.
     - Take the copied file to the destination workstation and simply save/paste the file
        in the same folder (c:\Program Files\FourJs\GDC\etc).


Manually Adjusting Client Settings
If you choose you may manually adjust the client settings. These steps may be also used
to correct problems experienced by a previously installed client.

To view and adjust client settings you must first set an option in the GDC launching
command.
   - Right click on the MUNIS icon on the user desktop and select properties. The
       following pane appears




Last Updated: February 4, 2008                                              Page 9 of 17
MUNIS®                                                      Installing the MUNIS Client




   -   Change the target to include a “-a” before the “-M” option.
   -   After this change click the Apply button to accept the changes.




   -   Close the GDC client located in the system tray by double clicking on it and
       selecting Exit
   -   Double click on the MUNIS Live icon on the user desktop and select Cancel
       when prompted to enter your username.
   -   Double click on the GDC icon in the system tray to open the GDC.




Last Updated: February 4, 2008                                            Page 10 of 17
MUNIS®                                                    Installing the MUNIS Client




   -   Highlight the MUNIS Live entry and click the Edit button.




Last Updated: February 4, 2008                                         Page 11 of 17
MUNIS®                                                     Installing the MUNIS Client




   -   On this screen, ensure the Connection type is Directly to the DVM.
   -   Click Next to continue




   -   On this screen the Protocol must be Telnet and the Terminal type VT100+.



Last Updated: February 4, 2008                                              Page 12 of 17
MUNIS®                                                     Installing the MUNIS Client


   -   Click Next to continue




   -   On this screen the change/adjust the following:
            Host                      Must contain the IP address of your MUNIS server
            User Name:                Blank
            Show Terminal Utility Checked
            This connection needs Blank
            Keep my password          Blank
            Command Line:             Blank
       It is important the box for “This connection needs a password” is left BLANK.
       If this box is checked the user will experience problems when their password
       expires.
   -   Click Next to continue




Last Updated: February 4, 2008                                           Page 13 of 17
MUNIS®                                       Installing the MUNIS Client




   -   Click Finish to accept the changes.




Last Updated: February 4, 2008                            Page 14 of 17
MUNIS®                                                     Installing the MUNIS Client


Troubleshooting MUNIS Connection Issues
If you have a user that cannot access MUNIS on their workstation, perform the
troubleshooting steps in the sequence below to narrow and resolve the issue.

Note: There are 2 parts in troubleshooting problems running MUNIS. The first
      part is logging on the RS6000 server, the second is launching Live or Train
      MUNIS from the menu.

   A. Can the user login to the RS6000 server from their workstation?
      The user must be able to enter a login name in a small Windows pane then enter a
      password on the black FGLTTY screen. The black FGLTTY screen shows the
      options Live, Train, Change password etc.
      No: The user does not receive the black FGLTTY screen with the various
             options to run MUNIS. Go to troubleshooting step C.
      Yes: The user can login and is presented with the various menu options Live,
             Train etc. Go to troubleshooting step B.

   B. Can the user run MUNIS from their workstation?
      No: - Selecting Live flashes something on the screen and returns to the
                menu. Go to troubleshooting step D.
            - Selecting Live displays an Access Denied screen indicating “The user
                “username” is not in the MUNIS ID code file.” Perform
                troubleshooting step #3 then run MUNIS from this workstation.
            - Selecting Live displays a “User Account Disabled – Access Denied”
                screen. Perform troubleshooting step #4 then run MUNIS from this
                workstation.
            - Selecting Live displays MUNIS but only provides access to System
                and/or Favorites menus only. Perform troubleshooting step #5 then
                run MUNIS form this workstation.
            - Selecting Live works properly but selecting Train results in one of the
                above errors. Perform troubleshooting step #6 then run MUNIS from
                this workstation.
      Yes: All problems are resolved. Congratulations!

   C. Can the user login to the RS6000 from a known working workstation?
      To do this, have the owner of the known working workstation login to the local
      network then allow the user experiencing issues attempt to login to MUNIS on
      this workstation.
      No: Perform troubleshooting steps #1 then return to step A.
      Yes: The user enters a login and password and is presented with the menu from
             which to select Live, Train etc. Perform troubleshooting steps #2 on the
             users’ workstation. Go to troubleshooting step A.

   D. Can the user run MUNIS from a known working workstation?
      No: Contact MUNIS OSDBA Support at 800-722-4908 for further assistance.


Last Updated: February 4, 2008                                            Page 15 of 17
MUNIS®                                                     Installing the MUNIS Client


       Yes:   Perform troubleshooting steps #2 on the users’ workstation. Go to
              troubleshooting step A.

    Note: If you have completed each step and are caught in a reiterative process,
          please contact MUNIS OSDBA Support at 800-722-4908 for assistance.


   Troubleshooting Steps:
   1. To perform the following troubleshooting steps login as root and type the
      commands indicated:
       Verify the user has a login on the RS6000 and has permissions to login.
         - At the command line type smit user
         - Select List All Users and locate ensure the user name.
         - If the user is not found add the user to the RS6000 server.
       Verify the user has login access.
         - Select Change/Show Characteristics of a User
         - Enter the user name.
         - Ensure “User can LOGIN?” is true.
         - Ensure “Is this user ACCOUNT LOCKED” is false.
       Verify the user password has not expired.
         - From a known working workstation click Start (lower left corner) and
             select Run.
         - In the Open field type telnet rs6000.dname.k12.ky.us where dname is
             the name of your district.
         - When the black telnet screen displays, a login prompt should appear.
             Enter your login. If a login prompt does not appear check the items in step
             #2.
         - If your password has expired, a message appears indicating this and
             prompting for a new password. If you are not prompted for a password
             then your password has not expired.
   2. The following steps may require assistance from technical staff in your District:
       Ensure the workstation attempting to access MUNIS has a static IP address.
       Ensure the user has Administrative Rights to the workstation. The upgrade
         loads software, creates folders etc., the user must have the appropriate rights
         to perform this task. If the installation of the GDC client was performed by a
         user without administrative rights an error may have occurred. You may wish
         to uninstall and reinstall the software.
       Ensure the IP address of the workstation is found in the host file (/etc/hosts)
         on the RS6000 server.
       Ensure the IP address and user login ID appear only once in the host file on
         the RS6000 server.
       Ensure the IP address of the MUNIS server is found in the hosts file on the
         workstation
         - Open Windows Explorer
         - Go to the folder c:\Windows\system32\drivers\etc



Last Updated: February 4, 2008                                            Page 16 of 17
MUNIS®                                                       Installing the MUNIS Client


           -  Open the file hosts with Notepad and check that the IP address of your
              RS6000 server appears with “rs6000” to the right. If the entry does not
              appear add it as the last line in the file.
      Ensure all settings in the MUNIS GDC are set appropriately.
   3. Verify the user has an account in the MUNIS application.
      - Have a MUNIS administrator run MUNIS and select
         Admin -> Security -> User ID Permissions and Parameters
      - Click the MUNIS System button
       - Click Browse        to view all established users and determine if the user has a
         profile.
   4. Verify the user account is enabled.
      - Have a MUNIS administrator run MUNIS and select
         Admin -> Security -> User ID Permissions and Parameters
      - Click the MUNIS System button.
      - Click Browse         and select the user.
      - Check that the user account status is set to Enabled.
   5. Verify the user does not have restrictions preventing them from running MUNIS.
          - Permissions can be verified in the User ID Permissions and Parameters
              program by selecting User ID Permissions and Parameters and checking
              the various module based permissions.
          - Menu permissions can be verified by selecting Admin -> Security ->
              Menu Security and finding the User ID in question.
   6. Verify the Train database is up to date and reflects the data and settings found in
      the Live database.
          - Perform a mucopy to copy the Live database to the Test database
                      o Login as root
                      o Type mucopy




Last Updated: February 4, 2008                                              Page 17 of 17

								
To top