Rebuilding the SAS Web Applications

When to Rebuild the SAS Web Applications

The Rebuild Web Applications feature of the SAS Deployment Manager provides an automated way to rebuild the Web applications that are deployed in your environment. You should rebuild the Web applications in the following situations:
  • You might need to rebuild applications that you have reconfigured. For example, if you change the HTTP time-out interval for an application, then you should rebuild the application.
    Note: This administration guide informs you when an application must be rebuilt after reconfiguration.
  • Rebuild an application after you change the Java security configuration for the application.
  • If a custom theme is created for your organization, then rebuild the SAS Web Application Themes.
  • If custom content is created, then add files to the WAR directory and rebuild the application to which the custom content applies. For example, to create custom forms for SAS Stored Process, place the file for the EAR or the WAR in the SAS-config-dir\Lev1\Web\Common\SASServer1\SASStoredProcess9.3\CustomContent\ears\sas.storedprocess\input directory. Then, use the SAS Deployment Manager to rebuild the SAS Stored Process application.
  • If custom portal content is created, such as a custom portlet, then rebuild the SAS Information Delivery Portal. For more information, see Rebuild Web Applications.
  • Rebuild SAS Help Viewer for Midtier Applications after your initial deployment if you install or upgrade a SAS Web application that offers online Help. (SAS Help Viewer for Midtier Applications combines SAS Help Viewer for the Web software with various help content into its EAR file.)
    The following Web applications use SAS Help Viewer for Midtier Applications:
    • SAS Information Delivery Portal Help
    • SAS Web Report Studio Help
    • SAS Web Report Viewer Help
    • SAS BI Dashboard Help
    • SAS Comment Manager Help
  • After installing a maintenance release or hot fixes, rebuild the EAR files for all Web applications that were updated at your site. Follow the instructions in the maintenance documentation or the hot fix instructions. Because the EAR files are rebuilt, you might lose any customizations that you added to the EAR files after initial deployment.

Rebuild Web Applications

The Rebuild Web Applications option in the SAS Deployment Manager enables you to rebuild one or more Web applications. The rebuild process updates two directories for each rebuilt Web application:
  • SAS-config-dir\Lev1\Web\Staging. An EAR file for each rebuilt Web application is placed in this directory.
    The approximate size of the collection of EAR files for EBI is 2 GB.
  • SAS-config-dir\Lev1\Web\Staging\exploded. An exploded version of each rebuilt Web application is placed in this directory.
    The approximate size of the entire exploded directory is 2 GB. The size is similar to the size of all the EAR files in the Staging directory.
    Note: You can delete any unwanted directories in the exploded directory to save disk space.
To rebuild one or more Web applications, follow these steps:
  1. The Web application server can be running or stopped.
    • For WebLogic Server, the administration server and nodemanager can be running or stopped.
    • For WebSphere Application Server, the dmgr and nodeagent can be running or stopped.
  2. Make sure that the SAS Metadata Server is running.
  3. Start the SAS Deployment Manager.
  4. Select Rebuild Web Applications and click Next.
  5. Specify the configuration directory and the level (for example, Lev1) on the Select Configuration Directory/Level page. Click Next.
  6. Enter the user ID and password for an unrestricted administrative user (for example, sasadm@saspw) on the Specify Connection Information page. Click Next.
  7. Select the check boxes for the Web applications that you want to rebuild and click Next.
  8. Review the Summary page and click Start. The SAS Deployment Manager builds the EAR files for the selected applications. For the names and location of the EAR files, see Names of the Web Applications and EAR Files.
  9. If you are rebuilding theme content, you might need to stop and restart the Web application server as follows:
    • If SAS Web Application Themes is deployed as an EAR in a Web application server, then the first time a custom theme is deployed, the Web application server must be stopped and restarted. Any subsequent modifications to the custom theme do not require a restart of the Web application server unless the theme descriptors have been changed.
    • If SAS Web Application Themes is exploded and deployed in an HTTP server (such as Apache HTTP Server), then the Web application server does not need to be restarted based on any theme changes.
After rebuilding the Web applications, the next action is typically to redeploy them. See Redeploying the SAS Web Applications.

Names of the Web Applications and EAR Files

The files for the SAS Web applications are stored in the following directories:
  • SAS-config-dir\Lev1\Web\Staging
  • SAS-config-dir\Lev1\Web\Staging\exploded
When the SAS Deployment Manager is used to rebuild a Web application, the files for the Web application in the previous directories are overwritten. The following table identifies the product configuration name that is used in the SAS Deployment Manager for the Web applications that are part of the SAS Enterprise Business Intelligence Server. Use this table to understand which Web applications and EAR files are updated when a product configuration is selected in the SAS Deployment Manager.
Product Configuration, Web Application, and EAR Filenames
Product Configuration
Application
EAR File
BI Dashboard 4.3
SAS BI Dashboard
sas.bidashboard4.3.ear
BI Portlets 4.3
SAS BI Portlets
sas.biportlets4.3.ear
Flex Application Themes
SAS Flex Application Themes
sas.flexthemes3.4.ear
SAS Theme Designer for Flex
sas.themedesigner3.4.ear
Help Viewer for Midtier App 9.3
SAS Help Viewer for Midtier Applications
sas.webdocmd9.3.ear
Information Delivery Portal 4.3
SAS Information Delivery Portal
sas.portal4.3.ear
SAS Package Viewer
sas.packageviewer4.3.ear
SAS Themes
SAS Web Application Themes
sas.themes.ear
Web Infrastructure Platform 9.3
SAS Content Server
sas.wip.scs9.3.ear
SAS Stored Process
sas.storedprocess9.3.ear
SAS Web Administration Console
sas.wip.admin9.3.ear
SAS Web Infrastructure Platform Applications
sas.wip.apps9.3.ear
SAS Web Infrastructure Platform Resources
sas.wip.resources9.3.ear
SAS Web Infrastructure Platform Services
sas.wip.services9.3.ear
SAS Workflow
sas.workflow9.3.ear
Web Report Studio 4.3
SAS Web Report Studio
sas.webreportstudio4.3.ear