Updating a SAS Installation Data (SID) file results in warnings in the SAS® Customer Intelligence Studio log and missing menu items


When you renew your SAS Customer Intelligence Studio license, be sure to follow the instructions in the accompanying SAS_planned_renewal_instructions_<OS>.txt file from the SAS 9.4 Software License Renewal Order Email. If you encounter issues, read through this article to help troubleshoot.

Table of Contents

When you update a SAS Installation Data (SID) file for SAS Customer Intelligence Studio, you must run both of these tasks in SAS® Deployment Manager: Renew SAS Software and Update SID in Metadata. If you fail to run both, you might encounter the following symptoms.

Symptoms

If the Update SID in Metadata step is not performed, you might receive the following warning in the SASCustIntelCore6.6.log from the middle-tier under SAS-configuration-directory/Lev1/Web/Logs/SASServer6_1:

Caused by: com.sas.analytics.crm.error.client.ApplicationException: getMAUser(xxx) failure

WARN  [tomcat-http--1755] [xxxx] [xxx] vices.common.config.ConfigurationService - The Product PRODNUM170 is not licensed.

WARN  [tomcat-http--1755] [xxxx] [xxx] vices.common.config.ConfigurationService - The Product PRODNUM533 is not licensed.

WARN  [tomcat-http--1755] [xxxx] [xxx] vices.common.config.ConfigurationService - The Product PRODNUM152 is not licensed.

Additionally, expected menu items might be missing in the SAS Customer Intelligence Studio application. For example, Configuration and Administration might be the only items displayed instead of the additional menu items such as Designer and Definitions:

missing menu items.png

In this scenario, the Administration tab might contain only Locks and User Sessions, instead of Locks, User Sessions, and Deployments. Also, the top menu items might only contain File, Help, Setup, and Administration rather than the following expected options:

admin tab.png

Other plug-ins might be missing as well (such as Optimization Input Data, Optimization Scenarios, and so on).

 

Verifying the SAS Installation Data File

If you encounter these symptoms, you might need to rerun the two tasks mentioned above. But it’s a good idea to first verify that you have the correct license files and that they have not expired.

Make sure the SAS Installation Data file (license) that you are applying includes the SAS Customer Intelligence products that you are using, such as SAS® Marketing Automation, SAS® Decision Services and/or SAS® Marketing Optimization. The PRONUMS are listed at the bottom of the SAS Installation Data file. Here are some examples:

*PRODNUM170 = EMASVRPROCES SAS Mktg Automation-Server;

*PRODNUM533 = POLICYMVA SAS Decision Services Server Components;

*PRODNUM152 = MKTOPTSA SAS Marketing Optimization;

To determine whether you have the correct files and that they are not expired, complete the steps in the Troubleshooting section.

Troubleshooting

Complete these steps to verify that the correct SID files are in the metadata:

  1. Open SAS® Management Console 9.4.

  2. Connect with an unrestricted account, such as sasadm@saspw.

  3. Click to expand Environment Management.

  4. Click to expand Metadata Manager.

  5. Click to expand Metadata Utilities.

  6. Right-click Metadata Utilities and select View metadata setinit details. The Setinit details in metadata dialog box appears, containing a tab for each SAS site number in metadata, including product IDs and expiration dates:

    setinit details in metadata.png

  7. Check whether the PRONUMS mentioned in the SASCustIntelCore6.6.log are in the list and when they expired.

If you have the wrong files or the correct files are expired, contact your sales rep for assistance.

Resolving These Issues

SAS Customer Intelligence Studio puts the SAS Installation Data (SID) files in the metadata during installation. This action requires that you run both the Renew SAS Software and Update SID in Metadata tasks from SAS Deployment Manager.

To perform the Update SID in Metadata task from the SAS Deployment Manager, select the SAS® 9.4 planned deployment license renewal instructions for the operating system on which your SAS® Metadata Server is installed and currently running:

After the Update SID in Metadata steps have completed, restart all the SAS Services in the correct order. Note that it can take 30 minutes after starting the SAS Web Applications for SAS Customer Intelligence Studio to be fully functional.

The updated expiration dates and licenses for any newly added products take effect after the restart. For more information about restarting SAS Servers in the appropriate order, see Starting, Stopping, and Checking the Status of Servers in the SAS 9.4 Intelligence Platform System Administration Guide.

 

References

SAS Note 57427, “Missing SAS® Marketing Optimization plug-ins in the user interface”

SAS KB0036256, “To extend the expiration date for particular SAS® solutions and products, you must perform the ‘Update SID File in Metadata’ task”