README SAS® Download Manager Overview This document describes installing and using the SAS Download Manager on all hosts except z/OS. The information regarding z/OS and the SAS Download Manager is available from the download site, from the z/OS line in the download table. The SAS Download Manager is a Java-based client used to access the SAS software repository in order to download selected SAS orders. It is not used to actually install your SAS software order. The JRE required by the SAS Download Manager is included with the download. The SAS Download Manager, once fully extracted, requires approximately 16 to 150 MB of space to run. Note: Using the SAS Download Manager on some distributions of 64-bit Linux may require installing a compat-libstdc++ RPM. Please refer to your Linux installation materials for details on the availablility of the compat-libstdc++ package and package management utilities for the distribution you are using. Use the installation instructions in those materials to install the compat-libstdc++ RPM. If there is no reference to the compat-libstdc++ in those materials, the compat-libstdc++ RPM is not required for the distribution you are using. Note: If you use Red Hat Enterprise Linux version 5 or later, the SAS Download Manager requires both the 32-bit and 64-bit versions of libXp.so to be installed. These libraries can be found in the libXp package. In addition, libXtst.so should also be installed. Downloading the SAS Download Manager The following table lists the supported Web browsers for the SAS download site. Be sure that you are using the supported Web browser for the host you are downloading to. -Microsoft Windows--Firefox 3.6 or later, or Internet Explorer 7 or later* -Microsoft Windows for x64--Firefox 3.6 or later, or Internet Explorer 7 or later* -AIX--Firefox 3.6 or later -HP-UX--Firefox 3.6 or later -HP-UX for the Itanium Processor Family--Firefox 3.6 or later -Linux--Firefox 3.6 or later -Linux for x64--Firefox 3.6 or later -Solaris--Firefox 3.6 or later -Solaris for x64--Firefox 3.6 or later -Macintosh--Safari 2.0.4 (419.3) or later *Machines operating on Windows 7 or Windows Server 2008 R2 and using Internet Explorer should only use Internet Explorer 8. Using the SAS Download Manager Before using the SAS Download Manager to download your full SAS software order, ensure that you have your Order Number and SAS Installation Key at hand, since the SAS Download Manager requires them. The Order Number and SAS Installation Key are included on your Software Order Email. Once you are ready, use the following process to download your SAS software order. Note: If you are installing your software on a UNIX system, make sure that a windowing environment—such as X11—is installed. The SAS Download Manager has a graphical user interface. Note: If you are running the SAS Download Manager on a computer using larger fonts or a higher DPI setting, some of the pages may be truncated in the viewable area of the application. You can improve this by enlarging the size of the application when it first opens. 1. After you have downloaded the software package, use the following methods to start the installation based on your operating system: * Windows - double-click on the downloaded file. After it has expanded, the SAS Download Manager will begin installing. The Ready to Execute page opens. Click Run to continue. The Initializing and Running page opens, showing a progress bar for launching the SAS Download Manager. When the initialization is complete, the Choose Language page opens. * UNIX - set the execute bit using the following command on the downloaded file: chmod +x Issue the following command to start the SAS Download Manager: ./ A message opens that reads “Uncompressing SAS Download Manager.” When the files are fully uncompressed, the Choose Language page opens. Note: If you are installing on HP-UX, Solaris, or Solaris for x64, do not attempt to use the ampersand parameter ("&") in order to invoke the installer in the background. * Macintosh - Double-click the SASDownloadManager file to unpack the file in its location (if you have your file extensions turned on, the file name will be SASDownloadManager.app). After the file is unpacked, the SAS Download Manager will begin installing in that location. 2. At the Choose Language page, select the language in which you would like to run the SAS Download Manager. Select OK. 3. If the SAS Download Manager is unable to automatically detect your proxy settings, you will be prompted for your proxy information. If you do not know your proxy settings, contact your system administrator to obtain your HTTP proxy server, port number, and login information. 4. The Order Information page opens. Enter the Order Number and SAS Installation Key into the appropriate fields. Select Next to continue. 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 5. The Specify Order Details page opens with the Order Number and SAS Products to Install boxes populated from the SAS database. Review the products in your order. If the product list is not what you expect, ensure that you have the correct Order Number. Select Back to enter a different Order Number. If the product list is correct, you can enter a name for the order in the Order Description box. The Order Description box will help you to differentiate between multiple orders. When you are satisfied with the contents of this page, select Next. 6. The Specify Order Options page opens. This page allows you to choose between downloading the entire order or subsetting the order by a number of parameters, including operating system, SAS Foundation products, and language. If you choose not to subset the download, select Include complete order contents. If you choose to refine the list of software you are going to download, select Subset order contents, then select at least one parameter you want to use to subset. Click Next to continue. Note: If you are downloading software older than SAS 9.3, the subsetting option will not be available and you should skip to step 8. 7. If you chose to subset your download in the previous step, then at least one of the following pages will open. If you chose more than one parameter, clicking Next will take you to the next parameter you chose. * Subset by Platform – The page displays the operating systems that any part of your software order can be installed. Select at least one operating system that you want to download software for. Click Next to continue. * Subset SAS Foundation Products – The page displays the SAS Foundation products in your software order. Select at least one SAS Foundation product to be downloaded. Note that Base SAS cannot be deselected. Click Next to continue. Note: If you started the SAS Download Manager with the –subsetclients command line, this option reads as Subset by Product. * Subset Product Languages – The page displays all the languages that any part of your software order can use. Select at least one language that you want your software to use. Note that English cannot be deselected. Click Next to continue. 8. The Specify SAS Software Depot Directory page opens. Enter the location you would like your SAS software order downloaded to in the text box. Your software order will be delivered as a SAS Software Depot. You can use the Browse button to search through your system for a place to put your software order. Once you have entered the location for your software order, click Next. Note: If you have already created a 9.3 SAS Software Depot, SAS strongly recommends using the same location for all subsequent SAS 9.3 downloads. However, you cannot add SAS 9.3 products to a depot that contains SAS 9.2 products. 9. The Final Review page opens with a pane that summarizes the decisions you have made. Review that pane, and if anything is incorrect, use Back to change your responses. When the pane correctly reflects what you want to download, click Download to start the process. As the SAS Download Manager retrieves your software order, the progress bar will show how much remains to be downloaded. Note that the SAS Download Manager retrieves a compressed file and extracts it as part of the download process. 10. When the SAS Download Manager has downloaded and extracted your SAS software order, the Download Complete page opens. Click Finish to close the application. Windows users should also close the Completed the SAS Download Manager page by clicking Finish. 11. The QuickStart Guide describes how to install the software you have retrieved. If a QuickStart Guide is available, you can find it at the following location: \SAS Software Depot\depotsummary.html, where is the directory location you download your files. Open the depotsummary.html and click the View QuickStart Guide link. If you have multiple software orders in your SAS Software Depot, be sure to consult the QuickStart Guide that is associated with the order you are working with by comparing the software order numbers. Follow the procedures described in the QuickStart Guide to install your SAS software. Command Line Option for Windows and UNIX One of the ways you can subset an order being downloaded is “by Foundation product”; that is, by SAS products usually installed on a server, such as SAS/GRAPH and SAS/STAT. The -subsetclients command line changes that dialog so that you can subset by client products that are not configurable. If you use the -subsetclients command line, the “by Foundation product” choice becomes “by product.” Also, note that if you use this command line, only non-configurable client software will be listed in this dialog. Usage -- -subsetclients Note that the command line consists of two dashes followed by -subsetclients with a space between them. Windows Example -- -subsetclients UNIX Example ./ -- -subsetclients Removing the SAS Download Manager Windows and UNIX When you are using the SAS Download Manager on Windows and UNIX, it is not actually installed, but is running from a temp directory. When the SAS Download Manager is closed, that temp directory is cleaned up and no files remain on your machine except the original downloaded executable. To completely remove the SAS Download Manager, delete that executable. Macintosh Use the following steps to uninstall the SAS Download Manager from a Macintosh machine: 1. From a terminal window, navigate to the Desktop directory and use rm –rf to remove the .SASAppData directory. 2. Drag the desktop icons to the desktop trash can. 3. To remove the depot, either drag and drop it into the desktop trash can via the windowing environment File Chooser or use rm –rf via your X11 session. SAS and all other SAS Institute product or service names are registered trademarks or trademarks of SAS Institute Inc. in the USA and other countries. Other brand and product names are registered trademarks or trademarks of their respective companies. ® indicates USA registration. Copyright (c) 2012 SAS Institute Inc. Cary, NC, USA. All rights reserved. 2 March 2012