Previous: Testing your browser configuration

Setting Up hyperlinking to CSD or PDB entries

In order to hyperlink to CSD or PDB entries from IsoStar Scatterplots, you must provide the IsoStar Client program with the address of the CGI script your HTTP server uses to perform the hyperlinking request.

If you are using the CCDC Apache HTTP server most of the configuration for this should already be in place. If you are using your own HTTP server then you will need to have setup the isostar_server.cgi script as detailed in Making IsoStar Data Available via the CCDC Apache HTTP Server.

Once the isostar_server.cgi script is setup, the client needs to be instructed where to find it. To do so:

  • Select Hyperlink Server... from the IsoStar Control Options menu. A dialogue box will appear.

  • In the first dialogue box, type the URL (and port number if required) of the server that is running the IsoStar http server. If using the CCDC Apache HTTP server this will be servername and port number you selected during setup. For example:
    
       your_server_name:8081
    
    Replace your_server_name with the address of your HTTP server name that is used to access IsoStar. This should be the full address of the top level of your HTTP server, without the prefix "http://" (for example, if your top level location is http://www.ccdc.cam.ac.uk, then you should enter www.ccdc.cam.ac.uk. If it is http://mycomputer:8081, then you should just enter mycomputer:8081).

  • In the second dialogue box, type the location of the cgi script. For the CCDC Apache server this will be the default example given:
    
       /cgi-bin/isostar_server.cgi
    

    For your own Apache server enter the location of the isostar_server.cgi you setup earlier.

    Alternatively you can use the CCDC's hosted IsoStar Server for hyperlinking to CSD entries. To do so, enter the following details:

    
       IsoStar Server: isostar.ccdc.cam.ac.uk
    
    
       Script: /cgi-bin/isostar_server.cgi
    
  • To test the hyperlink functionality, follow Tutorial 1 through to Section C: Hyperlinking to a CSD Structure.


    Next: Recent Bug Fixes