Implementing CA SAM with CA APM › How to Implement CA SAM with CA APM › Enable Software Asset Management Capabilities

Enable Software Asset Management Capabilities

After you install and configure all CA APM components, you then enable the software asset management capabilities.

If you currently have an integration between CA APM and CA Software Compliance Manager (CA SCM), uninstall CA SCM before you enable software asset management capabilities. For information about uninstalling CA SCM, see How to Uninstall CA Software Compliance Manager. For more information about how and when to uninstall CA SCM, contact your CA Services representative.

Note: If you enabled software asset management capabilities in a previous release and you are now upgrading, skip the following steps. However, update the web.config configuration file on the CA APM web server to refer to the CA SAM section of the common home page. Update the following statement:

<add key="CASAMWebClientUrl" value="http://CA_SAM_server_name/prod" />

Example:

<add key="CASAMWebClientUrl" value="http://itamsam/prod" />

Follow these steps:

1. Log in to CA APM on the web server as the Administrator.
2. Navigate to Administration, System Configuration, Software Asset Management.
3. Complete the requested information. The following fields require explanation:

   CA SAM Web Client URL

   Specifies the URL for the CA SAM home page.

   Note: You can copy the web client URL from the CA SAM home page after you log in.

   CA SAM Import Export Webservice URL

   Specifies the URL for the CA SAM web service. Use the following format:

   http://[CA SAM System Name]:[Port Number]/SAMImportExportService/Service.svc
   

   • Replace [CA SAM System Name] with the name of the CA SAM server.
   • Replace [Port Number] with the port number where the CA SAM Import and Export Service is hosted.

   Enable SAM Capabilities

   Specifies that software asset management capabilities are enabled. If you previously had CA SCM fields on the CA APM user interface, they are removed after you select this check box.

   CA SAM Web Service WSDL URL

   The URL for the CA SAM Web Service Definition Language (WSDL). This URL is used to access the CA SAM web service. Use the following format:

   http://[CA SAM System Name]:[Port Number]/prod/soap/dyn_server.php
   

   • Replace [CA SAM System Name] with the name of the CA SAM server.
   • Replace [Port Number] with the port number where the CA SAM Web Service is hosted.

   CA SAM Web Service Login

   Login name for the CA SAM web service.

   Note: Verify that this login name and the CA SAM Web Service Password match the login name and password in the config_soap.inc file. This file is found in the following CA SAM installation folder path:

   app\includes\prod\st\config_soap.inc
   

   Important! The default content of the config_soap.inc file is commented. Remove the comment delimiters (/* */) and configure the login name and password.

   CA SAM Web Service Password

   Login password for the CA SAM web service.

   CA SAM SSO Encryption Algorithm

   Specifies the encryption algorithm to be used for single sign-on access to CA SAM from the CA IT Asset Manager common home page.

   This entry must match the entry in CA SAM System Configuration for the security_auth_token_cipher field.

   Note: For more information about CA SAM single sign-on, see the description of single sign-on in the CA Software Asset Manager Administration Manual.

   CA SAM SSO Authentication Mechanism

   Specifies the mechanism to be used for logging in to CA SAM.

   This entry must match the entry in CA SAM System Configuration for the security_auth_method field.

   Note: We recommend that you select auth_token_password for this mechanism. The auth_token mechanism disables the login for other CA SAM users.

   CA SAM SSO Field to Authenticate User

   Specifies the type of unique identifier (import ID or email address) that is used to authenticate the user.

   This entry must match the entry in CA SAM System Configuration for the security_auth_token_user_identifier field.

   CA SAM SSO Secret Key

   Specifies the key that CA APM and CA SAM share and that is used to encrypt and decrypt the user authentication. This key ensures that CA APM users who do not have the proper authentication cannot access CA SAM.

   This entry must match the entry in CA SAM System Configuration for the security_auth_token_key field.

4. Click Save.
5. Restart the Apache Tomcat Common Asset Viewer service.

   Note: Also restart the Apache Tomcat Common Asset Viewer service if you change the entries in any of the following fields at a later time:

   • CA SAM Web Service WSDL URL
   • CA SAM Web Service Login
   • CA SAM Web Service Password
6. Restart Internet Information Services (IIS) on the CA APM web servers and application servers by executing the iisreset command.

   Software asset management capabilities are enabled, and CA SCM fields are removed from the CA APM user interface.

The Load Data button is enabled if CA APM data exists (for example, if you had an existing CA APM 12.6 installation and you are upgrading). You can then load existing CA APM data for selected objects into CA SAM. For information about loading data, see Load CA APM Data into CA SAM. This button is not enabled if you are performing a new installation of CA APM. You do not have existing data with a new installation.