Configuration Guide

Configuring Apache HTTP Server as a Reverse Proxy Server for SAS 9.3 Web Applications Deployed on Oracle WebLogic Server
ThisdocumentdescribeshowtoconfigureApacheHTTPServerasareverseproxyservertoa WebLogicserverthatishostingSAS9.3Webapplications.Inparticular,thisdocumenthighlights stepsspecifictoSASthatarerequiredwhenyousetupanHTTPserverforSASEnterpriseBIServer Webapplications.YoucansetupanHTTPserverinmanyways,dependingonyourindividual operatingenvironmentandbusinessneeds.However,thisdocumentfocusesononepossible configurationasanexample. Note:TheinformationinthisdocumentsupplementstheOraclesWebLogicServerdocumentation thatdescribeshowtoconfigureApacheHTTPServerwiththeWebLogicserverplugin.The WebLogicServerdocumentationisprovidedinUsingWebServerPlugInswithOracleWebLogic Server.

Configure the WebLogic Server Plug-In to Apache HTTP Server

ToconfigureApacheHTTPServerwiththeWebLogicServerplugin,followthesesteps: 1. LocatethecorrectplugininWL_HOME/server/plugin/ basedonyouroperatingsystem andarchitecture: OperatingSystem Solaris Location WL_HOME/server/plugin/solaris/sparc WL_HOME/server/plugin/solaris/sparc/largefile WL_HOME/server/plugin/solaris/x86 WL_HOME/server/plugin/solaris/x86/largefile WL_HOME/server/plugin/win/32 WL_HOME/server/plugin/hpux11/IPF64 WL_HOME/server/plugin/aix/ppc WL_HOME/server/plugin/linux/x86_64 Note that for SAS 9.3, SAS only supports the Midtier on 64-bit servers. Only a 32-bit Apache Plugin is made available in the Weblogic installation. The user can run a 32-bit Apache in front of 64-bit Weblogic servers.

Windows32bit HPUX11i AIX Linux Windows

1 02 MAY 2012

Afterlocatingthecorrectdirectory,choosethecorrectfile: ApacheHTTPServerVersion StandardApacheVersion2.0.x (NotethatOraclehas deprecatedthe2.0.xApache pluginasofWLS10.0.Itisstill availableandsupportedwith WLS10.3,but2.2.xis recommended.) StandardApacheVersion2.2.x 2. 3. mod_wl_22.so mod_wl128_22.so RegularEncryption mod_wl_20.so 128bitEncryption mod_wl128_20.so

CopytheplugintotheAPACHE_HOME/modulesdirectory. EdittheAPACHE_HOME/conf/httpd.conffilesothatApacheHTTPServer: loadstheWebLogicplugin configuresthepluginwithinformationabouttheWebLogicServer usesthepluginfortheSASWebapplications

AddtheLoadModule,IfModule,andLocationdirectivestothehttpd.conffile.Seethe followingexample: LoadModule weblogic_module modules/mod_wl_22.so <IfModule mod_weblogic.c> Include conf/weblogic.conf </IfModule> 4. CreatetheAPACHE_HOME/conf/weblogic.conffile.Thefollowinglinkcontainsa configurationfileandinstructionsthatcanbecopiedandpasted: support.sas.com/resources/thirdpartysupport/v93/appservers/ApacheWeblogicConfig.txt.

Deploy SAS Web Application Themes and SAS Flex Application Themes to an HTTP Server
SASWebApplicationThemes(SASThemes)enableyoutoapplyuniformvisualcustomizationtoyour SASWebapplications.Similarly,SASFlexApplicationThemes(SASFlexThemes)providemorevisual customizationandinteractivityforFlexapplications.Thesethemesets,whicharecollectionsof HTMLresourcessuchasimagesandcascadingstylesheets,resideonthesameWebapplication server.SASrecommendsthatyoudeploySASThemesandSASFlexThemescontenttoanHTTP serverinordertoshifttheprocessingloadofservingstaticHTMLfilesfromtheWebapplication servertotheHTTPserver. ThefollowingstepsexplainhowtodeploySASThemesandSASFlexThemestotheopensource ApacheHTTPServer.TheprocessfordeployingthethemestootherHTTPserversissimilar.
2 02 MAY 2012

TodeploytheSASThemes: 1. 2. NavigatetoAPACHE_HOME/htdocsandcreateanewdirectorynamed SASTheme_default. NavigatetoSAS-configuration-directory/Levn/Web/Staging/exploded/.From thisdirectory,copythecontentsofsas.themes.earinto APACHE_HOME/htdocs/SASTheme_default.

TodeploytheSASFlexThemes: 1. 2. NavigatetoAPACHE_HOME/htdocsandcreateanewdirectorynamedSASFlexThemes. NavigatetoSAS-configuration-directory/Levn/Web/Staging/exploded/.From thisdirectory,copythecontentsofsas.flexthemes2.5.3.earinto APACHE_HOME/htdocs/SASFlexThemes.

Change the Connections for the SAS Web Applications

AfterSASThemesandFlexApplicationThemesaredeployedtotheHTTPserverandtheSASWeb applicationsaredistributedtodifferentservers,informationabouthowto accesstheapplicationssuchashostandportmustbeupdatedinSASmetadata.Change theconnectioninformationtoaURLthatincludestheloadbalancingHTTPserverhost nameandport. Tochangetheconnectionaccesspoint,followthesestepsinSASManagementConsole. 1. Select ApplicationManagement ConfigurationManager. 2. RightclicktheSASWebapplicationthatyouwanttoreconfigure,andselectProperties.

3. ClicktheConnectiontab,setHostNameandPortNumbertothehostnameandportnumber oftheloadbalancingHTTPserver,andthenclickOK.

Change the Connection for SAS Content Server

SimilartothechangerequiredforeachoftheSASWebapplications,SASmetadatamustbechanged toidentifythehostnameandportoftheHTTPserver.Toreconfigurethehostnameandportofthe SASContentServerinSASmetadata,followthesestepsinSASManagementConsole: 1. 2. 3. 4. 5. 6. 7. SelectServerManagerSASContentServer. RightclicktheConnection:SASContentServericonintherightpanelandselect Properties. ClicktheOptionstabandsettheHost nameandPort numbervaluestothehostname andportnumberoftheHTTPserver. ClickOK. InSASManagementConsole,clicktheFolderstab. RightclicktheSAS Folders iconattherootofthefoldertreeintheleftpaneandselect Properties. ClicktheContentMappingtabandusetheServermenutoselectSASContentServer. TheURLfieldthenshowstheHTTPServerhostnameandport.ClickOK.
3 02 MAY 2012

Change the WebDAV Repository URL

Justasinthepreviousstep,becauseSASContentServerisaccessedthroughtheHTTPserver,you mustreconfigureSASmetadatawiththeconnectioninformationfortheWebDAVrepository.The followingapplicationsuseSASmetadatatoidentifytheconnectioninformationfortheWebDAV repositoryprovidedbySASContentServer: RemoteServices SASBIPortlets4.3LocalServices SASJSR168ReportPortlet4.3LocalServices SASPackageViewer4.3LocalServices SASPortal4.3LocalServices SASStoredProcess9.3LocalServices SASWebReportStudio4.3LocalServices

ToreconfiguretheWebDAVURLfortheapplications,followthesestepsinSASManagement Console: 1. 2. 3. 4. 5. 6. 7. 8. 9. SelectEnvironmentManagementFoundationServicesManager. SelecttheapplicationandthenselectCoreInformationService. RightclickInformationServiceandselectProperties. IntheInformationServicePropertiesdialogbox,clicktheServiceConfigurationtab andthenclickConfiguration. IntheInformationServiceConfigurationdialogbox,clicktheRepositoriestab. SelectWebDAVandthenclickEdit. ChangetheHostandPortvaluestothehostnameandportoftheHTTPserver. ClickOKtoclosetheInformationServiceConfigurationdialogbox. ClickOKtoclosetheInformationServicePropertiesdialogbox.

10. RestartSASRemoteServicesandtheWebapplicationserversthatarehostingtheSAS ContentServerapplication.

Disable the Redirection Filter for the SAS Web Applications

Bydefault,theSASWebapplicationsuseaspecialredirectionfilter.WhenusedwithanHTTPserver, thisfiltermustbedisabled.StartSASManagementConsole,andthenfollowthesesteps: 1. 2. 3. 4. SelectApplicationManagement ConfigurationManager. RightclickSASApplicationInfrastructure,andselectProperties. ClickAdvanced,andthenclickAdd. EnterapropertynameofApp.RedirectionFilterDisabledandavalueoftrue.

4 02 MAY 2012

Start the Software Applications and Verify the Configuration

Startthesoftwareapplicationsinthefollowingorder: 1. 2. 3. SASRemoteServices ApacheHTTPServer theWebapplicationserver

AftertheWebapplicationserverisavailableandtheSASWebapplicationsareactive,verifythatthe configurationisvalidbyopeningaWebbrowsertoanapplicationsuchasSASInformationDelivery Portal:your-http-server/SASPortal.Iftheconfigurationisvalid,thenyouarechallengedfor logoncredentialsandthentheSASInformationDeliveryPortalapplicationisavailable.

Troubleshooting
Thefollowinglistidentifiesthehighlevelstepsusedtotroubleshootthisconfiguration: 1. ConfirmthatApacheHTTPServerisrunningandthatyourWebbrowserisconnectingto ApacheHTTPServerbyviewingtheAPACHE_HOME/logs/access.logfileasyoumakea request. UncommenttheDebugandDebugConfigInfooptionsinthehttpd.conffileandrestart ApacheHTTPServer. TheDebugoptionenablesloggingfromtheWebLogicServerplugintorecorddebugging informationto/tmp/wlproxy.loginUNIXoperatingenvironmentsand c:\TEMP\wlproxy.loginWindowsoperatingenvironments. TheDebugConfigInfooptionenablesviewingtheconfigurationparametersfortheplug in.WhenthisoptionisON,itenablesaspecialqueryparameter, __WebLogicBridgeConfig. Inyourbrowser,navigatetoyour-httpserver/SASPortal?__WebLogicBridgeConfig. IftheWebpagedoesnotdisplayatall,theneitherApacheHTTPServerortheWebLogic Serverpluginisnotinstalledcorrectly.IftheWebpagedoesdisplay,thenconfirmthathost, port,andstatusisOKfortheserversintheGeneralServerList. 3. ViewtheWebLogicServerlog.IfthereisnoactivityinthelogwhenaURLforaSASWeb applicationisaccessed,thencheckthefollowingitems: UseSASManagementConsoletoreviewthepropertiesfortheSASWebapplication andconfirmthatthehostandportvaluesaresettotheApacheHTTPServer.Usethe informationinsectionError!Referencesourcenotfound.forinstructionsonhow toaccessthemetadata. UsetheWebLogicServerAdministrationConsoletochecktheserverstartup parameters.ConfirmthattheDsas.auto.publish.port=parameteridentifies theportthattheWebLogicServerislisteningon.ForasingleWebLogicServer topology,theSASDeploymentWizardsetstheportto7001.
5 02 MAY 2012

2.

Recommended Reading
ThefollowingURLsarecurrentasofJuly2011. OracleCorporation.2011.OracleFusionMiddlewareUsingWebServerPlugInswithOracleWebLogic Server.Availableat download.oracle.com/docs/cd/E21764_01/web.1111/e14395/toc.htm.
SAS and all other SAS Institute product or service names are registered trademarks or trademarks of SAS Institute Inc. in the USA and other countries. Other brand and product names are registered trademarks or trademarks of their respective companies. indicates USA registration. Copyright 2012 SAS Institute Inc., Cary, NC, USA. All rights reserved. 6 02 MAY 2012