Creating SAS Software Depots

Overview of Creating SAS Software Depots

There are two ways that you can create a SAS Software Depot:
  • Download SAS software.
    When you download a SAS order, the SAS Download Manager automatically creates a SAS Software Depot on your system.
  • Run the SAS Deployment Wizard.
    Creating SAS Software Depots is an option on one of the wizard pages.
Before creating a depot, make sure that you have met the necessary requirements described in the following section.
The topics contained in this section are:

Prerequisites for Creating a SAS Software Depot

Before you start creating a SAS Software Depot, make sure that you have met the following prerequisites:
  • Choose a machine that has the following:
    • Internet access:
      If you are downloading your SAS order, you will need a machine that can access the SAS download Web site. Also, ideally this machine should be networked so that you can perform deployments directly from the machine, without having to physically relocate the depot to another machine.
    • Java SDK for z/OS installed (z/OS only):
    • a Windowing environment:
      If you want to run the download manager and the deployment wizard using a traditional graphical user interface, then on a UNIX or a z/OS system, make sure that a windowing environment such as the Common Desktop Environment or X11 is installed.
      Starting with the March 2012 release of SAS 9.3, the 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.
      Note: You have the option of creating a SAS Software Depot on a UNIX or Windows machine and transferring the depot to a z/OS environment using the SAS Software Depot Copy Utility. For more information, see SAS Deployment Wizard and SAS Deployment Manager 9.3: User’s Guide available at: http://support.sas.com/documentation/installcenter/en/ikdeploywizug/64204/PDF/default/user.pdf.
    • certain Linux packages and libraries
      • The SAS Download Manager on some 64-bit distributions of Linux might require the compat-libstdc++ RPM.
      • The SAS Download Manager on Red Hat Enterprise Linux version 5 or later requires both the 32-bit and 64-bit versions of the library, libXp.so, to be installed.
      For more information, see the SAS Download Manager README file.
  • Designate a target directory.
    Decide where you will create the SAS Software Depot. It is helpful if this directory can be shared on a network and accessible to all of the machines on which you will be installing software from the depot.
    Note: SAS recommends that you not copy a depot from one location to another. Choose a permanent location before you create the depot.
  • Grant required access permissions.
    The SAS installer user must have Write access on the depot target directory.
    Windows Vista and later requires that you run the SAS Download Manager installation program using administrator privileges.
  • Check disk space requirements.
    Make sure you have enough free disk space available on the target directory.
Finally, just before creating a depot, the SAS Deployment Wizard and the SAS Download Manager both present you with an estimate for required disk space.

Create a Depot By Using the SAS Download Manager

A SAS Software Depot contains SAS order data, an initial SAS installation data file, one or more deployment plan files, order data, and product data. The depot also contains the SAS Deployment Wizard executable—the tool required to install and initially configure SAS.
Note: There is no expiration date for downloading your SAS order. However, if the time period for your initial SAS installation data file has expired, you will have to obtain a current SAS installation data file before you can run the SAS Deployment Wizard.
Before you can create a depot by using the SAS Download Manager, you must first download it. Therefore, the following procedure actually consists of two logical sections:
  1. downloading and running the SAS Download Manager
  2. downloading a SAS order and creating a software depot using the SAS Download Manager
For z/OS, see Installation Instructions for SAS 9.3 Electronic Software Delivery for Planning Installations on z/OS.
Although these sections flow one after the other, at the end of each section, you can stop and resume the process later.
Follow these steps to download a SAS software order and automatically create a depot by using the SAS Download Manager:
  1. Locate your software order e-mail (SOE) sent by SAS. In this e-mail, find the URL for the SAS Web site from where you will download the SAS Download Manager.
    Note: It is very important that you locate your original software order e-mail for the correct order and SAS installation key to download the software. You cannot use a renewal order number. The renewal order is a license update and it cannot be used to download software. If you cannot locate your original software order e-mail, contact your SAS Installation Representative or SAS Contracts at the following URLs:
  2. Ensure that you have fulfilled the necessary requirements described in Prerequisites for Creating a SAS Software Depot.
  3. Log on to the machine as a SAS Software Depot administrator or a user with depot Read, Write, and Execute privileges.
    Note: Consider designating one or a few users to serve as SAS Software Depot administrators. Persons needing to deploy SAS software or to apply future SAS software maintenance require depot Read and Execute privileges. Depot administration tasks such as initially creating the depot, storing SAS installation data files, and updating order details require depot Write privileges. Windows Vista and later requires that you run the SAS Download Manager installation program using administrator privileges.
  4. Launch a Web browser and navigate to the URL specified in your software order e-mail.
  5. At the prompt in the dialog box, select the option that enables you to save the file to disk.
  6. Choose a path accessible to the machine to save the download and save the file.
    Your download begins.
  7. When your browser has finished downloading the SAS Download Manager, run it and choose the language in which the SAS Deployment Wizard will display messages and prompts.
    Choose Language dialog box
  8. At some sites, you might see the page that prompts for proxy information. If so, supply the necessary proxy server settings for the SAS Download Manager to access the Internet. If needed, contact your site's system administrator for help with these settings.
  9. When prompted, enter your order number and SAS installation key.
    Order Information page
  10. Confirm the list of SAS offerings contained in your order. We recommend that you add a product description from your SOE (for example, “TS1M0, Rev. 930_11w29”) to distinguish it from other SAS orders. The SAS Deployment Wizard will display this order information during the SAS installation.
    Specify Order Details page
    Note: At any time after the download, you can run the SAS Deployment Wizard to add or modify SAS order information details. For more information, see Change Order Details.
  11. Select Include complete order contents if you do not want to subset your order. This selection will cause the SAS Deployment Wizard to include all the software in the order. For more information, see Subsetting SAS Software Orders.
    Specify Order Options page
  12. Specify a location where you want to download SAS and build the SAS Software Depot.
    We recommend that this directory be empty of any content. The exception is if this location also contains other SAS Software Depots for the same SAS major release as the order.
    Specify SAS Software Depot Directory page
  13. If the directory that you specify does not exist, the wizard prompts you. If you want it to create the directory for you, click Yes.
    Select an option alert box
  14. The SAS Download Manager has finished collecting order input. This is your last opportunity to change any information before downloading the SAS order and writing files to the target directory.
    Make one of the following choices:
    • Click Download to begin downloading the SAS order and writing files in the target directory.
    • Click Back to navigate to earlier pages to change order information previously entered.
    • Click Cancel to terminate the SAS Download Manager session. Note that you will lose the information previously entered.
      Note: SAS tracks downloads and counts only a complete download toward your download limit.
    Final Review page
    The SAS Download Manager begins downloading, uncompressing, and creating a depot of your SAS order.
    Download in Progress page
    When you see a page similar to the following with the progress indicator at 100%, the SAS Download Manager is finished:
    Download Complete page
  15. Click Next to go to the final page, which describes post-download instructions.
    Download Complete page
  16. Click Finish to close the SAS Download Manager.
  17. To continue with the software installation, proceed to Installing Third-Party Products.
    After you finish your SAS 9.3 deployment, be sure to keep your depot, as this will make applying maintenance and future upgrades easier.

Create a Depot By Using the SAS Deployment Wizard

You can use the SAS Deployment Wizard to create a copy (or subset) of your SAS Software Depot in another directory. If the new depot location is a remote directory on another machine, the directory must be on a shared network drive accessible from the machine running the wizard.
To create a depot on a machine that does not have shared network storage, you must use another mechanism such as SFTP or SCP to copy the depot. (For more information about these programs, refer to your operating system documentation.)
To create a SAS Software Depot by using the SAS Deployment Wizard, follow these steps:
  1. Log on to the machine that will contain the depot as a SAS Software Depot administrator or a user with depot Read, Write, and Execute privileges.
    Note: Consider designating one or a few users to serve as SAS Software Depot administrators. Persons needing to deploy SAS software or to apply future SAS software maintenance require depot Read and Execute privileges. Depot administration tasks such as initially creating the depot, storing SAS installation data files, and updating order details require depot Write privileges.
  2. Ensure that you have fulfilled the necessary requirements described in Prerequisites for Creating a SAS Software Depot.
  3. Start the SAS Deployment Wizard, using one of two methods:
    • If you are starting the wizard from removable media, proceed as follows, depending on your operating system:
      • Windows:
        The setup.exe program starts automatically when the media is inserted into the drive.
        Note: If the SAS Deployment Wizard does not start automatically, open Windows Explorer, navigate to the root of the DVD, and double-click setup.exe.
      • UNIX:
        Navigate to the media's root directory, and type ./setup.sh at a command prompt.
      • z/OS:
        Navigate to the media's root directory, and type ./setup.rexx at a command prompt.
    • If you are starting the wizard from an existing SAS Software Depot, proceed as follows:
      Navigate to the depot's root directory and do one of the following, depending on your operating system:
      • Windows:
        Double-click setup.exe.
      • UNIX:
        Type ./setup.sh at a command prompt.
      • z/OS:
        Type ./setup.rexx at a command prompt.
  4. Choose the language in which the SAS Deployment Wizard will display messages and prompts.
  5. Select Create or Add to a New SAS Software Depot. Do not Install SAS Software.
    Select Deployment Task page
  6. Confirm the list of SAS offerings contained in your order.
    We recommend that you update the description for your order and include any notes to distinguish it from other SAS orders. The SAS Deployment Wizard will display this order information during the SAS installation.
    Specify Order Details page
    Note: At any time after the download, you can rerun the SAS Deployment Wizard to add or modify SAS order information details. For more information, see Change Order Details.
  7. If you have multiple orders in your depot, you must pick the order for which you want to create a new depot. (Creating unique order descriptions helps you to choose the correct order with which to create a new depot.)
  8. Select Include complete order contents if you do not want to subset your order. This selection will cause the SAS Deployment Wizard to include all the software in the order. For more information, see Subsetting SAS Software Orders.
    Specify Order Options page
  9. Specify a location where you want to download SAS and build the software depot. (This location can be shared storage that physically resides on another machine.)
    We recommend that this directory be empty of any content. The exception is if this location also contains other SAS Software Depots for the same SAS major release as the order.
    Specify SAS Software Depot Directory page
  10. If the directory that you specify does not exist, the wizard prompts you. If you want it to create the directory for you, click Yes.
    Select an option alert box
  11. The SAS Deployment Wizard has finished collecting order input. This is your last opportunity to change any information that you have provided before the wizard begins writing files to the target directory.
    Make one of the following choices:
    • Click Start to begin creating the depot in the target directory.
    • Click Back to navigate to earlier wizard pages to change order information previously entered.
    • Click Cancel to terminate the wizard session. Note that you will lose order information previously entered.
    Final Review page
  12. If you are running the SAS Deployment Wizard from removable media, the SAS Deployment Wizard prompts you for a DVD. Continue to supply discs as prompted.
    Note: If you are working on a UNIX system without an automounter, mount the DVD drive. For information about the privileges required to mount a device and the syntax of the mount command for your system, 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.
    The SAS Deployment Wizard begins creating a depot of your SAS order.
    Adding SAS Software Order page
  13. When you see a page similar to the following with the progress indicator at 100%, the SAS Deployment Wizard is finished:
    Adding SAS Software Order (finished) page
  14. Click Next to go to the final page, which contains instructions for what to do after creation of the software depot.
  15. Click the depotsummary.html link on the page to review the SAS QuickStart Guide.
    SAS Software Order Added page
  16. Click Finish to close the SAS Deployment Wizard.
  17. If you are using removable media on a UNIX system where an automounter is being used, use the eject command to remove the DVD. On a UNIX system without an automounter, you must unmount the drive by using the umount command and then manually opening the drive. For information about the umount command that is needed to unmount a device on your system, 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.
  18. To continue with the software installation, proceed to Installing Third-Party Products.
    After you finish your SAS 9.3 deployment, be sure to keep your depot, as this will make applying maintenance and future upgrades easier.