Chimera Configuration Instructions

1. Installing Chimera (or making sure you have the right version);
2. Installing the DBPuppet extension;
3. Configuring your browser to recognize files with the .chimerax suffix.

Unix

% tar -xvzf /usr/tmp/DBPuppet.tar.gz

Then move the unzipped directory, named DBPuppet to the CHIMERA_ROOT/share/ directory, where CHIMERA_ROOT is the installation location of Chimera on your system. On Unix systems, the default is /usr/local/chimera:

% mv /usr/tmp/DBPuppet /usr/local/chimera/share/

Windows

The easiest way to do this is to use the Browser Configuration utility that comes with the DBPuppet package. Look under Chimera's Tools menu for the DBPuppet group. The Browser Configuration tool will guide you through a series of dialogs that will help you set up your system's web browsers to recognize files with a .chimerax suffix.

If this is successful, you can skip the rest of these installation instructions and go to the section entitled Using the DBPuppet Extension.

If the Browser Configuration Tool does not work on your system, there are other ways to manually configure your browser:

Manual Configuration

Unix

• Modify the browser's 'Helper Application' preferences:
  1. From the Edit menu, select Preferences. On the left side of the preferences panel that comes up, choose the Helper Applications section in the Navigator category:
     
     
  2. Click the New Type button. Fill in the fields with the following information:

     Description of type:  Chimera Puppet File	
     File extension:  chimerax
     MIME type:   application/x-chimerax
     Application to use: CHIMERA_ROOT/share/DBPuppet/send_to_chimera
     

     Substitute the installation location of Chimera on your system for CHIMERA_ROOT. The default installation of Chimera is /usr/local/chimera
     
     
  3. Click OK. Now, application/x-chimerax should show up as a registered file type:
     
     
  4. Click OK on the Preferences panel to finish.
• Manually writing mailcap/mime-type files

  Check for the following files in your home directory:

  1. HOME_DIR/.mime.types

     Unix systems use this file to identify different types of files downloaded from the web. If this file does not exist, create it and add the following line:

     application/x-chimerax chimerax

     If this file does exist, add the above at the end of the file on a new line.
  2. HOME_DIR/.mailcap

     Unix systems use this file to associate file types with applications. If this file does not exist, create it and add the following line:

     application/x-chimerax CHIMERA_ROOT/share/DBPuppet/send_to_chimera %s

     where CHIMERA_ROOT is the path to the top level of your Chimera installation. For example, if Chimera was installed in /usr/local/chimera (the default), the line in your .mailcap file would look like:

     application/x-chimerax /usr/local/chimera/share/DBPuppet/send_to_chimera %s

     If this file does exist, add the above at the end of the file on a new line

Windows (Internet Explorer and Mozilla/Netscape)

Internet Exporer and Netscape on Windows systems use the registry to determine which application should be invoked when a particular type of file is encountered. In order to register the .chimerax file type:
1. From the Control Panel, click on Tools, then Folder Options. Then click on the File Types tab on the Folder Options window:
   
   
2. Click on the New button. Enter chimerax in the File Extension field.
   
   
3. Click OK. Then click on the Advanced button in the Details for 'chimerax' file type portion of the Folder Options window.
   
   
4. Click on the New button. Fill in the fields with the following information:

   Action: open
   Application used to perform action: 
   C:\PYTHON_ROOT\pythonw.exe  "C:\CHIMERA_ROOT\share\DBPuppet\send_to_chimera.py"  "%1"
   

   Be sure to include the quotes. Substitute the location of the Python that Chimera installed for PYTHON_ROOT (default is C:\Python22) and the installation location of Chimera for CHIMERA_ROOT (default is C:\Program Files\Chimera) .
   
   

5. Click OK. Check the Always show extension box on the Edit File Type window.
   
   
6. Click OK in the Edit File Type window. Close the Folder Options window.