Administering SAS BI Portlets

Configuring SAS BI Portlets for the WebSphere Portal

To configure and deploy the SAS BI portlets to the WebSphere Portal server, follow these steps.

Modify the JVM arguments in the WebSphere Administrative Console. See Administering SAS BI Portlets.
Set up the PFS JAAS configuration in the WebSphere Administrative Console. See Set up the PFS JAAS Configuration in the WebSphere Administrative Console.
Create Metadata Accounts for WebSphere Portal Users in SAS Management Console. See Add the WebSphere Portal Users to the Metadata Server.
Deploy the SAS BI Portlets in the WebSphere Portal. See Deploy the SAS BI Portlets in the WebSphere Portal.
Assign permissions to SAS BI Portlets in the WebSphere Portal. See Assign Permissions to the SAS BI Portlets in the WebSphere Portal.
Add the SAS BI Portlets to the WebSphere Portal page. See Add the SAS BI Portlets to the WebSphere Portal Page.

Modify JVM Arguments in the WebSphere Administrative Console

Before you modify the JVM arguments in the WebSphere Administrative Console, access the environment.properties file located in the SAS-configuration-directory\Lev1\Web\Applications\RemoteServices directory. Make a note of the multicast address and port number specified in that file. You need that information when specifying the JVM arguments in the WebSphere Administrative Console. For information about multicast IP address and multicast UDP port number, see Key Multicast Properties.

The JVM arguments that you specify in the WebSphere Administrative Console can also be obtained from your instructions.html file.

To modify JVM arguments in the WebSphere Administrative Console, follow these steps:

Start the WAS Administrative Console and log on to the console.
Expand Servers Application Servers and select WebSphere Portal.
On the Configuration tab, under Server Infrastructure, click on Java and Process Management.
Select Process Definition.
Under Additional Properties, click Java Virtual Machine.

In the Generic JVM Arguments field, enter the JVM arguments for the multicast address and port. Make sure that the multicast address matches the value specified in the environment.properties file located in the SAS-configuration-directory/Lev1/Web/Applications/RemoteServices. To avoid errors when entering the syntax for the JVM arguments, enter the syntax in a text file. Then, paste the typed text into the Generic JVM Arguments field. Substitute values for the multicast address and port and save your changes:

-Xgcpolicy:gencon -Dcom.sun.management.jmxremote
-Dsun.rmi.dgc.client.gcInterval=3600000
-Dsun.rmi.dgc.server.gcInterval=3600000
-Djava.awt.headless=true -Dsas.container.identifier=websphere
-Dsas.auto.publish.port=9080 
-Dcom.sas.services.logging.disableRemoteList=true
-Dcom.sas.services.logging.disableRemoteLogging=true 
-Djava.net.preferIPv4Stack=true
-Djava.net.preferIPv6Addresses=false 
-Dmulticast_udp_ttl=32
-Dmulticast.address=IP address used for the multicast address
-Dmulticast.port=port number
-Dcom.sas.log.config.url=file:///SAS-configuration-directory
/Lev1/Web/Common/LogConfig/

Save your changes.

Set up the PFS JAAS Configuration in the WebSphere Administrative Console

To set up the PFS JAAS configuration in the WebSphere Administrative Console, follow these steps:

Start the WAS Administrative Console and log on to the console.
Expand Security Secure administration, applications, and infrastructure.
Click to expand Java Authentication and Authorization Service, and click Application logins.
Click PFS.
On the Configuration tab, under General Properties, enter PFS in the field for Alias.
Under Additional Properties, click JAAS Login Modules.
In the JAAS login modules panel, under Preferences, click New.
In the field for Module class name, enter com.sas.services.security.login.TrustedLoginModule, and click Apply.
In the panel for com.sas.services.security.login.TrustedLoginModule, under Additional Properties, click Custom Properties.
Click New.
In the fields for Name and Value, enter each of the following pairs of values, and save your changes after entering each pair of values:

Name host name

Value IP address or host name

Name port

Value 8561

Name repository

Value Foundation

Name domain

Value DefaultAuth

Name trusteduser

Value sastrust@saspw

Name user name

Value password

Name debug

Value false
Restart the WebSphere Portal Server.

Add the WebSphere Portal Users to the Metadata Server

In order to log on to a SAS client, a user must have an account that can provide access to the metadata server. This user account also enables each user to log on to the WebSphere portal to access the SAS BI portlets. This user account should not include a password.

Users of the SAS BI portlets must be defined in the metadata server used by the SAS BI portlets. These users should belong to the appropriate group in the metadata. There are several ways to add users to the metadata server. You can access User Manager plug-in within SAS Management Console and add users. Another method is to batch import users from a provider such as LDAP into the SAS metadata. The group to which the users are added affects the functions performed by the users.

Deploy the SAS BI Portlets in the WebSphere Portal

To deploy the SAS BI portlets to the WebSphere Portal, follow these steps:

Log on to the WebSphere Portal Administrative Console.
On the Administration tab, under Portlet Management, select Web Modules.
In the Manage Web Modules panel, click Install.
Click Browse, navigate to the SAS-configuration-directory\Lev1\Web\Staging directory, and select sas.biportlets4.3.war file.
Click Next and enter the following values:

Enterprise Application display name: SASBIPortlets

Context root: /SASBIPortlets
Click Finish. Then, click Cancel.
Search for the sas.biportlets4.3.war file in order to verify that it was installed.

Assign Permissions to the SAS BI Portlets in the WebSphere Portal

To assign permissions to the SAS BI Portlets and enable users to access these portlets, follow these steps:

Log on to the WebSphere Portal Administration Console.
On the Administration tab, under Portlet Management, select Portlets.
In the Manage Portlets panel, search for the SAS BI Portlets.
For each of the SAS BI Portlets, change the resource permissions for the Editor and User:
1. Click the Key icon to display the Resource Permissions page.
2. Click the Edit Role icon for the Editor.
3. In the Resource Permissions page for the Editor, click Add to display the Add Role Members panel.
4. Select the check box for Users and User Groups, and click OK to return to the Resource Permissions page for the portlet. Note that when you select the check box for Users and User Groups, check boxes get selected for All Authenticated Portal Users, All Portal User Groups, and Anonymous Portal User.
5. Click on the portlet name to return to the Resource Permissions page for the portlet.
6. In the Resource Permission page for the portlet, click the Edit Role icon for the User.
7. Click Add to display the Add Role Members panel.
8. Select the check box for Users and User Groups, and click OK to return to the Resource Permissions page for the portlet.
9. Click on the portlet name to return to the Resource Permission page for the portlet.
10. Click Apply.
11. Click Done.
Repeat these steps to assign permissions for the Editor and User associated with each of the SAS BI Portlets.

Add the SAS BI Portlets to the WebSphere Portal Page

To view and use the SAS BI Portlets, add the portlets to a user's Web page in the WebSphere Portal. For instructions about how to add and use portlets, see the online Help for WebSphere Portal.

Top of Page