Color bar

Configuration Guidelines and Details for "HOSTNAME"

Overview

  1. Warnings and Notices
  2. SAS Management Console
  3. SAS Application Servers
  4. SAS Spawners
  5. SAS Framework Data Server
  6. SAS/SHARE Server
  7. SAS Deployment Tester Server
  8. Operating System Services Scheduling Server
  9. SAS BI Lineage Scheduling Server
  10. SAS Web Infrastructure Platform Scheduling Services
  11. Remote Services
  12. Web Application Server
  13. SAS Web Applications
  14. Web Application Custom Content
  15. Obtaining Additional Information

Warnings and Notices

The following issues occurred during the automated portion of your configuration and must be addressed before proceeding.

SAS Management Console

SAS Management Console is required to complete many of the following steps.

Shortcut Programs > SAS > SAS Management Console 9.3
User ID SAS Administrator user ID
Password Enter the password you created in the SAS Deployment Wizard.

SAS Application Servers

SASMeta - Metadata Server

Host machine HOSTNAME.example.com
Port 8561
Log directory C:\SAS\EBIEDIEG\Lev1\SASMeta\MetadataServer\Logs
For more details about the initial logging configuration and how to modify it, see "Administering Logging for SAS Servers" in the SAS Intelligence Platform: System Administration Guide at http://support.sas.com/93administration.
Execution type Windows service
SAS [EBIEDIEG-Lev1] SASMeta - Metadata Server
Shortcuts Programs > SAS > Configuration > EBIEDIEG - Lev1

Notes:

SASApp - Connect Server

Validation steps
  1. In the SAS Management Console, on the Plug-ins tab, select "+" to expand the Server Manager node.
  2. Expand SASApp.
  3. Expand SASApp - Logical Connect Server.
  4. Highlight the SASApp - Connect Server.
  5. Right mouse click this server and select Validate (you can enter HOSTNAME\sasdemo or the SAS Spawned Servers account for the user ID). You should see a Validation Successful message.

SASApp - OLAP Server

Host machine HOSTNAME.example.com
Port 5451
Log directory C:\SAS\EBIEDIEG\Lev1\SASApp\OLAPServer\Logs
For more details about the initial logging configuration and how to modify it, see "Administering Logging for SAS Servers" in the SAS Intelligence Platform: System Administration Guide at http://support.sas.com/93administration.
Validation steps
  1. In the SAS Management Console, on the Plug-ins tab, select "+" to expand the Server Manager node.
  2. Expand SASApp.
  3. Highlight the SASApp - Logical OLAP Server.
  4. Right mouse click this server and select Validate. You should see a Validation Successful message.
Execution type Windows service
SAS [EBIEDIEG-Lev1] SASApp - OLAP Server
Shortcuts Programs > SAS > Configuration > EBIEDIEG - Lev1

SASApp - Stored Process Server

Host machine HOSTNAME.example.com
Port 8601
Log directory C:\SAS\EBIEDIEG\Lev1\SASApp\StoredProcessServer\Logs
For more details about the initial logging configuration and how to modify it, see "Administering Logging for SAS Servers" in the SAS Intelligence Platform: System Administration Guide at http://support.sas.com/93administration.
Validation steps
  1. In the SAS Management Console, on the Plug-ins tab, select "+" to expand the Server Manager node.
  2. Expand SASApp.
  3. Highlight the SASApp - Logical Stored Process Server.
  4. Right mouse click this server and select Validate. You should see a Validation Successful message.

SASMeta - Workspace Server

Host machine HOSTNAME.example.com
Validation steps The SASMeta - Workspace Server should be used for only a few designated administrative tasks. It is appropriate to defer validation of this server until you have set up the SAS users who will perform these tasks. This server requires an external account and is available to only the SAS Administrators group.

Notes:

SASApp - Workspace Server

Host machine HOSTNAME.example.com
Port 8591
Log directory C:\SAS\EBIEDIEG\Lev1\SASApp\WorkspaceServer\Logs
For more details about the initial logging configuration and how to modify it, see "Administering Logging for SAS Servers" in the SAS Intelligence Platform: System Administration Guide at http://support.sas.com/93administration.
Validation steps
  1. In the SAS Management Console, on the Plug-ins tab, select "+" to expand the Server Manager node.
  2. Expand SASApp.
  3. Highlight the SASApp - Logical Workspace Server.
  4. Right mouse click this server and select Validate (you can enter HOSTNAME\sasdemo or the SAS Spawned Servers account for the user ID). You should see a Validation Successful message.

Notes:

SAS BI Report Services Workspace Configuration

Query Cache Library Name ="SASApp - wrstemp"
  1. In SAS Management Console, on the Plug-ins tab, select the "+" to expand the Data Library Manager node.
  2. Select "+" to expand Libraries.
  3. Select the library listed above.
  4. Right mouse click this library and select Properties.
  5. Click the Options tab and locate the path to the library in the Selected items text box.
Review the documentation provided to determine if permissions need to be modified for the library or directory to which the library points.
  1. For details, view the http://support.sas.com/93administration and refer to the document called SAS Intelligence Platform 9.3: Web Application Administration Guide.
  2. See the section called Improving the Performance of SAS Web Report Studio.
  3. This section will contain a list of Suggestions for Improving the Performance of SAS Web Report Studio. Go to the information titled "Using the Query Cache".
  4. Refer to the subsection called Security Considerations for the Query Cache Libraries for information regarding permissions.
Distribution Library Name ="SASApp - wrsdist"
  1. In SAS Management Console, on the Plug-ins tab, select the "+" to expand the Data Library Manager node.
  2. Select "+" to expand Libraries.
  3. Select the library listed above.
  4. Right mouse click this library and select Properties.
  5. Click the Options tab and locate the path to the library in the Selected items text box.
Review the documentation provided to determine if permissions need to be modified for the library or directory to which the library points.
  1. For details, view the http://support.sas.com/93administration and refer to the document called SAS Intelligence Platform 9.3: Web Application Administration Guide.
  2. See the section called Pre-generated Reports From SAS Web Report Studio.
  3. Refer to the subsection called Verifying Permissions for the Distribution Library for information regarding permissions.
Validation steps
  1. In SAS Management Console, on the Plug-ins tab, select "+" to expand the Data Library Manager node.
  2. Verify the libraries named above are listed under the Data Library Manager.
  3. In SAS Management Console, on the Plug-ins tab, select "+" to expand the Application Management node.
  4. Select "+" to expand the Configuration Manager
  5. Highlight BI Rep Svc Wkspace Config 4.3
  6. Right mouse click and select Properties.
  7. Click the Settings tab.
  8. Validate the query cache library and the distribution library. They should match the libraries listed under Data Libraries.

SAS BI Report Services

Log directory C:\SAS\EBIEDIEG\Lev1\Applications\SASBIReportServices4.3\Logs
For more details about how to modify your log format and to see what logging entails, see the SAS Intelligence Platform 9.3: Web Application Administration Guide at http://support.sas.com/93administration.
Java Batch Server Name ="SASApp - BRM Java Batch Server"
Configuration Configuration Directory = "C:\SAS\EBIEDIEG\Lev1\Applications\SASBIReportServices4.3"
Validation steps
    Java Batch Server
  1. In SAS Management Console, on the Plug-ins tab, select "+" to expand the Server Manager node.
  2. Select "+" to expand SASApp.
  3. Select "+" to expand the SASApp - Logical SAS Java Batch Server.
  4. Verify the existence of the java batch server(s) referenced above.
  5. Right mouse click this server and select Properties.
  6. Click the Options tab.
  7. Validate the command line by examining the parameter values and verifying file locations and the repository name.
    Local Services
  1. In SAS Management Console, on the Plug-ins tab, select "+" to expand the Foundation Services Manager node.
  2. Select "+" to expand the SASBIReportServices4.3 Local Services Definition.
  3. Select "+" to expand Core.
  4. Select the Logging Service.
  5. Right mouse button and choose Properties.
  6. Click the Service Configuration tab.
  7. Click the Configuration button.
  8. Verify the logging contexts.
  9. Refer to the logging documentation at the link specified above for details.
    outputgen.ini file
  1. The file outputgen.ini may need to be modified. This file is located in the install folder C:\Program Files\SASHome\SASBIReportServices\4.31.
  2. The following default settings for Java command line options appear in this file: java.net.preferIPv4Stack=true and java.net.preferIPv6Addresses=false.
  3. If the system is configured to use IPv6, these values must be changed to: java.net.preferIPv4Stack=false and java.net.preferIPv6Addresses=true.

SASApp - Pooled Workspace Server

Host machine HOSTNAME.example.com
Port 8701
Validation steps
  1. In the SAS Management Console, on the Plug-ins tab, select "+" to expand the Server Manager node.
  2. Expand SASApp.
  3. Highlight the SASApp - Logical Pooled Workspace Server.
  4. Right mouse click this server and select Validate. You should see a Validation Successful message.

SASMeta - SAS DATA Step Batch Server

Host machine HOSTNAME.example.com
Log directory C:\SAS\EBIEDIEG\Lev1\SASMeta\BatchServer\Logs
For more details about the initial logging configuration and how to modify it, see "Administering Logging for SAS Servers" in the SAS Intelligence Platform: System Administration Guide at http://support.sas.com/93administration.
Validation steps
  1. Select this link: C:\SAS\EBIEDIEG\Lev1\SASMeta\BatchServer\sasbatch.bat
  2. If SAS starts successfully, the DATA step batch server has been validated.

SASApp - SAS DATA Step Batch Server

Host machine HOSTNAME.example.com
Log directory C:\SAS\EBIEDIEG\Lev1\SASApp\BatchServer\Logs
For more details about the initial logging configuration and how to modify it, see "Administering Logging for SAS Servers" in the SAS Intelligence Platform: System Administration Guide at http://support.sas.com/93administration.
Validation steps
  1. Select this link: C:\SAS\EBIEDIEG\Lev1\SASApp\BatchServer\sasbatch.bat
  2. If SAS starts successfully, the DATA step batch server has been validated.

SAS Spawners

Object Spawner

Host machine HOSTNAME.example.com
Port 8581
Log directory C:\SAS\EBIEDIEG\Lev1\ObjectSpawner\Logs
For more details about the initial logging configuration and how to modify it, see "Administering Logging for SAS Servers" in the SAS Intelligence Platform: System Administration Guide at http://support.sas.com/93administration.
Execution type Windows service
SAS [EBIEDIEG-Lev1] Object Spawner
Shortcuts Programs > SAS > Configuration > EBIEDIEG - Lev1

Connect Spawner

Host machine HOSTNAME.example.com
Ports 7551
Log directory C:\SAS\EBIEDIEG\Lev1\SASApp\ConnectServer\Logs
For more details about the initial logging configuration and how to modify it, see "Administering Logging for SAS Servers" in the SAS Intelligence Platform: System Administration Guide at http://support.sas.com/93administration.
Execution type Windows service
SAS [EBIEDIEG-Lev1] Connect Spawner
Shortcuts Programs > SAS > Configuration > EBIEDIEG - Lev1

SAS/SHARE Server

Host machine HOSTNAME.example.com
Port 8551
Log directory C:\SAS\EBIEDIEG\Lev1\ShareServer\Logs
For more details about the initial logging configuration and how to modify it, see "Administering Logging for SAS Servers" in the SAS Intelligence Platform: System Administration Guide at http://support.sas.com/93administration.
Execution type Windows service
SAS [EBIEDIEG-Lev1] Share Server
Shortcuts Programs > SAS > Configuration > EBIEDIEG - Lev1

SAS Framework Data Server

Host machine HOSTNAME.example.com
Port 22031
Log directory C:\SAS\EBIEDIEG\Lev1\FrameworkServer\dffedsvrcfg\Logs
For more details about the initial logging configuration and how to modify it, see "Administering Logging for SAS Servers" in the SAS Intelligence Platform: System Administration Guide at http://support.sas.com/93administration.
Validation steps
  1. In the SAS Management Console, on the Plug-ins tab, select "+" to expand the Server Manager node.
  2. Expand FrameworkServer - Logical SAS Framework Data Server.
  3. Highlight the FrameworkServer - SAS Framework Data Server.
  4. Right mouse click this server and select Validate. You should see a Validation Successful message.
Execution type Windows service
SAS [EBIEDIEG-Lev1] FrameworkServer - SAS Framework Data Server
Shortcuts Programs > SAS > SAS Configuration > EBIEDIEG - Lev1

SAS Deployment Tester Server

Host machine HOSTNAME.example.com
Port 10021
Execution type Windows service
SAS [EBIEDIEG-Lev1] Deployment Tester Server
Shortcuts Programs > SAS > Configuration > EBIEDIEG - Lev1
Validation steps
  1. In SAS Management Console, on the Plug-ins tab, select "+" to expand the Application Management node.
  2. Select "+" to expand Deployment Tester
  3. Highlight the host machine: HOSTNAME.example.com
  4. Right mouse click and select Run All Test Suites.
  5. Select "+" to expand the Results.
  6. Validate the results for each test suite. All tests should pass.
If you are prompted for credentials, select the "Help" button in the Credentials dialog box to display the accounts that can be used for each test suite.

Notes:

Operating System Services Scheduling Server

Host machine HOSTNAME.example.com
Port 8451
Log directory C:\SAS\EBIEDIEG\Lev1\SchedulingServer\Logs
Validation steps
  1. In the SAS Management Console, on the Plug-ins tab, select "+" to expand the Server Manager node.
  2. Highlight Operating System Services - HOSTNAME.example.com.
  3. Right mouse click this server and select Validate (you can enter HOSTNAME\sasdemo or the SAS Spawned Servers account for the user ID). You should see a Validation Successful message.

SAS BI Lineage Scheduling Server

Java Batch Server Name = "SASApp - BIL Java Batch Server"
Configuration Configuration Directory = "C:\SAS\EBIEDIEG\Lev1\Applications\SASBILineage4.3"
Validation steps
    Java Batch Server
  1. In SAS Management Console, on the Plug-ins tab, select "+" to expand the Server Manager node.
  2. Select "+" to expand SASApp.
  3. Select "+" to expand the SASApp - Logical SAS Java Batch Server.
  4. Verify the existence of the Java batch server referenced above.
  5. Right mouse click this server and select Properties.
  6. Click the Options tab.
  7. Validate the command line.
    ScanDriver.bat file
  1. Verify the existence of the file ScanDriver.bat. This file is located in the configuration folder C:\SAS\EBIEDIEG\Lev1\Applications\SASBILineage4.3.
    Software Component
  1. In SAS Management Console, on the Folders tab, select "+" to expand the System folder.
  2. Select "+" to expand the Applications folder.
  3. Select "+" to expand the SAS BI Lineage Scheduling Server folder.
  4. Verify the existence of the BI Lineage Sched Svr 4.3 software component.

SAS Web Infrastructure Platform Scheduling Services

Log directory C:\SAS\EBIEDIEG\Lev1\Web\Logs
JES Java Batch Server Name = "SASApp - JES Java Batch Server"
Configuration
  • Configuration Directory = "C:\SAS\EBIEDIEG\Lev1\Web\Applications\SASWIPSchedulingServices9.3"
  • Deployment Directory = "C:\SAS\EBIEDIEG\Lev1\WIPSchedBatch"
Validation steps
    JES Java Batch Server
  1. In SAS Management Console, on the Plug-ins tab, select "+" to expand the Server Manager node.
  2. Select "+" to expand SASApp.
  3. Select "+" to expand the SASApp - Logical SAS Java Batch Server.
  4. Verify the existence of the java batch server(s) referenced above.
  5. Right mouse click this server and select Properties.
  6. Click the Options tab.
  7. Validate that the command line and arguments are appropriate for this java batch server.
    servicetrigger.ini file
  1. The file servicetrigger.ini may need to be modified. This file is located in the install folder C:\Program Files\SASHome\SASWebInfrastructurePlatformSchedulingServices\9.3.
  2. The following default settings for Java command line options appear in this file: java.net.preferIPv4Stack=true and java.net.preferIPv6Addresses=false.
  3. If the system is configured to use IPv6, these values must be changed to: java.net.preferIPv4Stack=false and java.net.preferIPv6Addresses=true.

Remote Services

Host machine HOSTNAME.example.com
Port 5091
Execution type Windows service
SAS [EBIEDIEG-Lev1] Remote Services
Shortcuts Programs > SAS > Configuration > EBIEDIEG - Lev1
Validation steps
  1. Execute 'C:\SAS\EBIEDIEG\Lev1\Web\Applications\RemoteServices\RemoteServices.bat status' and verify that the 'STATE' is 'RUNNING'.
  2. Execute the Deployment Tester plug-in to the SAS Management Console to validate the configuration, deployment and usage of the Remote Services application.

Notes:

Web Application Server

Host machine HOSTNAME.example.com
Application Server Vendor IBM
Application Server Name WebSphere
WebSphere Version 7.0.0.17
WebSphere Fix Pack Level 17
WebSphere Java Version "1.6.0"
WebSphere Java Runtime Java(TM) SE Runtime Environment (build pwa6460sr9fp1ifix-20110401_01(SR9 FP1+IZ95392+IZ95393+IZ97453))
WebSphere Installation Directory C:\IBM\WebSphere\AppServer
WebSphere Admin Console URL http://HOSTNAME.example.com:9060/ibm/console
WebSphere Admin Console Http Port 9060
WebSphere Admin Console Https Port 9043
WebSphere Cell Name SASDmgr01Cell
WebSphere Deployment Manager Profile Name SASDmgr01
WebSphere Dmgr Node Name SASDmgr01Node
WebSphere Dmgr Server Logs Directory C:\IBM\WebSphere\AppServer\profiles\SASDmgr01\logs\dmgr
WebSphere Managed Node Profile Name SASHOSTNAME01Node
WebSphere Managed Node Name SASHOSTNAME01Node
WebSphere Managed Node Logs Directory C:\IBM\WebSphere\AppServer\profiles\SASHOSTNAME01Node\logs
==================== =========================================================================================
Application Server Name SASServer1
Application Server Id server
Application Server Http Port 9080
Application Server Log Directory C:\IBM\WebSphere\AppServer\profiles\SASHOSTNAME01Node\logs\SASServer1
Application Server JVM Options -Xms1024m -Xmx2048m -Xss256k -Xmso256k -Xgcpolicy:optavgpause -Djavax.management.builder.initial= -Dcom.sun.management.jmxremote -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 -Djava.awt.headless=true -Dsas.container.identifier=websphere -Dcom.sas.services.logging.disableRemoteList=true -Dcom.sas.services.logging.disableRemoteLogging=true -Dsas.scs.host=HOSTNAME.example.com -Dsas.scs.port=9080 -Dwebreportstudio.file.cleanup.interval=60 -Djava.net.preferIPv4Stack=true -Djava.net.preferIPv6Addresses=false -Dmulticast_udp_ip_ttl=0 -Dmulticast.address=239.16.12.250 -Dmulticast.port=8561 -Dcom.sas.log.config.url=file:///C:/SAS/EBIEDIEG/Lev1/Web/Common/LogConfig/ -Dsas.auto.publish.port=9080 -Xcompressedrefs

Configuring your WebSphere Application Server Environment

NOTE ABOUT AUTO-CONFIGURATION: Since you have requested that the WebSphere environment be auto-configured, please review the following documentation to see the tasks that were automatically performed for you to configure WebSphere during execution of the SAS Deployment Wizard.
A basic WebSphere configuration has been created that uses SAS authentication and unsecure connections. If you need to setup a more sophisticated topology such as web server authentication or single sign-on, please see the SAS 9.3 Intelligence Platform: Security Administration Guide.
For reverse proxy server and secure socket connections, see the SAS 9.3 Intelligence Platform: Web Application Administration Guide.

NOTE ABOUT AUTO-DEPLOYMENT: Since you have requested that the SAS web applications be auto-deployed, you can review documentation beginning at "Deployment for application..." to see the deployments that were performed.
For reference, EAR files for the SAS web applications that have been automatically deployed are located in the "C:\SAS\EBIEDIEG\Lev1\Web\Staging" directory.


The WebSphere Application Server environment has been configured automatically

Because Auto Configuration of the WebSphere Application Server (WAS) was selected when running the SAS Deployment Wizard (SDW), the WAS environment has been automatically configured. All appservers have been created and customized to support the SAS webapps, so no further manual configuration of WAS should be necessary. However, a new SAS WebSphere Configuration Scripting Tool now exists, which enables configuration of WAS outside of the SDW. A general description of the SAS WebSphere Configuration Scripting Tool is provided below for reference.

WebSphere Configuration Scripting Tool

New for SAS 9.3, a WebSphere Application Server (WAS) Configuration Scripting Tool is generated during a SAS Deployment Wizard configuration. This tool allows you to manually execute configuration steps through a command line interface. If you selected to perform a manual configuration, you can execute the scripting tool to create the WAS profiles and the functional cell and to configure the resources equivalent to what would have been built during SAS configuration if you had chosen to perform an automated configuration. If you performed an automated configuration, the tool can reconfigure each resource exactly as they were configured during the SAS configuration step.

The scripting tools are located at C:\SAS\EBIEDIEG\Lev1\Web\Scripts\WebSphere.

If WAS is not installed on the machine where you ran the SAS Deployment Wizard, you can copy the Scripts directory or folder and its contents and the ear files for your web applications to the machine where WAS is installed and run the scripting tool on that machine. It is also possible to execute the individual steps and make changes to your configuration by modifying property files and rerunning steps. Detailed instructions for the WebSphere Configuration Scripting Tool can be found in the SAS Intelligence Platform: Middle-Tier Administration Guide.

Create WebSphere Profiles

Create the WebSphere dmgr profile to manage SAS application server node(s)

The following is the general overview of the steps required to create the WebSphere dmgr "SASDmgr01" profile:

Detailed Instructions to Create the WebSphere "SASDmgr01" dmgr Profile

  1. Create the "SASDmgr01" profile using the "manageprofiles" command to construct a new cell which will contain the dmgr server.

    Command to create dmgr profile: "C:\IBM\WebSphere\AppServer\bin\manageprofiles.bat" -response "C:\SAS\EBIEDIEG\Lev1\Web\Scripts\WebSphere\props\create.DmgrProfile.CELL.response.SASDmgr01.properties"

  2. Update dmgr SOAP Read Timeout Property in the "C:\IBM\WebSphere\AppServer\profiles\SASDmgr01\properties\soap.client.props" file. Since there is no way to perform this function using the WAS Admin Console, use a text editor to set the "com.ibm.SOAP.requestTimeout" property to a value of "900" (without the "quotes").

  3. Stop the dmgr manager using the "stopManager" command.
    Command to stop the dmgr server: "C:\IBM\WebSphere\AppServer\bin\stopManager.bat" -profileName "SASDmgr01"

  4. Set dmgr Ports to the following values by either editing the "C:\IBM\WebSphere\AppServer\profiles\SASDmgr01\config\cells\SASDmgr01Cell\nodes\SASDmgr01Node\serverindex.xml" file or using the WAS Admin Console "System administration->Deployment manager->ports" navigation to perform this task.

  5. Set the Http ports for the admin_host virtualhost alias to match port 9060 for dmgr to the following values by either editing the "C:\IBM\WebSphere\AppServer\profiles\SASDmgr01\config\cells\SASDmgr01Cell\virtualhosts.xml" file or using the WAS Admin Console "Environment->Virtual Hosts->admin_host->Host Aliases" navigation to perform this task.

  6. Set the dmgr JVM Initial Heap Size and Maximum Heap Size. From the WAS Admin Console, navigate through the "System administration->Deployment manager->Java and Process Management->Process Definition->Java Virtual Machine" menus.

  7. Start the dmgr manager using the "startManager" command.
    Command to start the dmgr server: "C:\IBM\WebSphere\AppServer\bin\startManager.bat" -profileName "SASDmgr01"

At this point, the dmgr profile "SASDmgr01" should be created.

Creation of WAS Dmgr profile should be complete at this point. You should be able to run the "manageprofiles" command with the "-listProfiles" parameter to verify that the "SASDmgr01" profile exists. In addition, you should see a Java process running for the "dmgr" server. You should also be able logon to the WAS Admin Console using the URL: http://HOSTNAME.example.com:9060/ibm/console.

Create the WebSphere managed node profile for the nodeagent and SAS application servers.

The following is the general overview of the steps required to create the WebSphere custom managed node "SASHOSTNAME01Node" profile:

Detailed Instructions to Create the WebSphere "SASHOSTNAME01Node" Managed Node Profile

  1. Create the App Server managed profile "SASHOSTNAME01Node" using the "manageprofiles" command.
    Command to create the app server profile: "C:\IBM\WebSphere\AppServer\bin\manageprofiles.bat" -response "C:\SAS\EBIEDIEG\Lev1\Web\Scripts\WebSphere\props\create.NodeProfile.NODE.response.SASHOSTNAME01Node.properties"

  2. Stop the nodeagent using the "stopNode" command.
    Command to stop the nodeagent: "C:\IBM\WebSphere\AppServer\bin\stopNode.bat" -profileName "SASHOSTNAME01Node"

  3. Update nodeagent SOAP Read Timeout Property in the "C:\IBM\WebSphere\AppServer\profiles\SASHOSTNAME01Node\properties\soap.client.props" file. Since there is no way to perform this function using the WAS Admin Console, use a text editor to set the "com.ibm.SOAP.requestTimeout" property to a value of "900" (without the "quotes").

  4. Federate the new "SASHOSTNAME01Node" node to the dmgr cell using the "addNode" command.
    Command to federate the new node: "C:\IBM\WebSphere\AppServer\bin\addNode.bat" HOSTNAME.example.com 8879 -conntype SOAP -profileName "SASHOSTNAME01Node" -includeapps -noagent

  5. Set nodeagent Ports to the following values by either editing the "C:\IBM\WebSphere\AppServer\profiles\SASHOSTNAME01Node\config\cells\SASDmgr01Cell\nodes\SASHOSTNAME01Node\serverindex.xml" file or using the WAS Admin Console "System administration->Node agents->nodeagent for "SASHOSTNAME01Node"->ports" navigation to perform this task.

  6. Set the nodeagent JVM Initial Heap Size and Maximum Heap Size. From the WAS Admin Console, navigate through the "System administration->Node agents->nodeagent for Node "SASHOSTNAME01Node"->Java and Process Management->Process Definition->Java Virtual Machine" menus.

  7. Synchronize the nodeagent and dmgr repositories using the "syncNode" command.
    Command to synchronize the nodeagent with the dmgr: "C:\IBM\WebSphere\AppServer\bin\syncNode.bat" "HOSTNAME.example.com" 8879 -conntype SOAP -profileName "SASHOSTNAME01Node"

  8. Create a Windows Service for the nodeagent using the "WASService" command.
    Command to create a Windows Service for the nodeagent: "C:\IBM\WebSphere\AppServer\bin\WASService" -add SASHOSTNAME01Node -servername nodeagent -restart true -startType automatic -profilePath "C:\IBM\WebSphere\AppServer\profiles\SASHOSTNAME01Node"

  9. Start the nodeagent using the "startNode" command.
    Command to start the nodeagent: "C:\IBM\WebSphere\AppServer\bin\startNode.bat" -profileName "SASHOSTNAME01Node"

Creation of WAS managed node profile should be complete at this point. You should be able to run the "manageprofiles" command with the "-listProfiles" parameter to verify that the "SASHOSTNAME01Node" profile exists. In addition, you should see a Java processes running for the "nodeagent" server.

JAAS Login Module Alias "PFS" for module "com.sas.services.security.login.OMILoginModule" added to the JAAS Application logins in cell "SASDmgr01Cell"

The definition for the "PFS" JAAS Login Module Alias has been added using information from the tables below.

Values for JAAS Login Module general settings:
JAAS Application logins alias: PFS
JAAS Module Class name: com.sas.services.security.login.OMILoginModule
JAAS Authentication strategy: required
Custom Properties for JAAS Login Module "com.sas.services.security.login.OMILoginModule"
Custom Property Name: Custom Property Value:
debug false
domain DefaultAuth
host HOSTNAME.example.com
port 8561
repository Foundation
trustedpw Enter the SAS-encoded password for the SAS trusted user ID. (Use this SAS program to encode the value: PROC PWENCODE IN='password'; RUN;)
trusteduser Enter the SAS trusted user ID

JAAS Login Module Alias "SASTRUSTED" for module "com.sas.services.security.login.TrustedLoginModule" added to the JAAS Application logins in cell "SASDmgr01Cell"

The definition for the "SASTRUSTED" JAAS Login Module Alias has been added using information from the tables below.

Values for JAAS Login Module general settings:
JAAS Application logins alias: SASTRUSTED
JAAS Module Class name: com.sas.services.security.login.TrustedLoginModule
JAAS Authentication strategy: required
Custom Properties for JAAS Login Module "com.sas.services.security.login.TrustedLoginModule"
Custom Property Name: Custom Property Value:
aliasdomain MidtierInternal
debug false
domain DefaultAuth
host HOSTNAME.example.com
port 8561
repository Foundation
trustedpw Enter the SAS-encoded password for the SAS trusted user ID. (Use this SAS program to encode the value: PROC PWENCODE IN='password'; RUN;)
trusteduser Enter the SAS trusted user ID

JAAS Login Module Alias "SCS" for module "com.sas.services.security.login.OMILoginModule" added to the JAAS Application logins in cell "SASDmgr01Cell"

The definition for the "SCS" JAAS Login Module Alias has been added using information from the tables below.

Values for JAAS Login Module general settings:
JAAS Application logins alias: SCS
JAAS Module Class name: com.sas.services.security.login.OMILoginModule
JAAS Authentication strategy: required
Custom Properties for JAAS Login Module "com.sas.services.security.login.OMILoginModule"
Custom Property Name: Custom Property Value:
debug false
domain DefaultAuth
holdopenconnection true
host HOSTNAME.example.com
port 8561
repository Foundation
trustedpw Enter the SAS-encoded password for the SAS trusted user ID. (Use this SAS program to encode the value: PROC PWENCODE IN='password'; RUN;)
trusteduser Enter the SAS trusted user ID

JAAS Login Module Alias "UsernamePassword" for module "com.platform.SASLogin.UsernamePasswordLogin" added to the JAAS Application logins in cell "SASDmgr01Cell"

The definition for the "UsernamePassword" JAAS Login Module Alias has been added using information from the tables below.

Values for JAAS Login Module general settings:
JAAS Application logins alias: UsernamePassword
JAAS Module Class name: com.platform.SASLogin.UsernamePasswordLogin
JAAS Authentication strategy: required
Custom Properties for JAAS Login Module "com.platform.SASLogin.UsernamePasswordLogin"
Custom Property Name: Custom Property Value:
debug false

Create Application Server "SASServer1" Overview

Create Application Server Detailed Instructions

  1. Server "SASServer1" has been created.
  2. Server "SASServer1" has been stopped using: "C:\IBM\WebSphere\AppServer\bin\stopServer.bat" "SASServer1" -profileName "SASHOSTNAME01Node"
  3. Set Http Ports for "SASServer1" to the following values by either editing the "C:\IBM\WebSphere\AppServer\profiles\SASHOSTNAME01Node\config\cells\SASDmgr01Cell\nodes\SASHOSTNAME01Node\serverindex.xml" file or using the WAS Admin Console by navigating to Servers->Server Types->WebSphere application servers->SASServer1->Ports->Details to perform this function.

  4. Set the Http ports for the default_host virtualhost alias to match the Http ports for "SASServer1". The following Http port values should be set by either editing the "C:\IBM\WebSphere\AppServer\profiles\SASHOSTNAME01Node\config\cells\SASDmgr01Cell\virtualhosts.xml" file or using the WAS Admin Console by navigating to Environment->Virtual hosts->default_host->Host Aliases to perform this task.

  5. Set Generic JVM Arguments for server "SASServer1" using the WAS Admin Console. after navigating to Servers->Server types->WebSphere application servers->SASServer1->Java and Process Management->Process definition->Java Virtual Machine.
    SASServer1 Generic JVM Arguments (exclude the beginning and ending "quotes"):


  6. Set the required Web Container custom properties for server "SASServer1" using the WAS Admin Console.
    Using the Servers->Server types->WebSphere application servers->SASServer1->Web Container Settings->Web container->Custom Properties menu in the WAS Admin Console, there are two custom properties that must be set for proper SAS web application function.


    Using the Servers->Server types->WebSphere application servers->SASServer1->Session management menu in the WAS Admin Console, set the session management cookie name to ensure a unique JSESSIONID is associated with this server.


  7. Java 2 Security for server "SASServer1" is disabled.
    Java 2 Security has been left disabled for server "SASServer1".

  8. Create the Service Integration Bus for server "SASServer1" using the WAS Admin Console.
    Using the "Service integration" menu in the WAS Admin Console, create a new bus with the name "SAS_Messaging_Bus" (without the "quotes"). Bus security is not enabled for this bus.

  9. Add server "SASServer1" as a member on the Service Integration Bus "SAS_Messaging_Bus" created in the step above using the WAS Admin Console.
    From the the Service integration->Buses menu in the WAS Admin Console, select "SAS_Messaging_Bus", use the Bus members link to add "SASHOSTNAME01Node:SASServer1" as a new member of the bus. The "Server" radio button should be selected with the "SASHOSTNAME01Node:SASServer1" (without the "quotes") drop-down menu item. Choose all the pre-selected and pre-filled defaults on the remaining definition pages.

  10. After saving your work, perform a Full Resynchronize of the dmgr and nodeagent using the WAS Admin Console.
    From the the System administration menu, choose the "SASHOSTNAME01Node" and perform a Full Resynchronize to ensure all new server definitions are propagated from the master repository to the nodeagent.

Creation of server "SASServer1" should now be complete. The base JVM and Web Container configuration for the new "SASServer1" has been completed. All remaining configuration steps will use these base server definitions to complete the customization of the J2EE server functions for the SAS web applications.


Create Mail Session "SASMailSession" at the "SERVER" level.

A new Mail Session named "SASMailSession" has been created at scope "SASDmgr01Cell.SASHOSTNAME01Node.SASServer1" with the following properties:

Values for the Create Mail Session
Scope: Node=SASHOSTNAME01Node, Server=SASServer1
Mail Session Name: SASMailSession
JNDI Name: sas/mail/Session
SMTP Host Name: localhost
Mail Debug: false
Mail Transport Protocol: smtp
Mail SMTP Host Requires Authentication: false

Start server "SASServer1" using: "C:\IBM\WebSphere\AppServer\bin\startServer.bat" "SASServer1" -profileName "SASHOSTNAME01Node"


JMS Queue Connection Factory "SASQueueConnectionFactory" has been created at the "CELL" level.

A new JMS Queue Connection Factory "SASQueueConnectionFactory" definition has been created at scope "SASDmgr01Cell" using information from the following table:

Values for the JMS Queue Connection Factory Definition:
Scope: Cell=SASDmgr01Cell
Connection Factory Type: Queue
Queue Connection Factory name: SASQueueConnectionFactory
JMS resource provider: Default messaging provider
JNDI name: sas/jms/QueueConnectionFactory
Bus name: SAS_Messaging_Bus
Maximum connection pool size: 10
Minimum connection pool size: 1
Connection timeout: 180
Aged timeout: 0
Unused connection timeout: 1800
Reap time: 180
Purge policy: EntirePool

JMS Topic Connection Factory "SASTopicConnectionFactory" has been created at the "CELL" level.

A new JMS Topic Connection Factory "SASTopicConnectionFactory" definition has been created at scope "SASDmgr01Cell" using information from the following table:

Values for the JMS Topic Connection Factory Definition:
Scope: Cell=SASDmgr01Cell
Connection Factory Type: Topic
Topic Connection Factory name: SASTopicConnectionFactory
JMS resource provider: Default messaging provider
JNDI name: sas/jms/TopicConnectionFactory
Bus name: SAS_Messaging_Bus
Maximum connection pool size: 10
Minimum connection pool size: 1
Connection timeout: 180
Aged timeout: 0
Unused connection timeout: 1800
Reap time: 180
Purge policy: EntirePool

JMS Queue "AlertQueue" has been created at the "CELL" level.

A JMS Queue "AlertQueue" and Service Integration Bus Destination "AlertQueue" on Service Integration Bus "SAS_Messaging_Bus" have been created at scope "SASDmgr01Cell" using information from the following table:

Values for the JMS Queue Definition:
Scope: Cell=SASDmgr01Cell
Queue name: AlertQueue
JNDI name: sas/jms/AlertQueue
Bus name: SAS_Messaging_Bus
"SAS_Messaging_Bus" destination: AlertQueue
Delivery mode: Application
Read ahead: AsConnection


JMS Queue "AuditQueue" has been created at the "CELL" level.

A JMS Queue "AuditQueue" and Service Integration Bus Destination "AuditQueue" on Service Integration Bus "SAS_Messaging_Bus" have been created at scope "SASDmgr01Cell" using information from the following table:

Values for the JMS Queue Definition:
Scope: Cell=SASDmgr01Cell
Queue name: AuditQueue
JNDI name: sas/jms/AuditQueue
Bus name: SAS_Messaging_Bus
"SAS_Messaging_Bus" destination: AuditQueue
Delivery mode: Application
Read ahead: AsConnection


JMS Queue "scheduler.pip.jobQueue" has been created at the "CELL" level.

A JMS Queue "scheduler.pip.jobQueue" and Service Integration Bus Destination "scheduler.pip.jobQueue" on Service Integration Bus "SAS_Messaging_Bus" have been created at scope "SASDmgr01Cell" using information from the following table:

Values for the JMS Queue Definition:
Scope: Cell=SASDmgr01Cell
Queue name: scheduler.pip.jobQueue
JNDI name: sas/jms/scheduler.pip.jobQueue
Bus name: SAS_Messaging_Bus
"SAS_Messaging_Bus" destination: scheduler.pip.jobQueue
Delivery mode: Application
Read ahead: AsConnection


JMS Queue "scheduler.pip.outputQueue" has been created at the "CELL" level.

A JMS Queue "scheduler.pip.outputQueue" and Service Integration Bus Destination "scheduler.pip.outputQueue" on Service Integration Bus "SAS_Messaging_Bus" have been created at scope "SASDmgr01Cell" using information from the following table:

Values for the JMS Queue Definition:
Scope: Cell=SASDmgr01Cell
Queue name: scheduler.pip.outputQueue
JNDI name: sas/jms/scheduler.pip.outputQueue
Bus name: SAS_Messaging_Bus
"SAS_Messaging_Bus" destination: scheduler.pip.outputQueue
Delivery mode: Application
Read ahead: AsConnection


JMS Queue "scheduler.pip.resultsQueue" has been created at the "CELL" level.

A JMS Queue "scheduler.pip.resultsQueue" and Service Integration Bus Destination "scheduler.pip.resultsQueue" on Service Integration Bus "SAS_Messaging_Bus" have been created at scope "SASDmgr01Cell" using information from the following table:

Values for the JMS Queue Definition:
Scope: Cell=SASDmgr01Cell
Queue name: scheduler.pip.resultsQueue
JNDI name: sas/jms/scheduler.pip.resultsQueue
Bus name: SAS_Messaging_Bus
"SAS_Messaging_Bus" destination: scheduler.pip.resultsQueue
Delivery mode: Application
Read ahead: AsConnection


JMS Queue "WorkflowCommandQueue" has been created at the "CELL" level.

A JMS Queue "WorkflowCommandQueue" and Service Integration Bus Destination "WorkflowCommandQueue" on Service Integration Bus "SAS_Messaging_Bus" have been created at scope "SASDmgr01Cell" using information from the following table:

Values for the JMS Queue Definition:
Scope: Cell=SASDmgr01Cell
Queue name: WorkflowCommandQueue
JNDI name: sas/jms/WorkflowCommandQueue
Bus name: SAS_Messaging_Bus
"SAS_Messaging_Bus" destination: WorkflowCommandQueue
Delivery mode: Application
Read ahead: AsConnection


JMS Queue "WorkflowQueue" has been created at the "CELL" level.

A JMS Queue "WorkflowQueue" and Service Integration Bus Destination "WorkflowQueue" on Service Integration Bus "SAS_Messaging_Bus" have been created at scope "SASDmgr01Cell" using information from the following table:

Values for the JMS Queue Definition:
Scope: Cell=SASDmgr01Cell
Queue name: WorkflowQueue
JNDI name: sas/jms/WorkflowQueue
Bus name: SAS_Messaging_Bus
"SAS_Messaging_Bus" destination: WorkflowQueue
Delivery mode: Application
Read ahead: AsConnection


JMS Queue "WorkflowEventsQueue" has been created at the "SERVER" level.

A JMS Queue "WorkflowEventsQueue" and Service Integration Bus Destination "WorkflowEventsQueue" on Service Integration Bus "SAS_Messaging_Bus" have been created at scope "SASDmgr01Cell.SASHOSTNAME01Node.SASServer1" using information from the following table:

Values for the JMS Queue Definition:
Scope: Node=SASHOSTNAME01Node, Server=SASServer1
Queue name: WorkflowEventsQueue
JNDI name: sas/jms/app/WorkflowEventsQueue
Bus name: SAS_Messaging_Bus
"SAS_Messaging_Bus" destination: WorkflowEventsQueue
Delivery mode: Application
Read ahead: AsConnection


JMS Topic "NotificationEventTopic" has been created at the "CELL" level.

A JMS Topic "NotificationEventTopic" and Service Integration Bus destination "NotificationEventTopic" on Service Integration Bus "SAS_Messaging_Bus" have been created at scope "SASDmgr01Cell" using information from the following table:

Values for the JMS Topic Definition:
Scope: Cell=SASDmgr01Cell
Topic name: NotificationEventTopic
Topic space: NotificationEventTopic
JNDI name: sas/jms/NotificationEventTopic
Bus name: SAS_Messaging_Bus
"SAS_Messaging_Bus" destination: NotificationEventTopic
Delivery mode: Application
Read ahead: AsConnection


JMS Topic "SASPublishedEventTopic" has been created at the "CELL" level.

A JMS Topic "SASPublishedEventTopic" and Service Integration Bus destination "SASPublishedEventTopic" on Service Integration Bus "SAS_Messaging_Bus" have been created at scope "SASDmgr01Cell" using information from the following table:

Values for the JMS Topic Definition:
Scope: Cell=SASDmgr01Cell
Topic name: SASPublishedEventTopic
Topic space: SASPublishedEventTopic
JNDI name: sas/jms/SASPublishedEventTopic
Bus name: SAS_Messaging_Bus
"SAS_Messaging_Bus" destination: SASPublishedEventTopic
Delivery mode: Application
Read ahead: AsConnection


JMS Topic "scheduler.pip.broadcastTopic" has been created at the "CELL" level.

A JMS Topic "scheduler.pip.broadcastTopic" and Service Integration Bus destination "scheduler.pip.broadcastTopic" on Service Integration Bus "SAS_Messaging_Bus" have been created at scope "SASDmgr01Cell" using information from the following table:

Values for the JMS Topic Definition:
Scope: Cell=SASDmgr01Cell
Topic name: scheduler.pip.broadcastTopic
Topic space: scheduler.pip.broadcastTopic
JNDI name: sas/jms/scheduler.pip.broadcastTopic
Bus name: SAS_Messaging_Bus
"SAS_Messaging_Bus" destination: scheduler.pip.broadcastTopic
Delivery mode: Application
Read ahead: AsConnection


JDBC Provider "SharedServices MySQL JDBC Provider" has been created at the "SERVER" level.

A JDBC Provider "SharedServices MySQL JDBC Provider" definition has been created at scope "SASDmgr01Cell.SASHOSTNAME01Node.SASServer1" using information from the following table:

Values for the JDBC Provider Definition:
Scope: Node=SASHOSTNAME01Node, Server=SASServer1
JDCB Provider Name: SharedServices MySQL JDBC Provider
JDBC Provider Database type: User-defined JDBC Provider
JDBC Provider Classpath:
  • C:\SAS\EBIEDIEG\Lev1\Web\Applications\SASWIPServices9.3\JDBCDrivers\mysql-connector-java-5.1.10-bin.jar
JDBC Provider Implementation class name: com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource
JDBC Provider XA capable: (true or false) false


Data Source "SharedServices" has been created at the "SERVER" level.

A new Data Source "SharedServices" definition has been created at scope "SASDmgr01Cell.SASHOSTNAME01Node.SASServer1" using information from the following table:

Values for the JDBC Data Source Definition:
Scope: Node=SASHOSTNAME01Node, Server=SASServer1
Data Source Name: SharedServices
JNDI Name: sas/jdbc/SharedServices
JDBC Provider Name: SharedServices MySQL JDBC Provider
JDBC Provider Type: User-defined JDBC Provider
Connection URL: jdbc:mysql://HOSTNAME.example.com:3306/SharedServices
Data store helper class name: com.ibm.websphere.rsadapter.GenericDataStoreHelper
JAAS - J2C Authentication Data - JAAS Alias Name: MySQLJAASAlias
JAAS - J2C Authentication Data - JAAS Alias User ID: The User ID used to make the database connection for the "SharedServices" data source.
JAAS - J2C Authentication Data - JAAS Alias Password: The password used to make the database connection for the "SharedServices" data source.
WebSphere Application Server data source properties - Statement cache size: 10

In addition, custom properties for the "SharedServices" Data Source were created with names and values as specified in the following table:

Custom Properties for Data Source "SharedServices"
Custom Property Name: Custom Property Value:
autoReconnect true
connectionCollation utf8_bin
dataSourceName SharedServices
databaseName SharedServices
password The password used to make the database connection for the "SharedServices" data source.
portNumber 3306
relaxAutoCommit true
serverName HOSTNAME.example.com
serverUrl jdbc:mysql://HOSTNAME.example.com:3306/SharedServices
useServerPrepStmts false
user The User ID used to make the database connection for the "SharedServices" data source.


Deployment for application "SASBIDashboard4.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASBIDashboard4.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASBIPortlets4.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASBIPortlets4.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASContentServer9.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASContentServer9.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASFlexThemes3.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASFlexThemes3.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASPackageViewer4.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASPackageViewer4.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASPortal4.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASPortal4.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASStoredProcess9.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASStoredProcess9.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASThemeDesigner3.3ForFlex" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASThemeDesigner3.3ForFlex" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASThemes9.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASThemes9.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASWebDoc9.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASWebDoc9.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASWebInfrastructurePlatformApplications9.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASWebInfrastructurePlatformApplications9.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASWebInfrastructurePlatformServices9.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASWebInfrastructurePlatformServices9.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASWebReportStudio4.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASWebReportStudio4.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASWIPAdmin9.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASWIPAdmin9.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASWIPResources9.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASWIPResources9.3" has been automatically deployed and made ready for SAS operations using the following information:

Deployment for application "SASWorkflow9.3" on "SASServer1".

Because you have requested auto-configuration of WAS and auto-deployment of the SAS web applications, application "SASWorkflow9.3" has been automatically deployed and made ready for SAS operations using the following information:

During Auto-Configure, WebSphere Application Server "SASServer1" has been stopped.
Command executed to stop server "SASServer1" was: "C:\IBM\WebSphere\AppServer\bin\stopServer.bat" "SASServer1" -profileName "SASHOSTNAME01Node"

Starting the WebSphere Server(s)

SAS Web Applications

SAS Themes

Validation steps SAS Themes are used by SAS theme-enabled web applications. If you go to the logon screen for the Portal or Web Report Studio and see images then SAS Themes are working properly.

SAS Web Infrastructure Platform

Log directory C:\SAS\EBIEDIEG\Lev1\Web\Logs
Validation steps
  1. Access the Comment Service.
  2. Log in using the HOSTNAME\sasdemo credentials provided during configuration.
  3. Verify that you can add a comment.

SAS Content Server

Log file C:\SAS\EBIEDIEG\Lev1\Web\Logs\SASContentServer9.3.log
Validation steps
  1. In the SAS Management Console, on the Plug-ins tab, select "+" to expand the Server Manager node.
  2. Highlight the SAS Content Server.
  3. Right mouse click this server and select Validate.
  4. Log in using valid credentials for an unrestricted user defined in the SAS Metadata Server.
  5. You should see a Validation Successful message.

SAS Stored Process Web Application

URL http://HOSTNAME.example.com:9080/SASStoredProcess/do
Log file C:\SAS\EBIEDIEG\Lev1\Web\Logs\SASStoredProcess9.3.log
Validation steps
  1. Access the URL provided above.
  2. Log in using the HOSTNAME\sasdemo credentials provided during configuration.
  3. On the Welcome page, click the "Sample: Shoe Sales by Region" link to access the custom input form for this sample stored process.
  4. Select an ODS style or accept the default value, and click the "Display SAS Output" button.
  5. The output from the stored process is a static table and a clickable chart. Click a bar segment on the chart to drill down to the data for that country.

SAS Web Administration Console

URL http://HOSTNAME.example.com:9080/SASAdmin
Log file C:\SAS\EBIEDIEG\Lev1\Web\Logs\SASAdmin9.3.log
Validation steps
  1. Access the URL provided above.
  2. Log in using the sasadm@saspw credentials provided during configuration.
  3. On the main page, expand the "Environment Management" folder in the tree and select the "Users" node.
  4. Verify that "sasadm" appears in the "Authenticated Users" section in the right frame.
  5. Click the checkbox in the far right column of the "sasadm" row.
  6. Click the menu icon directly above the checkbox and select "Send E-mail".
  7. Enter your email address in the "To:" field and click "Send".
  8. Verify that you received the email.

SAS Web Report Studio

URL http://HOSTNAME.example.com:9080/SASWebReportStudio
Log directory C:\SAS\EBIEDIEG\Lev1\Web\Logs\SASWebReportStudio4.3.log
For more details about how to modify your log format and to see what logging entails, see "Logging for SAS Web Applications" in the SAS Intelligence Platform: Web Application Administration Guide at http://support.sas.com/93administration.
Validation steps
  1. Access the URL provided above.
  2. Login using valid credentials defined in the SAS Metadata Server.

SAS Information Delivery Portal

URL http://HOSTNAME.example.com:9080/SASPortal
Log file C:\SAS\EBIEDIEG\Lev1\Web\Logs\SASPortal4.3.log
For more details about how to modify your log format and to see what logging entails, see "Logging for SAS Web Applications" in the SAS Intelligence Platform: Web Application Administration Guide at http://support.sas.com/93administration.
Validation steps
  1. Access the URL provided above.
  2. Login using the HOSTNAME\sasdemo credentials provided during configuration.
  3. Since the Portal samples were installed, verify that a Home page was created and contains two portlets, My Collections and Bookmarks.
  4. Perform a search to verify that you have access to SAS content.

Notes:

SAS BI Portlets

Log file C:\SAS\EBIEDIEG\Lev1\Web\Logs\SASBIPortlets4.3.log
For more details about how to modify your log format and to see what logging entails, see "Logging for SAS Web Applications" in the SAS Intelligence Platform: Web Application Administration Guide at http://support.sas.com/93administration.
Manual steps
  1. Copy the sas.portlet.container.runtime.extensions.jar file from the 'C:\SAS\EBIEDIEG\Lev1\Web\Staging\exploded\sas.biportlets4.3.ear\lib' directory of the sas.biportlets4.3.ear file to the lib directory of the WebSphere Application Server.
  2. Restart the WebSphere Application Server.
Validation steps
  1. Login to the portal.
  2. Add the SAS Navigator Portlet to a portal page.
  3. Navigate to different locations.

Notes:

SAS BI Dashboard

URL http://HOSTNAME.example.com:9080/SASBIDashboard
Log C:\SAS\EBIEDIEG\Lev1\Web\Logs\SASBIDashboard4.3.log
For more details about how to modify your log format and to see what logging entails, see "Logging for SAS Web Applications" in the SAS Intelligence Platform: Web Application Administration Guide at http://support.sas.com/93administration.
Validation Steps
  1. Grant the user "SAS Demo User" access to SAS BI Dashboard 4.3. In SAS Management Console, on the Plug-ins tab, select the User Manager node.
  2. Right select "BI Dashboard Administrators" and select Properties.
  3. Select the "Members" tab
  4. Double click on SAS Demo User to add it to the group.
  5. Select OK.
  6. Access the URL provided above.
  7. Login using the "HOSTNAME\sasdemo" credentials provided during configuration.
  8. Select Manage Dashboards.
  9. Select New Indicator Data.
  10. Enter a name for the Indicator Data, and then select OK.
  11. Select Data source: SQL query. Enter this SQL query: select * from sashelp.prdsale. Select Apply Query Changes.
  12. File > Save. Navigate to Products/BI Dashboard 4.3/ModelConfigs, and select Save.
  13. File > New > Indicator
  14. Enter a Name for the Indicator. Select Display type: Pie Chart. Select Browse, navigate to the indicator data just created, and select OK. Select OK again.
  15. Select Category value: COUNTRY. Select Response value: ACTUAL.
  16. File > Save. Navigate to Products/BI Dashboard 4.3/IndicatorDefinitions, and select Save.
  17. File > New > Dashboard
  18. Enter a Name for the Dashboard, and select OK.
  19. In the Objects pane, navigate to Products/BI Dashboard 4.3/IndicatorDefinitions. Drag-n-drop the indicator just created onto the dashboard.
  20. File > Save. Navigate to Products/BI Dashboard 4.3/DashboardConfigs, and select Save.
  21. View > Go to Dashboard Viewer
  22. Verify that you have access to this dashboard by adding the BI Dashboard Portlet to a Portal page.
  23. Documentation at http://support.sas.com/documentation/onlinedoc/bidashboard/index.html is available to assist you.

SAS Flex Application Themes

Validation steps SAS Flex Themes are used by SAS theme-enabled Flex applications. If after logging into SAS BI Dashboard you see images then SAS Flex Themes are working properly.
Validation steps SAS Theme Designer for Flex is accessible from http://HOSTNAME.example.com:9080/SASThemeDesignerForFlex.
In order to use this application, you must be a member of the role "Theme Designer for Flex: Administration".

SAS Help Viewer for Midtier Applications

URL http://HOSTNAME.example.com:9080/SASWebDoc
Validation steps Use the URL above and examine the Installed Products Page, if there were any errors configuring help content, they will be reported on that page.

Web Application Custom Content

If you wish to add custom content into SAS web applications, you may do so by placing your custom content into the appropriate custom content directory structure for the given application, and then running the SAS Deployment Manager to rebuild web applications. The custom content root directory for a given web application is

C:\SAS\EBIEDIEG\Lev1\Web\Common\Server Name\Application Name\CustomContent

For example,

C:\SAS\EBIEDIEG\Lev1\Web\Common\SASServer1\SASWebReportStudio4.3\CustomContent

Within that directory, there are subdirectories (for example, ears or wars) corresponding to specific archive types (ear and war files, respectively). Under the archive type directories, there are subdirectories for each specific archive—these are the root directories for each archive within the application. Custom content should be placed in the archive's directory tree corresponding to where the content should appear within the archive.

For example, to add the ear_addon.xml file into the addons directory in the sas.webreportstudio ear file, create the

...\CustomContent\ears\sas.webreportstudio\addons

directory, and place ear_addon.xml in it. Our process knows which war files are contained within ear files, so if you want to add war_addon.jar into the WEB-INF/lib directory in the sas.webreportstudio war file within the sas.webreportstudio ear file, then create

...\CustomContent\wars\sas.webreportstudio\WEB-INF\lib

directory, and place war_addon.jar in it.

Once all your custom content is ready to be consumed, run the SAS Deployment Manager and choose to rebuild web applications. Doing so will rebuild the web applications, inserting the custom content into the archives under the appropriate paths. Note that if custom content has the same path and name of content normally included in the archive, then the custom content takes precedence.

Obtaining Additional Information

Additional SAS Intelligence Platform documentation is available from the SAS 9.3 administration documentation web site.

There may be additional configuration steps required for your SAS Foundation software. Consult the SAS Foundation Configuration instructions available for your operating system for product-specific post-installation steps. The configuration instructions are available from the SAS Install Center web site.

Backing up your SAS Metadata Server

Your metadata server is configured to perform unassisted metadata server backups and roll-forward recovery to a specified point in time. The first backup was taken immediately after the completion of the SAS Metadata Server configuration step. Because roll-forward recovery is configured, all metadata updates made by subsequent configuration steps will be captured in the server's journal file. When your installation is complete, you can choose to execute an ad hoc server backup immediately or wait for the next scheduled backup to occur.

Server backups are requested in the Server Backup node of the SAS Management Console Metadata Manager. Right-click the Server Backup folder and select Run Backup Now from the menu. The default backup configuration performs nightly server backups at 1 a.m. To modify the backup schedule, select Server Backup->Backup Schedule.

Caution: The server backup facility only backs up your metadata server. This includes SAS metadata repositories and metadata server configuration files. It does not include other SAS Intelligence Platform configuration directories or SAS software. You will need to make regular system backups as well as metadata server backups in order to restore your SAS configuration. Metadata server backups should be scheduled to occur just before system backups so that each system backup has a timely metadata server backup.

From the Server Backup node, administrators can also:

Regular metadata server backups using SAS backup tools are crucial to ensuring the health of your SAS 9.3 Intelligence Platform configuration, but they are just one part of backing up a SAS Intelligence Platform configuration. To devise a backup strategy for your entire SAS Intelligence Platform configuration, see "Best Practices for Backing Up and Restoring Your System" in the SAS Intelligence Platform: System Administration Guide at http://support.sas.com/93administration.

Copyright © 2008-2011, SAS Institute Inc., Cary, NC, USA. All Rights Reserved