Genomatix-Logo
Overview of Help-Pages

Frequently asked technical questions


[Scientific FAQ]

1. Registered access to Genomatix programs

  1. I receive the error "Authorization failed" when trying to login with the account/password I received by email!
    What's wrong with my account or password?
  2. I changed my password, but I forgot it!
    How can I access MatInspector or GenomatixSuite anyway?
  3. When accessing the URL of the program (e.g. "mat_fam.pl") I get the error page "[404] Not Found"!
    What's wrong with the URL?

2. Graphical output of Genomatix programs

  1. How can I view Genomatix graphics?
  2. I have installed Java on my computer but still can't see your graphics - why?
  3. I am getting "Out of memory" instead of graphics - why?
  4. I am getting "Several Java Virtual Machines running in the same process caused an error" and cannot see Java even starting!
  5. Java graphics areas seem to always show the Java logo for 5 or 10 seconds before the graphics are actually displayed!
  6. Firefox on MacOS X doesn't display the full graphic in ElDorado!
  7. When I print out the web pages I cannot see any graphics - why?
  8. The export function within your graphics is not working!
  9. How can I open the Java console to provide you with debugging information?

3. Proxy server problems

  1. What is a proxy server?
  2. Where can I find the proxy server settings my company uses?

4. ChipInspector 2.x

  1. I have installed Java 64-bit on my computer, but ChipInspector is not using it.
  2. How can I change my default working directory?
  3. I've installed ChipInspector without any problems, but ChipInspector does not start.
  4. How can I increase the memory for ChipInspector?
  5. I'd like to see an example analysis.
  6. When updating ChipInspector I see a warning sign: "Installing untrusted plugins is potentially insecure. Use unsigned or untrusted plugins at your own risk."

5. MatInspector 8.0

  1. In my Internet Explorer 6 browser, the drop-down list for selecting genes is partially covered by other form elements.
  2. I receive "unresponsive script" alerts when a MatInspector result page is created.
  3. Why am I not able to use the interactive features for sorting my MatInspector results?

6. Genomatix Genome Analyzer (GGA)

  1. The BED/BAM File Upload fails. Nothing happens...
  2. How can I transfer my GMS results to the GGA for further analysis?
  3. Since I have moved the GMS projects folder to our NAS server, I am no longer able to access the GMS results on the GGA. The name of the projects folder on the GMS has not been changed, it is still /home/gx_sesame/projects/.


Answers

1. Registered access to Genomatix programs

  1. I receive the error "Authorization failed" when trying to login with the account/password I received by email! What's wrong with my account or password?

    Usually it's one of the following reasons:

  2. I changed my password, but I forgot it! How can I access GenomatixSuite anyway?

    Request a new password for your account. You only have to enter your email address and you will receive an email containing your username and your new password.
    If this does not work send an email to support@genomatix.de and ask them to reset your password to a new word (they can't look up the old password though).

  3. When accessing the URL of the program (e.g. "mat_fam.pl") I get the error page "[404] Not Found"!
    What's wrong with the URL?

    If you get the "[404] Not Found" error, first check if the URL really is correct (no typo). If that is the case and you still get the error message try changing your character encoding (i.e. the browser's settings in preferences/fonts/encoding or view/encoding). Depending on these settings, some browsers encode URLs with an underscore differently and send a wrong request to our server.


2. Graphical output of Genomatix programs

  1. How can I view Genomatix graphics?

    Java Get PoweredGenomatix graphics are interactive so you can show and hide most elements in your results following your needs. For maximum flexibility our graphics are Java applets. To view them, a reasonably recent installation of Sun Microsystem's Java Runtime Environment is required. At the moment any version >= 1.5.0 will work. Please note that the built in Java Virtual Machine provided by the various Microsoft Windows operating systems is not sufficient, you have to install a Java VM yourself. You can download the Java Runtime Environment either by clicking the "Java Get Powered" button to the right or by selecting your download manually on this page.

    For a more detailed overview of the applet's features, please see this page.

  2. I have installed Java on my computer but still can't see your graphics - why?

    If you installed Java correctly (you didn't get any error messages from the Java installer) it can still be impossible for you to see our graphics. Check the following:

  3. I am getting "Out of memory" instead of graphics - why?

    The more elements are shown in the generated graphics, the more memory will be needed for displaying them. Without any changes you will probably get this error when more than 20 MB of memory are used, no matter if you have 4 GB of memory installed because the Java Virtual Machine is set to use a limited amount of memory per default. To be able to view more complex result graphics you have to add -Xmx200m to the list of runtime parameters of the Java plugin which will assign 200MB of memory to the virtual machine. (You may use higher values, e.g. -Xmx512m, but be sure not to specify more than half the memory that is physically installed in your computer!)

    Changing the memory settings on Windows or Linux/Unix: java control panel memory settings for Windows

    Then within the Java Control Panel select the "Java" tab. Click the "View..." button shown under "Java Applet Runtime Settings". Enter or add '-Xmx200m' into the "Java Runtime Parameters" field. Click "OK" in the "Java Runtime Settings" window and "OK" or "Apply" in the "Java Control Panel" window to save the changes.

    Restart your browser after these changes!


    Changing the memory settings on Mac OS X:

    Changing the memory settings for Konqueror on Linux:

    java control panel memory settings for Linux

    Open the Konqueror settings, then select the "Java & JavaScript" section. Enter or add '-Xmx200m' into the "Additional Java arguments" textfield. Click "OK" to save the changes.

    Restart your browser after these changes!


  4. I am getting "Several Java Virtual Machines running in the same process caused an error" and cannot see Java even starting!

    Java needs a continuous range of physical memory which it can use. Of course it cannot use memory which isn't even installed in your computer - or which is already used by other programs. So to be on the safe side never allow Java to use more than half of your physically installed memory when specifying the -Xmx parameter.

  5. Java graphics areas seem to always show the Java logo for 5 or 10 seconds before the graphics are actually displayed!

    If you are accessing the internet through a web proxy which is not configured for reverse lookups in your institution's DNS system and which you specified by its IP address (e.g. 192.168.100.215), Java will try to find out the corresponding hostname (proxy.mycompany.com) and wait for this (non-existing) answer for about 5-10 seconds every time the graphics data are fetched from our servers. This will happen again whenever you simply reload the page, not only the first time when the applet (display program) is being loaded. In that case please specify your proxy by its hostname (proxy.mycompany.com) or - if it doesn't have a hostname - contact your friendly system administrator and ask for a reverse DNS entry for your proxy server. Further information can be found in Sun's Java bug database.

  6. Firefox on MacOS X doesn't display the full graphic in ElDorado!

    Unfortunately this happens sometime with all Mozilla-based browsers (Firefox, Camino) on MacOS X. This seems to be a MacOS X related problem, as we don't see it on other platforms. We recommend using Safari on the Mac. If you can't use Safari for any reason, Opera can be used alternatively.

  7. When I print out your web pages I cannot see any graphics - why?

    Web browsers usually cannot print plugin content, they simply print a white area where the graphics should be. For that reason our interactive Genomatix Java graphics provide additional functionality: click on the blue disk icon which you will find in every graphics area in its icon tool bar. This will save the complete page including all graphics elements into a directory of your choice. Within that directory you will find an HTML file and one or more JPEG files. Open the HTML file with your web browser and you will see the page you were viewing before - but this time all graphics are simple non-interactive JPEG images. They have the big advantage to be printable without any problems by the normal print function of your browser.

  8. The export function within your graphics is not working!

    Please make sure to export into a really existing directory (not into "Computer" or "Network"). You need write permission for this directory. If your graphics output is really complex, there might not be enough memory to display and print your graphics. Please try enlarging the memory your Java Virtual Machine may use or try to reduce the complexity of your graphics.

    If you are using Windows Vista and Internet Explorer Java is only allowed to save into C:\Users\<username>\AppData\LocalLow\ and its subdirectories. This comes from the new security policy introduced by the operating system. If you save your graphics into another folder, it will look as if it worked - but it almost certainly has not!

  9. How can I open the Java console to provide you with debugging information?

    If something is still going wrong after you fixed all possible problems described here, please open the Java console and send us all output that is written there when the error occurs. The Java console is a text window where Java applets can output error information. Usually you cannot see this console because it is not necessary during normal work.

    Activating the Java console on Windows, MacOS X or Linux/Unix:

    java control panel memory settings for Windows

    Then select the "Advanced" tab. Open the "Java console" menu item and tick the "Show console" checkbox. Click "OK" or "Apply" or "Save" to save the changes. To switch back to the default behavior, select "Do not start console" and click "OK" or "Apply" or "Save" .

    Restart your browser after these changes!


    Activating the Java console for Konqueror on Linux:

    java control panel memory settings for Linux

    Open the Konqueror settings, then select the "Java & JavaScript" section. Select "Show Java console" and click "OK". To switch back to the default behavior, untick the "Show Java console" checkbox and click "OK".

    Restart your browser after these changes!


3. Proxy server problems

  1. What is a proxy server?

    When you are browsing web pages, downloading files, retrieving data from servers in the internet, you (the client) are usually connecting directly to that server. Your client application (web browser, ftp program, Genomatix ChipInspector) sends commands to the server (web server, ftp server, Genomatix web server for ChipInspector) directly and receives the server's answers (web pages, the file, ChipInspector data) directly.

    Many companies though are restricting internet access through firewalls, i.e. there is no communication possible between computers in the company's intranet and the outside world, the internet. To allow some (controlled) internet access to their employees, these companies usually run proxy servers. Configured correctly your client application will then send all requests to the proxy server which then decides if that special request is to be allowed or not. On approval the proxy server sends your request to the internet server

  2. Where can I find the proxy server settings my company uses?

    Please have a look at the web browser you are currently using. If your company is using a proxy server, your browser knows it - otherwise you could not be reading this text. Here's where you can find proxy settings for some common browsers:


4. ChipInspector 2.x

  1. I have installed Java 64-bit on my computer, but ChipInspector is not using it.

    If 32-bit and 64-bit Java are installed in parallel, the computer is not able to assign the correct JVM version. You can tell ChipInspector which Java version to use by editing the file "chipinspector.conf", which is located in the Genomatix installation directory under

    "<INSTALLATION DIRECTORY>/Genomatix/etc/" or "<INSTALLATION DIRECTORY>/etc/" (for Windows and Linux)
    "<INSTALLATION DIRECTORY>/ChipInspector.app/Contents/Resources/chipinspector/etc/" (for Mac)

    Substitute the line

    #jdkhome="/path/to/jdk"

    by

    jdkhome="C:\Program Files\Java\jdk1.6.0_04"

    or whereever the 64-bit Java is located.

  2. How can I change my default working directory?

    ChipInspector stores downloaded files (e.g. transcript information, annotation data) and user settings in the default working directory. You can change the working directory by editing the file "chipinspector.conf", which is located in the Genomatix installation directory under

    "<INSTALLATION DIRECTORY>/Genomatix/etc/" or "<INSTALLATION DIRECTORY>/etc/" (for Windows and Linux)
    "<INSTALLATION DIRECTORY>/ChipInspector.app/Contents/Resources/chipinspector/etc/" (for Mac)

    Substitute the path in the line

    default_userdir="<defaultPath>" (for Windows and Linux)
    default_mac_userdir="<defaultPath>" (for Mac)

    by your path:

    default_userdir="<yourPath>" (for Windows and Linux)
    default_mac_userdir="<yourPath>" (for Mac)

    Make sure to enter a valid path.

  3. I've installed ChipInspector without any problems, but ChipInspector does not start.

    Every Java program such as ChipInspector runs within a defined environment, the Java Virtual Machine (JVM). When a Java program is started, the computer allocates a portion of its main memory (its RAM) to the JVM. When ChipInspector is first installed, the amount of allocatable RAM is calculated. However, this calculation may be too high depending on other programs running on your computer.

    It is possible to decrease the portion of RAM for the JVM, thus giving ChipInspector less memory to ensure that the JVM (and thus ChipInspector) can be started:

  4. How can I increase the memory for ChipInspector?

    Every Java program such as ChipInspector runs within a defined environment, the Java Virtual Machine (JVM). When a Java program is started, the computer allocates a portion of its main memory (its RAM) to the JVM. When ChipInspector is first installed, the amount of allocatable RAM is calculated. However, this calculation may be off or new hardware RAM may have been added subsequently.

    It is possible to increase the portion of RAM for the JVM, thus giving ChipInspector more memory:

  5. I'd like to see an example analysis.

    An example project is available on our server. It contains finished analyses. They are intended for examination by users who don't have access to raw data files or who would like to see the results of an analysis type for which raw data is (not yet) available at their institution.

    The experiments are performed with publicly available data, which is referenced in the analysis description.

    Currently, the ExampleProject contains two analyses:

    Download the file ChipInspectorExampleProject.zip (file size 260 MB) and extract it into the "GenomatixProjects" directory in you home directory. In case you are working with Windows this is the following directory:

    C:\Documents and Settings\<YOUR_USERNAME>\GenomatixProjects

    Open the project in ChipInspector.

  6. When updating ChipInspector I see a warning sign: "Installing untrusted plugins is potentially insecure. Use unsigned or untrusted plugins at your own risk."

    This message is shown only once, when the Java platform receives the first updates from Genomatix. From then on, the source for ChipInspector program updates is known and your computer will accept program updates automatically. And you do trust Genomatix, don't you?


5. MatInspector 8.0

  1. In my Internet Explorer 6 browser, the drop-down list for selecting genes is partially covered by other form elements.

    With Internet Explorer 6, when using the combo box for gene input in MatInspector, some other elements (notably select boxes) are rendered on top of the gene list, as in this picture:

    Z-index bug

    This is a known issue of Internet Explorer 6 (and earlier versions) which is due to the implementation of the "Z-index" attribute of select-controls, as described in this Microsoft knowledge base article. Unfortunately, there is no work-around for this issue (the "iframe shimming trick" explained in several forum discussions, cannot be applied in our case), so the only possibility to circumvent this behavior is to upgrade your browser. (Microsoft changed the implementation of the Z-index in Internet Explorer 7)

  2. I receive "unresponsive script" alerts when a MatInspector result page is created.

    When a MatInspector result page is loaded in your browser, some initializing JavaScript functions are called, which are necessary for the interactive features of the result tables. If there are many and/or large output tables on the same page, these scripts can take some time to run. In rare cases, a message window might pop up on your computer, notifying you about an "unresponsive script". Usually your simply can ignore this message and just allow the script to continue.

  3. Why am I not able to use the interactive features for sorting my MatInspector results?

    The interactive handling of the result tables is deactivated if there are more than 50 sequences, more than 1000 matches in one sequence, or more than 2000 matches in all sequences in the output. In this case, please filter for the matrix families you are interested in before submitting your search to MatInspector (use the option "continue with subset definition from selected groups").


6. Genomatix Genome Analyzer (GGA)

  1. The BED/BAM File Upload fails.
    The upload function lets me choose a file but I cannot go further from it. Clicking the "Submit" button does not work.

    Please check the size of your file. Files larger than 2 GB cannot be uploaded via the browser for technical reasons as almost all browsers have a general upload limit of 2 GB, i.e. files bigger than this size should be zipped before uploading from your local computer (supported formats are .gz, .z, .7z or .zip).
    In case the compressed file is still too large, copy it to a file system that is available for "Upload from GGA" (e.g. your workbench home directory).

  2. How can I transfer my GMS results to the GGA for further analysis?

    Results generated via the GUI on the Genomatix Mining Station (GMS) can be directly accessed on the GGA. In order to allow this, the GMS projects folder has to be mounted on the GGA. Mounting the GMS projects folder can be done with the "Administration" interface of the GGA ("Administration -> Server Administration -> First time configuration -> Remote file systems (NFS)"), please see the GGA System Administrator's Guide (chapter "Remote file systems (NFS) settings / connection to GMS"). The local mount point must always be named exactly like the GMS's fully qualified domain name or IP address. Enter "gms.yourcompany.com:/home/gx_sesame/projects" as remote file system. If you are already NFS importing the projects folder from a NAS server into the GMS, you have to enter "nasserver.yourcompany.com:/path/to/projects" as remote file system.

    As soon as the GMS projects file system is mounted on the GGA, the BED file upload option "import from the GMS" will be available. The file browser shows the name of the GMS and you can select files from your own projects as well as from publicly available projects.

  3. Since I have moved the GMS projects folder to our NAS server, I am no longer able to access the GMS results on the GGA. The name of the projects folder on the GMS has not been changed, it is still /home/gx_sesame/projects/.

    The GMS does not export file systems mounted via NFS. Therefore, you have to edit the GMS mount point on the GGA and change the remote file system to the projects folder on your NAS server. Please go to the "Administration" interface of the GGA ("Administration -> Server Administration -> First time configuration -> Remote file systems (NFS)") and edit the GMS mount point. Change the "Remote file system" to "nasserver.yourcompany.com:/path/to/projects" and reboot the GGA. The "Local mount point" must not be changed.