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.
  • Creating a SAS Software Depot 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.

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 need a machine that can access the SAS download website. 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.
    • Windowing environment
      If you want to run the SAS Download Manager and the SAS Deployment Wizard using a traditional graphical user interface, then on Linux, make sure that a windowing environment such as the Common Desktop Environment or X11 is installed.
      To run the deployment wizard on operating systems that do not have windowing systems, see the SAS Deployment Wizard and SAS Deployment Manager User's Guide.
    • 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 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 do 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 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.
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 one or more deployment plans, a SAS installation data file, 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. So, there are two steps involved.
  1. Download and run the SAS Download Manager.
  2. Download a SAS order and automatically create a depot using the SAS Download Manager
Although these steps flow one after the other, at the end of each step, you can stop and resume the process later.
Follow these steps to download a SAS order and automatically create a depot using the SAS Download Manager:
  1. Locate your software order email sent by SAS. In this email, find the URL for the SAS download website from where you will download the SAS Download Manager.
    Note: It is very important that you locate your original software order email to get the correct order and SAS installation key to download the software. You cannot use the 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 email, contact your SAS Installation Representative or SAS Contracts at the following URLs:
  2. Make sure that you have met 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 more users to serve as SAS Software Depot administrators. Users needing to deploy SAS software or to apply 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 email.
  5. In 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 download the SAS Download Manager.
    Your download begins.
  7. When your browser has finished downloading the SAS Download Manager, run it. Select the language in which the SAS Download Manager displays messages and prompts.
    Choose Language dialog box
  8. At some sites, you might see a page that prompts for proxy information. If so, provide 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. Verify the list of SAS products in your order.
    We recommend that you add a description for your SAS order (for example, “TS1M3, Rev. 940_15w29”) to distinguish this 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. For more information, see Change Order Information.
  11. Select Include complete order contents if you do not want to subset your order.
    This selection causes the SAS Download Manager to include all the software in the order. For more information, see Subsetting SAS Software Orders.
    Specify Order Options page
  12. Specify a depot location and whether you want to remove duplicate files. Click Next.
    The depot location is 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 directory also contains other SAS Software Depots for the same SAS major release as this order. For more information, see Prerequisites for Creating a SAS Software Depot.
    CAUTION:
    Make sure that your SAS Software Depot directory is not nested within another depot directory (for example, C:\Depot1\Depot2).
    Launching your SAS installation from a depot that resides within another depot causes your installation to fail.
    Select Remove duplicate files and save space for the download manager to evaluate and optimize your depot after downloading your order. This optimization is being performed on the entire depot after the latest download has been added. Therefore, all software in the depot—not just the software being downloaded—is optimized.
    Note: The SAS Deployment Wizard cannot create media from a SAS Software Depot that has been optimized. However, depots that have been optimized can be copied with the SAS Software Copy Utility.
    Depots that have been optimized can be added to later, and the optimization tool can be run on depots to which orders have been added. Optimization can also be performed on depots that have been optimized in the past.
    Specify SAS Software Depot Options 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 to 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 order the information previously entered.
      Note: SAS tracks downloads and counts only a complete download toward your download limit.
    Final Review page
    Note: The Disk space required value that is displayed on the Final Review page will actually be smaller if you have selected the Remove duplicate files and save space on the earlier page, Specify SAS Software Depot Options. For more information, see Step 12.
    The SAS Download Manager begins downloading, uncompressing, and creating a SAS Software Depot for 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. Click Next to go to the final page, which describes post-download instructions.
    Download Complete page
  15. Click Finish to close the SAS Download Manager.
    Download Complete page
  16. To continue with the software installation, proceed to Installing Third-Party Software.
    After you finish your SAS 9.4 deployment, be sure to keep your SAS Software Depot, because it 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, see your operating system documentation.)
To create a SAS Software Depot by using the SAS Deployment Wizard, follow these steps:
  1. Make sure that you have met fulfilled the requirements described in Prerequisites for Creating a SAS Software Depot.
  2. 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 more users to serve as SAS Software Depot administrators. Users needing to deploy SAS software or to apply 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.
  3. Start the SAS Deployment Wizard using one of two methods:
    • If you are starting the wizard from physical 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 media’s root directory, and double-click setup.exe.
      • Linux:
        Navigate to the media's root directory, and enter ./setup.sh at a command prompt.
    • If you are starting the wizard from an existing SAS Software Depot, proceed as follows, depending on your operating system:
      Navigate to the depot’s root directory, and do one of the following:
      • Windows:
        Double-click setup.exe.
      • Linux:
        Enter ./setup.sh at a command prompt.
  4. Select the language in which the SAS Deployment Wizard displays messages and prompts.
  5. Select Create or Add to a SAS Software Depot. Do not select Install SAS software.
    Select Deployment Task page
  6. Verify the list of SAS products in your order.
    We recommend that you update the description for your SAS order to distinguish this order 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. For more information, see Change Order Information.
  7. If you have multiple orders in your depot, you must select the order for which you want to create a depot. (Creating unique order descriptions helps you select the correct order.)
  8. Select Include complete order contents if you do not want to subset your order. This selection causes 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 SAS 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 directory also contains other SAS Software Depots for the same SAS major release as this order.
    CAUTION:
    Make sure that your SAS Software Depot directory is not nested within another depot directory (for example, C:\Depot1\Depot2).
    Launching your SAS installation from a depot that resides within another depot causes your installation to fail.
    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 before 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 pages to change order information previously entered.
    • Click Cancel to terminate the SAS Deployment Wizard session. Note that you will lose the order information previously entered.
    Final Review page
  12. If you are running the SAS Deployment Wizard from physical media, the SAS Deployment Wizard prompts you for media. Continue to provide media as prompted.
    Note: If you are working on a Linux system without an automounter, mount the device. 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.
    The SAS Deployment Wizard begins creating a SAS Software Depot of your SAS order.
  13. When you see a page similar to the following with the progress indicator at 100%, the SAS Download Manager is finished. Click Next to go to the final page, which describes post-download instructions.
    Adding SAS Software Order (finished) page
  14. Click the depotsummary.html link on the page to review the SAS QuickStart Guide.
  15. Click Finish to close the SAS Deployment Wizard.
    SAS Software Order Added page
  16. If you are using physical media on a Linux system with an automounter, use the eject command to remove the media. On a Linux system without an automounter, you must unmount the drive using the umount command, and then manually open the drive. For information about the umount command to unmount a device on your system, see the SAS Deployment Wizard and SAS Deployment Manager User's Guide.
  17. To continue with the software installation, proceed to Installing Third-Party Software.
    After you finish your SAS 9.4 deployment, be sure to keep your SAS Software Depot, because it will make applying maintenance and future upgrades easier.
Last updated: August 1, 2017