Progress
External Program
Interfaces


Configuring HTTP and HTTPS Tunneling

The SonicMQ product and the Progress SonicMQ Adapter support passing messages using HTTP and HTTPS. Although these are not the default protocols, you can configure the Sonic and Progress environments for them.

For information on configuring the SonicMQ product for HTTP and HTTPS, see the SonicMQ documentation.

To configure the Progress SonicMQ Adapter for HTTPS:

  1. Shut down all instances of the Sonic broker and the Progress AdminServer.
  2. Define the following settings in the Sonic broker.ini file in the Sonic installation directory:
  3. ENABLE_SECURITY=TRUE 
    DEFAULT_SOCKET-TYPE=HTTPS 
    

  4. Rebuild the Sonic databases by entering the commands for your operating system:
  5. Windows
    UNIX
    cd sonic-install-dir 
    bin\dbtool /d basic 
    bin\dbtool /cs basic 
    bin\dbtool /c security 
    
    cd sonic-install-dir 
    bin/dbtool /d basic 
    bin/dbtool /cs basic 
    bin/dbtool /c security 
    

  6. Modify the JVMARGS and PROGRESSCP environment variables, following the instructions for your operating system:
  7. On Windows, modify them in the registry at the following key:

    \\HKEY LOCAL MACHINE\SOFTWARE\PSC\PROGRESS\psc-version\JAVA 
    

    where psc-version represents the Progress version, such as 9.1D.

    On UNIX, modify them at the command line.

    The modifications are:

    1. To the JVMARGS environment variable, append the following:
    2. -DSSL_CA_CERTIFICATES_DIR=sonic-install-dir\certs\CA 
      

    3. To the PROGRESSCP environment variable, append the following:
    4. sonic-install-dir\lib\jaxp.jar 
      sonic-install-dir\lib\certj.jar 
      sonic-install-dir\lib\sslj.jar 
      sonic-install-dir\lib\jsafe.jar 
      

  8. Modify your SonicMQ 4GL application to run setUser and setPassword before running beginSession. Doing so lets you specify the user name and password Sonic will use to authenticate users.
  9. Sonic sets the initial value of both user name and password to Administrator. To set up additional user name-password pairs, use the Sonic Explorer. For more information, see the SonicMQ Configuration and Administration Guide .

  10. Modify your the SonicMQ 4GL application so that each time setBrokerURL is run, the brokerURL input parameter specifies HTTPS.
  11. Start the Sonic broker.
  12. Start the Progress AdminServer.
  13. Start the Progress SonicMQ Adapter.

Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095