Copyright © Cloud Software Group, Inc. All Rights Reserved

Enable Facade HTTPS Transport

TIBCO API Exchange Gateway supports the native HTTPs channel at the facade side.

To enable the HTTPs channel at the facade side of the TIBCO API Exchange Gateway, set the SSL properties on the Config UI as follows:

Set SSL Properties

1.	Start the Config UI.

2.	Log in to the Config UI using your credentials.

3.	On the home page of the Config UI, select the Gateway Engine Properties from the drop-down list.

4.	Click the Transport link to display the runtime properties.

5.	Set the SSL properties as explained in the SSL section of Transport Properties table.

6.	Save the configuration changes to the project.

• The SSL properties can be set in the ASG_CONFIG_HOME/asg.properties file. Refer to the Connection Parameters for HTTPS Channel(Facade) properties. • If the tibco.clientVar.DefaultImplementation/Connections/HTTP/FacadeHTTPSSLConnection/IdentityFileType property is set to certPlusKeyURL, download Tomcat and configure the TIBCO API Exchange Gateway to include the Tomcat native library. See Download Tomcat Native Library for details.

Download Tomcat Native Library

Perform the following steps to download and copy the required native library.

Windows platform

Copy the library as follows:

1.	Download the tomcat-native-1.1.31-win32-bin.zip archive from the Apache Tomcat website.

For example, download the tomcat-native-1.1.31-win32-bin.zip archive file from the following URL to a temporary location, such as C:\temp\apache_lib.

http://mirror.reverse.net/pub/apache/tomcat/tomcat-connectors/native/1.1.31/binaries/tomcat-native-1.1.31-win32-bin.zip

2.	Navigate to the temporary location directory, C:\temp\apache_lib, where the tomcat-native-1.1.31-win32-bin.zip archive is downloaded.

3.	Extract the tomcat-native-1.1.31-win32-bin.zip archive in the same directory, C:\temp\apache_lib.

4.	Copy the tcnative-1.dll library to the TIBCO_HOME\tibcojre64\1.7.0\bin directory.

a.	For Windows 64-bit platform, the tcnative-1.dll library is found at the C:\temp\apache_lib\tomcat-native-1.1.31-win32-bin\bin\x64 location.

b.	For Windows 32-bit platform, the tcnative-1.dll library is found at the C:\temp\apache_lib\tomcat-native-1.1.31-win32-bin\bin location.

Linux platform

Download, build, and copy the library as follows:

Download and Build APR

1.	Install the Apache Portable Runtime (APR) and OpenSSL (if not already installed on the system).

2.	For Debian-based Linux platform, execute the following command:

apt-get install build-essential libapr1-dev libssl-dev

3.	For Redhat Linux, perform the following steps:

a.	Download the source (.tar.gz) file for APR from the following URL:

http://apr.apache.org/download.cgi (download the)

b.	Execute the following command to extract the package:

tar xvzf apr-1.5.0.tar.gz

c.	Execute the following commands at the command prompt in sequence:

−	cd apr-1.5.0

−	./configure

−

make

−	make install

d.	Check the path shown at the end of make install command. The directory specified by this path should contain apr-1-config. The apr-1-config is required to build the Tomcat native library as mentioned in Build Tomcat Native Library section.

Build Tomcat Native Library

1.	Download the tomcat-native.tar.gz archive to a temporary location, such as /home/user/tomnative. The tomcat-native.tar.gz archive is located under CATALINA_HOME/bin.

2.	Navigate to the temporary location directory where the tomcat-native.tar.gz archive is downloaded. For example, navigate to the /home/user/tomnative directory.

3.	Extract the tomcat-native.tar.gz archive in the temporary location, such as /home/user/tomnative directory.

4.	Change to the /home/user/tomnative/tomcat-native-1.1.27-src/jni/native directory.

5.	Execute the following commands at the command prompt in sequence:

a.	./configure -with-apr=Full_APR_CONFIG_PATH -with-java-home=Full_Path_JDK -with-ssl=yes -prefix=Path_to_destination_directory

where,

−	Path_to_destination_directory is the destination directory where the libraries are created.

−	Full_APR_CONFIG_PATH is the full path to apr-1-config. For example, ,/usr/bin/apr-1-config

−	Full_Path_JDK is the full path to JDK. For example, /usr/tools/jdk_1.7.0_45

b.

make

c.	make install

6.	Verify that the Path_to_destination_directory/lib directory contains around five new files with extensions such as .so, .la,.a and so on after the successful installation.

Set LD_LIBPARY_PATH

Set the LIBRARY PATH to the user’s profile as follows:

1.	Open a command prompt window.

2.	Set the LD_LIBRARY_PATH to the destination directory where the libraries are created, as follows

      LD_LIBRARY_PATH = Path_to_destination_directory/lib:$LD_LIBRARY_PATH

      export LD_LIBRARY_PATH

Copyright © Cloud Software Group, Inc. All Rights Reserved