Configuring SAS Products

About Configuring SAS Products

You can configure SAS products that are new to your deployment, or configure SAS products that you are updating or upgrading:

Configure SAS Products

Follow these steps to use the SAS Deployment Wizard to configure SAS products that you have already installed.
  1. Make sure that the machine where you want to add the new SAS 9.3 software contains the necessary user accounts, groups, and ports.
    For more information, see Setting Up Users, Groups, and Ports.
  2. Back up your metadata repository and repository manager on the SAS Metadata Server machine. For more information, see Best Practices for Backing Up and Restoring Your SAS Content in SAS Intelligence Platform: System Administration Guide.
  3. Make a backup copy of your SAS 9.3 configuration directories by using your site-approved method. Your SAS configuration directories are all the child directories beneath the configuration path that was specified during the initial SAS 9.3 deployment on the Specify Configuration Information wizard page.
  4. If you are reconfiguring SAS Web Parts for Microsoft SharePoint that was deployed manually, read the following topic before proceeding: Reconfiguring SAS Web Parts for Microsoft SharePoint in SAS Intelligence Platform: Web Application Administration Guide.
  5. Make sure that your SAS server and middle tiers are running. Your Web application server (JBoss, WebSphere Application Server, or WebLogic Server) should not be running.
    For more information, see Operating Your Servers in SAS Intelligence Platform: System Administration Guide.
  6. Make sure that you use a deployment plan that contains any add-on products as well as all original products for the machine that you are configuring.
    Where is My Deployment Plan?
    SAS 9.3 Products Being Added
    Location of My Deployment Plan
    Are part of my original SAS 9.3 order
    In the plan_files directory in the original SAS Software Depot
    Are on a machine where a SAS 9.3 server, middle tier, or data tier already resides
    In the SAS configuration directory in the Utilities directory
    Are part of my new SAS 9.3 order
    In the plan_files directory in the SAS Software Depot
  7. Log on to the machine on which you want to add the new SAS 9.3 products as the SAS Installer user. This is the user with which your SAS deployment was installed. For more information, see Required External User Accounts for SAS.
  8. Start the SAS Deployment Wizard from the highest-level directory in your SAS Software Depot using the command appropriate for your operating system.
    Note: If you want to use a different Java Runtime Environment, you must invoke the deployment wizard with a special start up option, -forcejreprompt. For more information, see Specify a Different JRE.
    Start Up Commands for the SAS Deployment Wizard
    Operating System
    Command
    Windows
    setup.exe -record -deploy
    UNIX
    setup.sh -record -deploy
    z/OS
    setup.rexx -record -deploy
    To use a temporary directory other than /tmp, specify -templocation new-temp-dir.
    For more information, see Creating SAS Software Depots.
    You should see a welcome page similar to the following:
    SAS Deployment Wizard splash screen
  9. Select the language that you want the SAS Deployment Wizard to use when it displays text.
  10. Select Install SAS Software.
  11. If you have more than one SAS software order in your depot, the wizard prompts you to select the order that you want to configure.
  12. If the wizard detects that there are SAS software products in your order that are more recent than what you have deployed on your machine, then the wizard automatically goes into Update mode.
    If you need to install product updates, then follow these steps:
    1. Install the updates using the SAS Deployment Wizard.
    2. When you are finished performing any required manual configuration steps, rerun the SAS Deployment Wizard.
  13. Select Perform a Planned Deployment and Configure SAS Software.
    Note: Make sure that Install SAS Software is deselected.
    Select Deployment Type page
  14. Specify the type of deployment plan that you are using.
    • customized deployment plan
      Choose Specify the full path to a customized deployment plan, and then click Browse to navigate to the plan file.
    • standard deployment plan
      Choose Select a standard deployment plan, and then choose the appropriate plan in the drop-down list.
      Specify Deployment Plan page
  15. If there are multiple machines in your SAS deployment, select the machine on which you are configuring.
    The deployment wizard lists the SAS products in your order that should be installed on the machine.
  16. Choose either the Typical or the Custom configuration prompting level. You want to be able to access the configuration page where you can set the SAS Metadata Server. The Express prompt level does not allow you to access this SAS server configuration setting.
    Note: When adding SAS 9.3 products that require configuring, make sure that you specify the metadata repository name if the one that you are using has a name other than the default (Foundation). To access the deployment wizard page to specify a custom repository name, choose the Custom configuration prompting level.
    Refer to Overview of Configuration Options by Prompt Level for more information about the SAS Deployment Wizard prompting levels.
  17. On the Specify Configuration Information page, specify the configuration directory and level for your current SAS deployment to which you are adding the new configuration.
  18. If you are adding the products that you are configuring to an existing SAS deployment, you are asked to confirm your selection.
    Configuration Directory confirmation dialog box
  19. In the Select Products to Configure page, choose only those products that you want to configure on the machine.
    The SAS Deployment Wizard has queried the metadata about your current configuration and checked the appropriate products to be configured.
    We recommend that you accept the product selections displayed on this page.
    Note: Any time you configure your deployment, you must also configure your Web application server, even if your configuration does not involve your SAS middle tier. If you manually configured the Web application server when you deployed SAS 9.3, then configure it again manually. If the deployment wizard automatically configured your Web application server, then choose the automatic configuration option.
    Select Products to Configure page
  20. Provide the remaining configuration information as the wizard prompts you for it. (The actual number of configuration pages that you must provide input for depends on the prompt level that you chose.) For more information, see Step 9 in the topic, “Install and Configure SAS Interactively.”
  21. When you see the Deployment Summary page, the deployment wizard has finished collecting configuration input. This is the last opportunity to go back and change any information that you have provided in previous pages before the wizard begins writing to your system.
    Make one of the following choices:
    • Select Start to begin writing the configuration to the current machine.
    • Select Back to navigate to earlier wizard pages to change configuration information previously entered.
    • Select Cancel to terminate the wizard session. Note that you will lose configuration information previously entered.
      Deployment Summary page
    When you see a page similar to the following, the SAS Deployment Wizard is finished:
    Deployment Complete page
  22. Click Next to go to the Additional Resources page.
    Additional Resources page
  23. Click Review Manual Configuration Instructions and complete any necessary manual configuration steps.
    The SAS Deployment Wizard writes the Instructions.html file to the Documents directory on the SAS configuration path. For example:
    • UNIX and z/OS:
      /opt/SAS/Lev1/Documents/Instructions.html
    • Windows:
      C:\SAS\Config\Lev1\Documents\Instructions.html
    Note: The wizard backs up your previous Instructions.html file to the Backup subdirectory under the Documents directory on the SAS configuration path (for example, C:\SAS\Config\Lev1\Documents\Backup\Instructions.html_YYYY-MM-DD-HH.MM.bak).
  24. Click Finish to close the deployment wizard.
  25. When you are configuring SAS Web applications, restart the SAS Services Application (Remote Services).
    On Windows, you must restart the SAS Services Application (Remote Services) from a Windows command line, using the RemoteServices.bat -start command. For more information, see Starting or Stopping the SAS Services Application (Remote Services) in SAS Intelligence Platform: System Administration Guide.
  26. For multi-machine deployments, back up your metadata repository and your SAS configuration directory before you run the SAS Deployment Wizard on the next machine called for by your deployment plan.
    • Make a backup copy of your SAS 9.3 configuration directories by using your site-approved method. Your SAS configuration directories are all the child directories beneath the path that you specified earlier in this procedure on the Specify Configuration Information wizard page.
    • Back up your metadata repository and repository manager on the SAS Metadata Server machine. For more information, see Best Practices for Backing Up and Restoring Your SAS Content in SAS Intelligence Platform: System Administration Guide.
  27. When you are finished completing any manual configuration tasks, and you have made the necessary backups, repeat these steps listed in this topic on each machine defined in your deployment plan.
  28. If you have installed or upgraded a SAS Web application that offers online Help, you will have to rebuild the SAS Help Viewer for Midtier Applications. For more information, see Rebuilding the SAS Web Applications in SAS Intelligence Platform: Middle-Tier Administration Guide.
  29. When you are finished installing and configuring SAS on each machine called for in your deployment plan, proceed to the section, Validate the SAS 9.3 Servers.
    Note: If you encounter error messages about your SAS license expiring, you might need to perform another procedure to correct this. For more information, see About Adding a SAS Solution to Your Deployment.

Configure Updated or Upgraded SAS Products

Follow these steps to use the SAS Deployment Manager to configure SAS products for which you have already installed updates or upgrades.
Note: Starting with the March 2012 release of SAS 9.3, the SAS deployment wizard and the download manager can be run on operating systems that do not have windowing systems. For more information, see the SAS Deployment Wizard and SAS Deployment Manager User's Guide available at: http://support.sas.com/documentation/installcenter/en/ikdeploywizug/64204/PDF/default/user.pdf
  1. Make a backup copy of your SAS 9.3 configuration directories by using your site-approved method. Your SAS configuration directories are all the child directories beneath the configuration path that was specified during the initial SAS 9.3 deployment on the Specify Configuration Information wizard page.
  2. Back up your metadata repository and repository manager on the SAS Metadata Server machine. For more information, see Best Practices for Backing Up and Restoring Your SAS Content in SAS Intelligence Platform: System Administration Guide .
  3. Make sure that your SAS server and middle tiers are running.
    For more information, see Operating Your Servers in SAS Intelligence Platform: System Administration Guide .
  4. If you are reconfiguring SAS Web Parts for Microsoft SharePoint that was deployed manually, read the following topic before proceeding: Reconfigure a Manual Deployment of SAS Web Parts for Microsoft SharePoint in SAS Intelligence Platform: Web Application Administration Guide .
  5. Log on to the machine on which you want to update the SAS product configuration as the SAS Installer user. This is the user with which your SAS deployment was installed and updated. For more information, see Required External User Accounts for SAS .
  6. On the host machine for the products whose configurations you are updating, navigate to SAS-installation-directory/SASDeploymentManager/9.3 and launch config.exe (Windows), config.sh (UNIX), or config.rexx (z/OS). On Windows, you can use the shortcut on the Start menu.
  7. In the SAS Deployment Manager, select Update Existing Configuration.
    Select SAS Deployment Manager Task page
  8. In the next page, specify the configuration directory and the level (for example, Lev1) that you want to update.
    Note: Any time that you configure your deployment, you must also configure your Web application server, even if your configuration does not involve your SAS middle tier. If you manually configured the Web application server when you deployed SAS 9.3, then configure it again manually. If the deployment wizard automatically configured your Web application server, then choose the automatic configuration option.
    Select Configuration Directory/Level page
  9. If you are running in a UNIX environment, restart the SAS Metadata Server:
    1. At a UNIX prompt, navigate to the directory where the SAS Metadata Server is configured.
    2. Enter ./MetadataServer.sh start .
  10. In the next page, enter the user ID and password for an unrestricted administrative user.
    Specify Connection Information page
  11. If you are configuring a SAS product that involves the WebSphere Web application server, you are prompted if you are using WebSphere Admin Security. Make your selection and click Next.
  12. If you are using WebSphere Admin Security, then on the Web Application Server Administrator page, enter the user ID and password for the administrator and click Next.
  13. When you see the Summary page, the deployment manager has finished collecting configuration input. This is the last opportunity to go back and change any information that you have provided in previous pages before the manager begins writing to your system.
    • Select Start to begin writing the configuration to the current machine.
    • Select Back to navigate to earlier manager pages to change configuration information previously entered.
    • Select Cancel to terminate the manager session. Note that you will lose configuration information previously entered.
      Summary page
      During the configuration process, SAS automatically restarts your SAS servers, configures your Web application servers, and rebuilds and redeploys your SAS Web applications.
      When you see a page similar to the following, the SAS Deployment Manager is finished:
      Deployment Complete page
  14. Click Next to go to the Additional Resources page.
    Additional Resources page
  15. If your configuration:
    • encountered errors
      The first link on the Additional Resources page goes to the ConfigurationErrors.html file. Click this link and follow the instructions to debug your configuration.
    • encountered no errors
      The first link on the Additional Resources page goes to the UpdateInstructions.html file. Click this link and follow the instructions to complete any manual steps necessary to complete your configuration.
      The SAS Deployment Manager writes its HTML pages to the Documents directory on the SAS configuration path. For example:
      • UNIX and z/OS:
        /opt/SAS/Lev1/Documents/UpdateInstructions.html
      • Windows:
        C:\SAS\Config\Lev1\Documents\UpdateInstructions.html
        Note: The manager backs up your previous HTML files to the Backup subdirectory under the Documents directory on the SAS configuration path (for example, C:\SAS\Config\Lev1\Documents\Backup\UpdateInstructions.html_YYYYMM-DD–HH.MM.bak).
  16. Click Finish to close the deployment manager.
    Detailed log messages are written to a file called product-name_updateConfigure_date-and-time.log, where product-name identifies the product that was configured. The deployment manager writes this file to SAS-configuration-directory\Levn\Logs\Configure.