SAS Web Report Studio :: Planning for Maintenance Releases and Product Upgrades for SAS(R) 9.2

Product Release Number

After you apply the third maintenance release for SAS 9.2, the product release number for SAS Web Report Studio is 4.2_M2. For more information, see About the Deployment Summary.

New Functionality: LSF Services Group

In the second maintenance release for SAS 9.2, the LSF Services group was added. This user group enables SAS Web Report Studio to schedule jobs by using the Platform Suite for SAS. The group uses the login and password of the user ID that schedules reports in SAS Web Report Studio (typically, lsfuser). The SAS Deployment Wizard for the third maintenance release for SAS 9.2 automatically creates this group for new installations of SAS Web Report Studio that use scheduling with the Platform Suite for SAS. The password for the user ID lsfuser is managed by the SAS Deployment Manager.

Post-Configuration Steps for SAS Web Report Studio

When These Post-Configuration Steps Are Required

Use the following table to determine what (if any) post-configuration steps you need to complete. To determine the product release number for SAS Web Report Studio, see the deployment registry report that you generated before you applied the third maintenance release. For more information, see Determining the Product Release Numbers for Products at Your Site.

When Post-Configuration Steps Are Required

Update Scenario	Are Post-Configuration Steps Required?
You are using the SAS Deployment Wizard for the third maintenance release for SAS 9.2 to install and configure a new installation of SAS Web Report Studio.	No The LSF Services Group is created automatically.
You are applying the third maintenance release, and the product release number for SAS Web Report Studio is 4.2_M1.	No The 4.2_M1 product release number indicates that you previously applied the second maintenance release for SAS 9.2 at your site. When you applied the second maintenance release, you completed the required post-configuration steps. Therefore, you do not need to complete these steps again.
You are upgrading from SAS Web Report Studio 4.2 to SAS Web Report Studio 4.3.	For more information about the new release and the steps for upgrading to this new release, see SAS Web Report Studio 4.3.
You have enabled scheduling that uses the Platform Suite for SAS in the SAS Web Report Studio configuration.	No The LSF Services Group is created automatically.
The Platform Suite for SAS is included in the plan file for the second maintenance release for SAS 9.2.	No The LSF Services Group is created automatically.
You are applying the third maintenance release to an existing SAS 9.2 deployment, and the product release number for SAS Web Report Studio is 4.2.	Yes The 4.2 product release number indicates that you have not applied the second maintenance release for SAS 9.2. Maintenance releases are cumulative. Therefore, when you apply the third maintenance release, you will also receive the changes that were part of the second maintenance release for SAS 9.2. For the post-configuration steps, see Create the LSF Services Group.

Create the LSF Services Group

If you installed and configured SAS Web Report Studio by using the SAS Deployment Wizard for any release before the second maintenance release for SAS 9.2, and you did not apply the second maintenance release for SAS 9.2, then you must manually create the LSF Services Group. To create the group:

Use the User Manager plug-in in SAS Management Console to create a new authentication domain. Select ActionsAuthentication Domains. The domain must be named LSFServicesAuthWRS.
Use the User Manager plug-in in SAS Management Console to create a new group. The group must be named LSFServices.
In the Properties dialog box for the LSFServices group, click the Accounts tab and add the user ID that schedules reports in SAS Web Report Studio (typically, lsfuser).

In Windows systems, you must preface the user ID with a domain (for example, domain\lsfuser).

Select the LSFServicesAuthWRS authorization domain for the user.

Provide the password for the user ID.
On the Members tab, add the user ID for the trusted user (SAS Trusted User) to the LSFServices group.

Changing the Location of the Temporary Workspace

About Changing the Location of the Temporary Workspace

In SAS Web Report Studio 4.2, the wrs.io.tmpdir property has been added. This property ensures that you can change the location of the temporary workspace for SAS Web Report Studio and the SAS Web Report Viewer. To determine the directory path for the temporary workspace, see SAS-configuration-directory\Lev1\Web\Logs\SASWebReportStudio4.3.log.

To change the location of the temporary workspace, you can perform the following tasks in either SAS Web Report Studio or SAS Web Report Viewer:

Change the properties by using the Configuration Manager plug-in in SAS Management Console.
Modify the LocalProperties.xml file. For information about the LocalProperties.xml file, see “Configuring SAS Web Report Studio” in the SAS Intelligence Platform: Web Application Administration Guide.

SAS Web Report Studio

To change the location of the temporary workspace by using the Configuration Manager:

In SAS Management Console, expand the Plug-insApplication ManagementConfiguration Manager folder. Right-click the Web Report Studio 4.2 folder and select Properties. The Web Report Studio 4.2 Properties window appears.
Click the Advanced tab.
Enter the sas.webreportstudio.cleanup.temp.directory property.
Change the value of the property to the value of the location that you want to use for the temporary workspace (for example, C:\Temp\WRSTEMP).
Enter the wrs.io.tmpdir property.
Change the value of the property to the value of the location that you want to use for the temporary workspace (for example, C:\Temp\WRSTEMP).
Click OK to exit the Properties window.

To change the location of the temporary workspace by modifying the LocalProperties.xml file:

Locate the LocalProperties.xml file for SAS Web Report Studio. The file is located in SAS-configuration-directory\Lev1\Web\Applications\SASWebReportStudio4.2\customer. If the file does not exist, copy and rename the LocalProperties.xml.sample file to LocalProperties.xml.

Add the following lines to the LocalProperties.xml file for SAS Web Report Studio. This example uses a new location of C:\Temp\WRSTEMP.

 <sas.webreportstudio.file.cleanup.temp.directory>
      C:\Temp\WRSTEMP\sas.wrs.tmpfiles
</sas.webreportstudio.file.cleanup.temp.directory>
<wrs.io.tmpdir>
   C:\Temp\WRSTEMP\sas.wrs.tmpfile
</wrs.io.tmpdir>

SAS Web Report Viewer

Note: If SAS Web Report Studio is not deployed at your site, the SAS Web Report Viewer application is deployed. SAS Web Report Viewer contains a subset of the functionality that is available in SAS Web Report Studio. The property names for SAS Web Report Viewer are the same as the property names for SAS Web Report Studio. For more information, see “About SAS Web Report Viewer” in the SAS Intelligence Platform: Web Application Administration Guide.

To change the location of the temporary workspace by using the Configuration Manager:

In SAS Management Console, expand the Plug-insApplication ManagementConfiguration Manager folder. Right-click the Web Report Viewer 4.2 folder and select Properties. The Web Report Viewer 4.2 Properties window appears.
Click the Advanced tab.
Enter the sas.webreportstudio.cleanup.temp.directory property.
Change the value of the property to the value of the location that you want to use for the temporary workspace (for example, C:\Temp\WRSTEMP).
Enter the wrs.io.tmpdir property.
Change the value of the property to the value of the location that you want to use for the temporary workspace (for example, C:\Temp\WRSTEMP).
Click OK to exit the Properties window.

To change the location of the temporary workspace by modifying the LocalProperties.xml file:

Locate the LocalProperties.xml file for SAS Web Report Viewer. The file is located in SAS-configuration-directory\Lev1\Web\Applications\SASWebReportViewer4.2\customer. If the file does not exist, copy and rename the LocalProperties.xml.sample file to LocalProperties.xml.

Add the following lines to the LocalProperties.xml file for SAS Web Report Viewer. This example uses a new location of C:\Temp\WRSTEMP.

 <sas.webreportstudio.file.cleanup.temp.directory>
      C:\Temp\WRSTEMP\sas.wrs.tmpfiles
</sas.webreportstudio.file.cleanup.temp.directory>
<wrs.io.tmpdir>
   C:\Temp\WRSTEMP\sas.wrs.tmpfile
</wrs.io.tmpdir>