Administering the SAS Content Server |
SAS Web applications such as the SAS Information Delivery Portal and SAS Web Report Studio require the availability of content for its users. The SAS Content Server contains a content repository that stores digital content (such as documents, reports, and images) that is created and used by SAS client applications. Beginning with SAS BI Dashboard 4.3, dashboard files are stored in this content repository.
To enable the availability of DAV content in the SAS Content Server, you can load content, update existing content, and adjust Web applications that store SBIP URLs. These tasks can be automated or they can be performed manually.
The following table shows the choices available in the SAS Deployment Wizard, and the results or manual tasks that follow these choices.
Options Selected in SAS Deployment Wizard | Results and Instructions for Manual Tasks |
---|---|
Web Application Server: Automatic Configuration
Web Application Server: Automatic
Deployment |
The Web application server is configured automatically. SAS Web applications are deployed automatically, and content is loaded to the SAS Content Server. If applicable, Web applications that store SBIP URLs are adjusted automatically. |
Web Application Server: Automatic Configuration Manually deploy Web applications, load the content to the SAS Content Server, and adjust any Web applications that store SBIP URLs. |
The Web application server is configured automatically. Instructions are provided on how to manually deploy SAS Web applications, load content to the SAS Content Server, and adjust any Web applications that store SBIP URLs. |
Manually configure the Web application server, deploy the Web applications, load the content to the SAS Content Server, and adjust any Web applications that store SBIP URLs. | Instructions are provided on how to perform all tasks manually. |
The following table shows when you can load or update content (and adjust URLs) either automatically or manually.
Configuration of Web Application Server | Deployment of Web Applications | Load Content | Update Content | Adjust URLs |
---|---|---|---|---|
Automatic | Automatic | Automatic | Automatic | Automatic |
Automatic | Automatic | Manual | Manual | Manual |
Manual | Manual | Manual | Manual | Manual |
The following table shows the files associated with loading content to the SAS Content Server or updating content. The filename for the batch or script file includes the order number.
Manual Task | Directory Path and Filename |
---|---|
Load content to the SAS Content Server. |
On
Windows:
SAS-configuration-directory\Lev1\Web\Utilities\manualLoadContent-OrderNumber.bat On UNIX and z/OS:
SAS-configuration-directory/Lev1/Web/Utilities/manualLoadContent-
OrderNumber.sh |
Update content in the SAS Content Server. |
On Windows:
SAS-configuration-directory\Lev1\Web\Utilities\manualUpdateContent-OrderNumber.bat On UNIX and z/OS:
SAS-configuration-directory/Lev1/Web/Utilities/manualUpdateContent-
OrderNumber.sh |
Adjust URLs for Updated Content. |
On
Windows:
SAS-configuration-directory\Lev1\Web\Utilities\manualAdjustUrls-OrderNumber.bat On UNIX and z/OS:
SAS-configuration-directory/Lev1/Web/Utilities/manualAdjustUrls-
OrderNumber.sh |
Load Content Manually to the SAS Content Server |
If you deploy SAS Web applications manually, you need to load content manually to the SAS Content Server. For information about how to load content manually for SAS Web applications, see your Instructions.html file.
Use the following batch file or shell script to load content manually:
On Windows:
SAS-configuration-directory\Lev1\Web\Utilities\manualLoadContent-OrderNumber.bat
On UNIX and z/OS:
SAS-configuration-directory/Lev1/Web/Utilities/manualLoadContent.sh-OrderNumber.sh
If Web applications were deployed manually, this script contains the credentials for the SAS Administrator, as well as the SAS Trusted User. The password is always encrypted in the file. After loading content successfully, delete the file or remove credentials for the SAS Administrator and the SAS Trusted User.
If Web applications were deployed automatically, the script does not contain the required credentials. You will need to manually enter the required credentials in this script file.
Detailed log messages are written to the product-name_loadContent_date-and-time.log file.
These logs are located in these locations:
On Windows:
SAS-configuration-directory\Lev1\Logs\Configure
On UNIX and z/OS:
SAS-configuration-directory/Lev1/Logs/Configure
Update Content Manually for the SAS Content Server |
If you deploy updated SAS Web applications manually, you must manually update the DAV content in the SAS Content Server. For more information, see your UpdateInstructions.html file, which is located in the SAS-configuration-directory /Lev1/Documents directory.
Here are some reasons why you would update content manually:
During a migration or upgrade to the November 2010 release of SAS 9.2, data explorations must be converted to reports. URL references should be adjusted to refer to metadata that has moved either during migration or an upgrade. For more information, see "Server Tier Post-migration Tasks" in SAS Intelligence Platform: 9.1.3 to 9.2 Migration Guide.
Before portal content is promoted to SAS Information Delivery Portal 4.3, data explorations must be converted to reports and directive URLs should be adjusted manually. For more information, see Promote the Entire Portal Application Tree.
Use the following batch file or shell script to update the DAV content manually:
On Windows:
SAS-configuration-directory\Lev1\Web\Utilities\manualUpdateContent-OrderNumber.bat
On UNIX and z/OS:
SAS-configuration-directory/Lev1/Web/Utilities/manualUpdateContent-OrderNumber.sh
If Web applications were deployed manually, this script contains the credentials for the SAS Administrator, as well as the SAS Trusted User. The password is always encrypted in the file. After loading content successfully, delete the file or remove credentials for the SAS Administrator and the SAS Trusted User.
If Web applications were deployed automatically, the script does not contain the required credentials. You will need to manually enter the required credentials in this script file.
Detailed log messages are written to a file called product-name _updateContent_date-and-time.log
These log files are located in the following directories:
One Windows:
SAS-configuration-directory\Lev1\Logs\Configure
On UNIX and z/OS:
SAS-configuration-directory/Lev1/Logs/Configure
Adjust Directive URLs Manually |
Directive URLS are updated either during the migration of a product from one version to another version, or when a product's content is modified and updates are required. When the script is run to adjust URLs, it updates references to metadata that has moved either during migration or an upgrade. These references are stored as SBIP URLs.
Here are some reasons why you would adjust directive URLs manually:
During a migration or upgrade to the November 2010 release of SAS 9.2, data explorations must be converted to reports and URL references should be adjusted to refer to metadata that has moved either during migration or an upgrade. For more information, see "Server Tier Post-migration Tasks" in SAS Intelligence Platform: 9.1.3 to 9.2 Migration Guide.
Before portal content is promoted to SAS Information Delivery Portal 4.3, the data explorations must be converted to reports and directive URLs should be adjusted manually. For more information, see Promote the Entire Portal Application Tree.
Use the following script files when it is necessary to manually adjust URLs:
manualAdjustUrls.bat-OrderNumber.bat
manualAdjustUrls.sh-OrderNumber.sh
Here are some examples of instances where there is a need to manually adjust URLs:
When a migration is performed, some reports might be moved to a user's home folder. If there were reference to the data in those reports (in the form of SBIP URLs), those references would be updated.
During a migration or an upgrade, data explorations are converted to reports. If there were references to the data explorations (in the form of SBIP URLs), those references would be updated.
After updating content manually for the SAS Content Server, adjust directive URLs manually by running the appropriate script or batch file:
On Windows:
SAS-configuration-directory\Lev1\Web\Utilities\manualAdjustURLs-OrderNumber.bat
On UNIX and z/OS:
SAS-configuration-directory/Lev1/Web/Utilities/manualAdjustURLs-OrderNumber.sh
The instructions for running the script or batch file is provided in the Instructions.html during a migration or the UpdateInstructions.html file during an upgrade. The script contains the credentials for the SAS Administrator, as well as the SAS Trusted User. The password is always encrypted. When you have successfully loaded the content, delete the file or remove the credentials for the SAS Administrator and the SAS Trusted User.
When URLs are updated, log files are produced for each SAS Web application. Detailed log messages are written to a file called product-name _adjustUrls_date-and-time.log
These log files are located in the following directories:
One Windows:
SAS-configuration-directory\Lev1\Logs\Configure
On UNIX and z/OS:
SAS-configuration-directory/Lev1/Logs/Configure
Copyright © 2010 by SAS Institute Inc., Cary, NC, USA. All rights reserved.