Creating a SAS Software Depot

Creating SAS Software Depots

The topics contained in this section are:

Overview of Creating SAS Software Depots

There are two ways 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.

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):
  
  For more information, go to http://support.sas.com/thirdpartysupport.
- a Windowing environment:
  
  If you will be creating the depot on a UNIX or a z/OS system, make sure that a windowing environment--such as the Common Desktop Environment or X11--is installed. The program that you use to create the depot has a graphical user interface.
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. [cautionend]

Before you can create a depot by using the SAS Download Manager, you must first download and install the manager itself. The installer automatically launches the SAS Download Manager after installing it. Therefore, the following procedure actually consists of three logical sections:

downloading the SAS Download Manager
installing the SAS Download Manager
downloading a SAS order and creating a software depot using the SAS Download Manager

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:

Locate your software order e-mail 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:

http://support.sas.com/adminservices/contact.html
http://support.sas.com/adminservices/sasrep.html
http://support.sas.com/techsup/license
Ensure that you have fulfilled the necessary requirements described in Prerequisites for Creating a SAS Software Depot.
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.
Launch a Web browser and navigate to the URL specified in your software order e-mail.
At the prompt in the dialog box, select Save it to disk.
Choose a path accessible to the machine to save the download and click Save.

Your download begins.
When your browser has finished downloading the SAS Download Manager, you can install it. Perform the step appropriate for your operating system:
- Windows:
  
  In Windows Explorer, navigate to the download path and double-click the download's filename. For example, on Windows machines: esdclient.exe.
  
  Note: Windows Vista and later requires that you run the SAS Download Manager installation program using administrator privileges. Right-click esdclient.exe, select Run as administrator. A standard user account requires administrative credentials.
- UNIX and z/OS:
  
  In a console, navigate to the download path and type the download's filename. On 64-bit enabled Solaris, for example: ./Setup_Solaris_Sparc.
  
  Note: Remember to assign execute permissions before running the downloaded file. For more information, refer to your UNIX or z/OS documentation.
You should see the SAS Download Manager installer welcome page.
Choose a path where you want to install the SAS Download Manager.

Note: If you are reinstalling the download manager to a different location, you must uninstall the existing download manager. (On Windows, use Add and Remove Programs. On UNIX, use the uninstall program install-directory/_uninstESD/UninstESD, which SAS supplies.) When you are upgrading to a newer version of the download manager, you do not need to uninstall first. However, you will not be prompted for an installation location.
Review the path and disk space requirements, and make one of the following choices:
- Click Next to begin installing the SAS Download Manager in the target directory.
- Click Back to navigate to earlier pages to change installation information previously entered.
- Click Cancel to terminate the install session. Note that you will lose the information previously entered.
The installation begins.
When you see a page similar to the following, the installation is complete. Click Finish to dismiss the installation program.

The installer automatically launches the SAS Download Manager.

Note: If you want to run the download manager at a later time, you can run it using the method appropriate for your operating system:
- Windows:
  
  Start Programs SAS SAS Download Manager 1.4
- UNIX and z/OS:
  
  installation-directory/SAS/SASDownloadManager/1.4/esdclient.sh&
Run the SAS Download Manager and choose the language in which the SAS Deployment Wizard will display messages and prompts.
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.
When prompted, enter your order number and SAS installation key.
Confirm the list of SAS offerings contained in your order. If you want, you can 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.

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.
Specify a location where you want to download SAS and build the SAS Software Depot.

For more information, see Prerequisites for Creating a SAS Software Depot.
If the directory you specify does not exist, the wizard prompts you. If you want it to create the directory for you, click Yes.
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.
The SAS Download Manager begins downloading, uncompressing, and creating a depot of your SAS order.

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.
Click Finish to close the SAS Download Manager.
To continue with the software installation, proceed to Installing Third-Party Products.

After you finish your SAS 9.2 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 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:

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.
Ensure that you have fulfilled the necessary requirements described in Prerequisites for Creating a SAS Software Depot.
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.
Choose the language in which the SAS Deployment Wizard will display messages and prompts.
Select Create a New SAS Software Depot. Do not select Install SAS Software.
Confirm the list of SAS offerings contained in your order.

If you want, you can 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.

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.
If you have multiple orders in your depot, you must pick the order for which you want to create a new depot.
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.)

For more information, see Prerequisites for Creating a SAS Software Depot.
If the directory you specify does not exist, the wizard prompts you. If you want it to create the directory for you, click Yes.
The SAS Deployment Wizard has finished collecting order input. This is your last opportunity to change any information 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.
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 User's Guide, which is available on the Install Center:
http://support.sas.com/documentation/installcenter/.
(Search for SAS Deployment Wizard User's Guide.)
The SAS Deployment Wizard begins creating a depot of your SAS order.
When you see a page similar to the following with the progress indicator at 100%, the SAS Deployment Wizard is finished:
Click Next to go to the final page, which contains instructions for what to do after creation of the software depot.
Click the depotsummary.html link on the page to review the SAS QuickStart Guide.
Click Finish to close the SAS Deployment Wizard.
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 User's Guide, which is available on the Install Center:
http://support.sas.com/documentation/installcenter/.
(Search for SAS Deployment Wizard User's Guide.)
To continue with the software installation, proceed to Installing Third-Party Products.

After you finish your SAS 9.2 deployment, be sure to keep your depot, as this will make applying maintenance and future upgrades easier.

Top of Page