Advanced Password Services (APS) Guide › Install and Configure SmPortal and SmTransact › Install SmPortal and SmTransact

Install SmPortal and SmTransact

This section describes how to install SmPortal and SmTransact.

SmPortal - The Client Side

The SmPortal module consist of these files:

• The SmAgentAPI library (SmAgentAPI.dll or SmAgentAPI40.dll on Windows NT, libsmagentapi.so or libsmagentapi40.so on Solaris) is installed on the Policy Server and must be copied to the Web Server.
• The SmPortal library (SmPortal.dll on Windows NT or libsmportal.so on Solaris) is supplied with the SmPortal/SmTransact tunnel kit.
• SmPortal.cfg is supplied with the SmPortal/SmTransact tunnel kit.

Additional files may be installed to support the SmPortal module. These files include:

• APSPing (APSPing.exe on Windows NT) is an executable that can be used to test connectivity.
• SmPortalVfy (SmPortalVfy.exe on Windows NT) is a program that verifies the contents of the SmPortal.cfg file.
• APSVersion (APSVersion.exe on Windows NT) is an executable that can report the version numbers embedded in code provided by CA Professional Services. Not all CA code supports APSVersion.
• APSXLate and its supporting utilities. SmPortal is capable of localizing (translating) its error messages. The APSXLate module supplies this service to SmPortal. If APSXLate is not supplied, SmPortal will still function, but will always return its default error messages in English.
• APSEncrypt (APSEncrypt.exe on Windows NT) is an executable that can encrypt a shared secret. The encrypted value can be copied into the SmPortal.cfg file so that the shared secret need not be stored in clear text.

All files will be installed using the supplied installation program.

SmTransact - The Policy Server Side

On the SiteMinder Policy Server side, these files must be installed:

• SmTransact.dll (libsmtransact.so on Solaris),
• PortalTest.dll (libPortalTest.so on Solaris)
• APSTransponder.dll (libAPSTransponder.so on Solaris)

  Install this file on the SiteMinder BIN directory so that SmPortalTest and SmPortalVfy can be used from the client side to test the configuration.

Note: If APSPing, SmPortalTest and SmPortalVfy are not be used, the APSTransponder and PortalTest libraries are not needed. However, we highly recommend that they be installed anyway.

If the SiteMinder Policy Server is running, you may need to stop it before you can perform the installation.

There is a version of the SmTransact library that is supplied with SiteMinder itself. That version works well with most known SmPortal/SmTransact services, but definitely will not support SmPortalTest and SmPortalVfy as supplied. You should install the later version of SmTransact, if possible. There are no known problems with doing this.

You can install SmTransact on your Policy Server using the supplied installation scripts.