Using the Jagg CGI


The JAGG CGI is a standard CGI application that requires a web server. The JAGG CGI also handles the SSL through an https-compliant server, such as Netscape’s line of servers. The JaggServer differs in that it is much faster than the CGI and runs through a separate port from port 80, the port for http. JaggServer requires Sun’s JDBC API and the JDBC-ODBC bridge, both of which are installed automatically. If you need them, they are available free of charge from JavaSoft’s website. There are direct links to these pages from BulletProof's download page under "server requirements":

The JAGG CGI offers one big benefit over the JaggServer. When used with a secure webserver, like the Netscape ONE™ platform, the data to and from your JDesignerPro application will be encrypted with https level encryption and security. See Encrypted Data Transmission below.

If you wish to use the JAGG CGI you will need to re-install JDesignerPro and choose a webserver during the reinstallation process. If you are having troubles, check that it is properly installed into the Root directory and Scripts or CGI directory of the webserver. The file JDPJagg.exe must be in your webserver's CGI directory. Most servers have a directory called either CGI or CGI-BIN, or Scripts in the case of Microsoft IIS Webserver. The installation of JDesignerPro will ask where the directory is. Simply point the installer at the CGI directory of the webserver. The installer will normally install JDPJagg.exe in the correct directory. The directory that you choose as your webserver root directory must be the root directory of your https webserver.

The JDesignerPro.ini file must reflect the following:

  • JAGGSERVER=CGI
  • You must also change any references of http to https in the JDesignerPro.ini file.

    You will know that the CGI directory you specified at install was incorrect if, when you first run JDesignerPro, you do not see a list of data sources in the list on the left hand side of the setup window. In the setup window, enter the correct path and press Apply to bring up a list of your ODBC data sources. If you have difficulties switching to the JAGG CGI, please send a detailed inquiry to support@bulletproof.com including any error messages.

    Note: Some features of the Application Builder will not work when running JDesignerPro with the Jagg CGI. We recommend developing with a Development version of JDesignerPro that is installed locally on the developers machine.

    Encrypted Data Transmission

    JDesignerPro applications may be run with encrypted data transmission. To do this, you will use the https function of a secure web server. Follow these steps:

    1. Run the JDesignerPro installer again and install it into your secure web server directory.
    2. In the JDesignerPro.ini file, found in the JDesignerPro directory, change each http reference to https.
    3. Also in the JDesignerPro.ini file, change the "JAGGSERVER=" line to "JAGGSERVER=CGI".
    4. Launch JDesignerPro from an HTML file that is in the secure server directory. You will now be launching your JDesignerPro applications from a URL similar to:

    https://[localhost]/JDesignerPro/default.htm

    You will need to transfer any modules that you have built under the one of the JDesignerPro installs to the other to keep the systems synchronized. We recommend against having two installs on the same server. If you want to run JDesignerPro securely you can also do the building securely. This way you avoid having to keep both directories synchronized and other conflicts.