FREQUENTLY ASKED QUESTIONS
FOR

INSTALLING AND RUNNING GRASS-XMI


  • INSTALLING GRASS-XMI
  • SETTING UP ENVIRONMENT
  • RUNNING GRASS-XMI

  • INSTALLING GRASS-XMI

  • I installed GRASS-XMI on my RedHat 5.1 box, the installation went ok, but when I started the program, the GRASS monitor was not displayed, and I could not start it from Monitor Manager either?new!
  • I have never used GRASS before, how do I define Directory of GIS Database, Location, and Map Set when running the setup program?new!
  • My GIS data are in ARC/Info format, how do I import my existing GIS data into GRASS?new!
  • I was installing GRASS-XMI 1.3 from a CD-ROM. When I tried to run setup from the CD-ROM, I got the "Permission denied" message. Why?new!
  • I installed GRASS-XMI on my Linux box. The installation was smooth, but I found the environment variables do not appear to have been set properly. What could be wrong?
  • I installed GRASS-XMI evaluation program on a network computer "geosun". When I logged in the network from another computer "geosun2" and tried to start GRASS-XMI, I got an error message "Invalid license code"? Does this mean I cannot execute the program from "geosun2"?
  • Your release_note seems to be a big file, are there simple instructions for installation?
  • What version of GRASS was GRASS-XMI tested with?
  • My mouse only has two buttons, how can I configure a middle button to perform "Undo" in "Post Scale", "Post Label", etc?
  • Does the GRASS-XMI distribution include GRASS4.1 or 4.2 programs?
  • Q. I installed GRASS-XMI on my RedHat 5.1 box, the installation went ok, but when I started the program, the GRASS monitor was not displayed, and I could not start it from Monitor Manager either?
    A. We had the similar problem when running GRASS-XMI in RH5.1. The solution is to comment the following two lines in the GRASS-XMI shell script file: grassxmi

    #LD_LIBRARY_PATH=/usr/openwin/lib:/usr/dt/lib:/opt/SUNWmotif/lib #export LD_LIBRARY_PATH

    Q. I have never used GRASS before, how do I define Directory of GIS Database, Location, and Map Set when running the setup program?
    A. It is suggested that you create these directories before starting the setup. However, if you have already started the setup, you can do this in another command window. For example, if you want to put your GRASS database in /usr/local/data, the study area is hometown, and your login name is john, then you can do the following

        mkdir /usr/local/data
        mkdir /usr/local/data/hometown
        mkdir /usr/local/data/hometown/john

    Next, you start the GRASS-XMI setup program and press the Continue button. Then you should enter /usr/local/data in the Directory of GIS Database text field. Once you complete the entry, /usr/local/data/hometown will appear in the List of Available Locations. Click on the directory name, it appears in the second text field, and /usr/local/data/hometown/john will appear in the List of Available Map Sets. Click on the directory name, it will appear in the thrid text field. Click on Ok to record your setting.

    Q. My GIS data are in ARC/Info format, how do I import my existing GIS data into GRASS?
    A. An important step before importing your ARC/INFO data into your GRASS database is to define boundaries of your study area. This can be done after you finish the setup program and when you start GRASS-XMI for the first time. Click on the Genrl icon button in the menu bar and select Region from the pulldown menu. After the Region pops up, click on the New button and enter the boundary and resolution parameters for the region, then click on Ok. Your region information will be created. After this, you can import ARC/INFO data to GRASS.

    For instructions on how to import ARC/INFO data to GRASS, please read the Help file for Convert ARC to DIG in the Vect menu.

    Q. I was installing GRASS-XMI 1.3 from a CD-ROM. When I tried to run setup from the CD-ROM, I got a "Permission denied" message. Why?
    A. The setup program on the CD-ROM is not an executable file. You have to copy it to a temporary directory and change its mode to executable before running the program. See the readme.1st included on the CD-ROM for detailed instructions.

    Q. I installed GRASS-XMI on my Linux box. The installation was smooth, but I found the environment variables do not appear to have been set properly. What could be wrong?
    A. This most likely occurs when you are running the BASH shell. The GRASS-XMI installation program inserts definitions of environment variables and sets appropirate path in your login script file. If you are using the BASH shell, $HOME/.bashrc is the default login script file, and it is the only script file that will be updated. the installation program will create it if you do not have one.However, some versions of LINUX do not read $HOME/.bashrc during the login process. Instead, it reads $HOME/.profile. To avoid the problem, you can duplicate the definitions and path settings in $HOME/.profile after a successful installation.

    Q. I installed GRASS-XMI evaluation program on a network computer "geosun". When I logged in the network from another computer "geosun2" and tried to start GRASS-XMI, I got an error message "Invalid license code"? Does this mean I cannot execute the program from "geosun2"?
    A. The evaluation program must be executed on "geosun" where the program was installed. However, you can use "geosun2" as a display server while executing the program from "geosun". To set a display server, you need to do two things:

       1. Execute the following command at "geosun2":
             xhost geosun
       2. Set environment at "geosun" as follows assuming there is only one display screen at "geosun2":
            For C-shell, type:     setenv DISPLAY geosun2:0.0

            For Korn or Bourne Shell, type:      DISPLAY=geosun2:0.0; export DISPLAY

    Ask you system administrator if you are unsure how to do it.

    Q. Your release_note seems to be a big file, are there simple instructions for installation?
    A. We have modified readme file to contain complete instructions for installing GRASS-XMI. It reads like 1-2-3 and the installation should be done automatically by the "installg" scripts.

    Q. What version of GRASS was GRASS-XMI tested with?
    A. The version 1.2.2 of GRASS-XMI for Solaris 2.x running on the SPARC workstation was tested with GRASS 4.1 (Spring 1993) Update Package 5, January 1995, downloaded from the CERL's moon site. It was also tested with GRASS 4.2 downloaded from Baylor University's ftp site. GRASS-XMI for Solaris 2.x running on the Intel X86 computer was tested with GRASS 4.1.5 compiled by GPZ Technology using the source code provided by CERL. The LINUX version was tested with Kang's GRASS 4.1.5, and it was also tested with GRASS 4.2 compiled by GPZ Technology using Baylor's source code for GRASS 4.2.

    Q. My mouse only has two buttons, how can I configure a middle button to perform "Undo" in "Post Scale", "Post Label", etc?
    A. It depends. Some system allows you to emulate the middle mouse button with the left mouse button while a key was down. Consult your system administrator for this issue. In the worst case, you just won't be able to perform the "Undo" operation.

    Q. Does the GRASS-XMI distribution include GRASS4.1 or 4.2 programs?
    A. No, GRASS-XMI works with your existing GRASS4.1 or 4.2 environment. You must install GRASS before you install GRASS-XMI.

    SETTING UP ENVIRONMENT

  • I am a new GRASS user, I downloaded GRASS4.1 from CERL's ftp site. After installed both GRASS and GRASS-XMI, I started GRASS-XMI and got message "GISRC not set ..." and the program terminated. What should I do?
  • The pulldown menu in the "Monitor Manager" dialogue box gives options from x0 to x12, however, monitors from x7 to x12 were not configured on my computer, would excessive options cause problems?
  • I modified some GRASS programs to use additional parameters, can GRASS-XMI work with my version of GRASS?
  • Q. I am a new GRASS user, I downloaded GRASS4.1 from CERL's ftp site. After installed both GRASS and GRASS-XMI, I started GRASS-XMI and got message "GISRC not set ..." and the program terminated. What should I do?
    A. You must set environment variables GISBASE and GISRC before running GRASS-XMI. GISBASE should point to your GRASS installation directory. GISRC should point to .grassrc file which normally resides in your home directory. You can copy the sample .grassrc file in the GRASS-XMI directory to your home directory and make necessary changes on it. For more information regarding GRASS setup, please check GRASS user's guide. In the future GRASS-XMI release, you will be able to set the environment during the execution of the program.

    Q. The pulldown menu in the "Monitor Manager" dialogue box gives options from x0 to x12, however, monitors from x7 to x12 were not configured on my computer, would excessive options cause problems?
    A. No. The "Monitor Manager" in the version 1.2.1 release was configured to work with monitors ranging from x0 to x12 in order to support multiple user working environment. If your GRASS is configured to use more than eight monitors (x0-x6 and CELL), then you can take advantage of the settings in the new release. On the other hand, if your "monitorcap" file is configured for x0 to x6 but not x7 to x12, then just don't select the options from x7 to x12. If you accidentally select a monitor that is not configured on your system, you will get error message. However, it will not cause other problems.

    Q. I modified some GRASS programs to use additional parameters, can GRASS-XMI work with my version of GRASS?
    A. GRASS-XMI will work with your version of GRASS if the new parameters are optional. However, we will consider including your optional parameters in the future versions of GRASS-XMI if you have purchased a Right-To-Use license for GRASS-XMI.


    RUNNING GRASS-XMI

  • After I upgraded my Red Hat 4.2 LINUX box to 5.1, now I have problem -- a message Please start monitor x0 keeps coming back when GRASS-XMI started. All environment variables, monitorcap and locks are in normal status. How can I get monitor x0 started?new!
  • Why the scrolled list in "Ask and Open File" gave me incorrect file names (e.g. aspect@, myimage@, etc.)?
  • Can I change GIS database during a session of GRASS-XMI?
  • I installed GRASS-XMI successfully, however, when I started the program, I did not see any monitor running. Why?
  • I had no problem installing and starting GRASS-XMI, however, I got a message "bg is not a valid parameter" when trying to display a raster map. What went wrong?
  • When I exit GRASS-XMI, the program gives an option to "Stop monitors at exit". If I choose the option, will I stop monitors being used by another user?
  • Sometimes when I choose the option to "Stop monitors at exit", the monitor remains running. Why?
  • I noticed many times that a dialogue did not go away even if the backend processing had completed execution, does this mean something is still going on?
  • I was using the "Post Scale" program to post scale. The stop watch stays on even if I have finished posting. How do I get out of the program?

    Q. After I upgraded my Red Hat 4.2 LINUX box to 5.1, now I have problem -- a message Please start monitor x0 keeps coming back when GRASS-XMI started. All environment variables, monitorcap and locks are in normal status. How can I get monitor x0 started?
    A. Version 1.3.1 contains a fix to this problem. If you are version 1.3 user, you should upgrade your software to version 1.3.1. However, if you are using an early verion of GRASS-XMI, you can fix the problem by removing the following lines from the grassxmi script file:

        LD_LIBRARY_PATH=/usr/openwin/lib:/usr/dt/lib:/opt/SUNWmotif/lib
        export LD_LIBRARY_PATH

    Q. Why the scrolled list in "Ask and Open File" gave me incorrect file names (e.g. aspect@, myimage@, etc.)?
    A. This is because that you only have one map set and probably never ran "g.mapsets". In GRASS-XMI, entries in a list is constructed as map_name@map_set. The first part of an entry is the original file name in the map set directory while the second part indicates the map set that the file belongs to. GRASS uses the "SEARCH_PATH" file in your map set directory to determine all map sets being used in your application. GRASS-XMI reads that file, finds all related map sets and constructs file name entries for the list. The "SEARCH_PATH" file is created when "g.mapsets" is executed. Therefore the simplest way to correct the problem is to run "Mapsets" in the GRASS-XMI's general program group. It will take care of your problem.

    Q. Can I change GIS database during a session of GRASS-XMI?
    A. Yes, you can select a new database, a new location or a new map set by clicking on "Genrl" icon in the menu box then choose "View and Modify Gisenv" to modify the settings. You can use the "Mapsets" option in the same program group to add or remove a map set from the search path.

    Q. I installed GRASS-XMI successfully, however, when I started the program, I did not see any monitor running. Why?
    A. If another user is running GRASS-XMI on the same computer before you start the program, then monitor x0 may be used by that person. In this case, you need to bring up the "GRASS Display Programs" sub-menu and use the "Monitor Manager" dialogue to start another monitor. If this is not the case, you need to contact support@gpz.com or call (650) 949-3708 for assistance.

    Q. I had no problem installing and starting GRASS-XMI, however, I got a message "bg is not a valid parameter" when trying to display a raster map. What went wrong?
    A. GRASS-XMI supports background color for displaying a raster map. It is an enhanced feature that is useful to distiguish foreground information with a color similar to the default background color. The problem is that many versions of GRASS4.1 programs do not support this parameter. In version 1.2.1 release, this problem has been solved, and you should be able to display a raster map with or without specifying a background color.

    Q. When I exit GRASS-XMI, the program gives an option to "Stop monitors at exit". If I choose the option, will I stop monitors being used by another user?
    A. No, you can only stop the monitors that are used by yourself.

    Q. Sometimes when I choose the option to "Stop monitors at exit", the monitor was still running. Why?
    A. You can only stop the monitors that are started in the current session. If you leave a monitor running when you exit GRASS-XMI in a previous session, then you cannot stop it using the "Stop monitors at exit" option. However, you can use "Monitor Manager" to stop the monitor before exiting the program. Note: It is not a good practice to stop a monitor using window manager's "Quit" or "Exit" menu.

    Q. I noticed many times that a dialogue did not go away even if the backend processing had completed execution, does this mean something is still going on?
    A. If the stop watch that shows up after you press the "Ok" button disappears, it generally means the backend processing is completed. You can reuse the parameter settings in the dialogue box or change the value of a parameter and re-start execution of the same program. Most dialogue boxes will not disappear automatically until you click on the "Cancel" button.

    Q. I was using the "Post Scale" program to post scale. The stop watch stays on even if I have finished posting. How do I get out of the program?
    A. The "Post Scale" dialogue box indicates that you must press the right mouse button to quit the operation. The stop watch will disappear as soon as you press the right mouse button inside the monitor in which you placed a scale.