As of SAS 9.4 M3, SAS Grid Computing has a new tool: the Grid Manager Module for SAS Environment Manager 2.5. This module provides some of the same monitoring and management functions as IBM Platform RTM for SAS, so you can monitor and manage your grid using the same application that you use to manage the rest of your SAS environment.
As an LSF administrator, if defined also as a SAS Environment Manager user, you can access this Web application/module from SAS Environment Manager (http://YourSAS.AppServer:7080/)
Out of the box, and based on deployment and configuration best practices, the Grid Manager Module for SAS Environment Manager 2.5 may not work as expected. The SAS Grid environment requires some post installation/configuration steps.
The goal of this post is to help you learn about these steps…
Why does SAS Grid Manager Module for SAS Environment Manager 2.5 require post installation/configuration steps?
The best practices for SAS Grid Computing are to deploy all SAS software components using a specific SAS Installation User (I.E.: sas or sasinst) account, and to deploy all IBM Platform Suite for SAS software components using a specific LSF Administrator User (I.E.:lsfadmin) account. The SAS Installation User and the LSF Administrator User are both members of a unique user group, generally “sas“.
Traditionally, the SAS software components are installed and configured using the SAS Deployment Wizard application, and the IBM Platform Suite for SAS software components are installed and configured using the IBM Platform installation tools.
But since SAS 9.4 M3, there is one component of the IBM Platform Suite for SAS software, IBM Platform PWS (Platform Web Services) that is installed and configured using the SAS Deployment Wizard. Because of that, IBM Platform PWS is installed, configured and managed by the SAS Installation User, not the LSF Administrator.
The IBM Platform PWS component, as the SAS Grid Manager Module for SAS Environment Manager 2.5, is a middle-tier application that “interfaces” with the IBM Platform LSF components that reside on the SAS Grid Control Server.
Each time an administrator manages the LSF or HA (High Availability) configuration using the SAS Grid Manager Module for SAS Environment Manager 2.5, this module has to read from and/or write to information from IBM Platform LSF components on the SAS Grid Control Server through IBM Platform PWS from the middle-tier host. If all of these components are not installed, configured, and managed by the same user, these actions may generate errors making it impossible to manage LSF and High Availability configurations.
For this reason, post installation/configuration steps are required to make the SAS Grid Manager Module for SAS Environment Manager 2.5 fully functional.
The post installation/configuration steps…
1 - Obtain the required IBM Platform PWS fix for SAS Grid
Contact SAS Tech Support to obtain the IBM Platform PWS fix for SAS Grid.
The fix is named pws9.1.3_build65123.zip. The fix will contain a Readme.txt file that explains the installation process.
2 - Configure your SAS Grid environment
A. It is required that passwordless SSH be configured between the IBM Platform PWS host and the IBM Platform LSF master host (I.E.: SAS Grid Control Node) for the user who starts the IBM Platform PWS SpringSource tcServer instance (The SAS Installation User). This will allow the IBM Platform PWS user to SSH to the IBM Platform LSF master host as the Primary LSF Administrator (I.E.: ssh lsfadmin@lsf_master_host) without a password prompt.
B. On the IBM Platform LSF master host (I.E.: SAS Grid Control Node) you need to modify/adjust the permissions against the IBM Platform LSF configuration files.
i. Go to the IBM Platform LSF configuration directory.
ii. Add the group write (‘w‘) permission to all files located under this directory which will allow the SAS Installation User to write/modify these files.
chmod -R g+w *
iii. Add the group read (‘r‘) permission to certain files located under this directory which do not have it by default which will allow the SAS Installation User to read these files.
a. Go to [PlatformSuiteForSAS-Top-Directory]/lsf/conf/ego/sas_cluster/kernel
b. Change the group permissions on specific files
chmod -R g+r dh512.pem pamauth.conf server.pem users.xml
3 - Install the IBM Platform PWS fix for SAS.
A. Stop IBM Platform PWS
B. Apply the IBM Platform PWS webapps/platform fix.
i. Go to [SAS-Configuration-Directory]/Levn/Web/Staging/exploded/platformpws/platform
ii. Backup, and replace these specific .class and .properties files (detailed in the Readme.txt file) with files from the IBM Platform PWS fix.
iii. Add this specific .class file from the IBM Platform PWS fix.
iv. Go to [SAS-Configuration-Directory]/Levn/Web/WebAppServer/SASServer14_1/sas_webapps/platform.web.services.war
v. Repeat steps "ii." and "iii." against this directory.
C. Start/Restart IBM Platform PWS.
After applying these post configuration steps, you should now be able to use the SAS Grid Manager Module for SAS Environment Manager 2.5 to manage your grid much like you do with IBM Platform RTM.
I hope this article has been helpful to you.