SAS Download Manager in Console Mode

SAS® 9.4 M3 is now available (as discussed by Andy Ratcliffe in his recent NOTE: blog post), so I’m downloading a new SAS depot using the SAS Download Manager. I’m downloading it onto a Linux server that happens to have X11 available, but I’m choosing to use console (text) mode, rather than the default X11 windowed mode.

Using SAS Download Manager in console mode is my preferred method because I find it more flexible. Why Console mode? I know from experience that a SAS depot download is going to take a few hours and, if I run SAS Download Manager in windowed mode, I risk losing the remote X connection if there are any network disruptions between me and the server. By running SAS Download Manager in console mode, in combination with screen over an SSH session, I can easily disconnect/reconnect as required. I can disconnect (Control-A D) when I leave the office to go home, and reconnect (screen -r) when I get home to check on progress. I can also get screen to capture a log of the session in a text file (screen -L).

Of course, I could have used a Windows or Mac version of the SAS Download Manager to download onto a laptop and then upload onto the server, but that ties the laptop to a single location for the duration of the download. Plus if I’m not near the server at the time, I’d have to download and then upload nearly 50GB of SAS depot. If I’m traveling with my 4G mobile broadband connection, the server also has a much faster and much cheaper internet connection than I do! These are some of the reasons I prefer console mode.

To run SAS Download Manager in console mode just add -- -console on to the end of the command (that’s 2 dashes, a space, and a dash-console).

Here’s a suitably edited version of the session log so you can see how it works:

user@client:~$ ssh user@server
user@server:~$ screen -L
user@server:~$ /sasdepots/downloadmanager1.64/esdclient__94330__lax__xx__web__1 -- -console
Verifying archive integrity... All good.
Uncompressing SAS Download Manager.............

Select a language in which to view the SAS Download Manager.

( ) 1 - German
(*) 2 - English
( ) 3 - Spanish (Castilian)
( ) 4 - French
( ) 5 - Italian
( ) 6 - Japanese
( ) 7 - Korean
( ) 8 - Chinese Traditional
( ) 9 - Chinese Simplified

The * character indicates the current selection.
You can change the selection by specifying a number below.
Enter  to quit.
Note that these commands include the letter and the angle brackets.
Press Enter to accept the current selection and continue.
Selection: [ENTER]

Starting the SAS Download Manager..

--------------------------------------------------------------------------------

Order Information
Specify your order information.

Enter <h> for help or <q> to quit.
Note that these commands include the letter and the angle brackets.
Press Enter to accept the default or supply alternate text and press Enter.
Default: 9ZZZZY
Order Number: 9ZZZZZ          [NOTE: these are not real order numbers]

Enter <h> for help or <q> to quit.
Note that these commands include the letter and the angle brackets.
Press Enter to accept the default or supply alternate text and press Enter.
Default: 999Z-Z9ZZ-ZZ98
SAS Installation Key (xxxx-xxxx-xxxx): 999Z-Z9ZZ-ZZ99          [NOTE: these are not real keys]
Downloading and Processing Order Information...

..

--------------------------------------------------------------------------------

Specify Order Details
Edit the description and add notes for this order to aid with future tracking.

Enter <b> to go back to the previous prompt, <h> for help, or <q> to quit.
Note that these commands include the letter and the angle brackets.
Press Enter to accept the default or supply alternate text and press Enter.
Default: EXAMPLE - V9.4
Description: SAS 9.4 M3 Linux Server x64

--------------------------------------------------------------------------------

Specify Order Options
Specify the contents of the order

(*) 1 - Include complete order contents
        Include all the products that come with this order. This is the
        suggested option.

( ) 2 - Subset order contents
        Include only selected products based on any combination of selected
        platforms/operating systems, products, and languages.

The * character indicates the current selection.
You can change the selection by specifying a number below.
Enter <b> to go back to the previous prompt, <h> for help, or <q> to quit.
Note that these commands include the letter and the angle brackets.
Press Enter to accept the current selection and continue.
Selection: [ENTER]

--------------------------------------------------------------------------------

Specify SAS Software Depot Options
The software you are downloading will be added to an existing SAS Software Depot
or used to create a new one. Use this page to specify details about how you want
the SAS Download Manager to handle your depot.

Enter <b> to go back to the previous prompt, <h> for help, or <q> to quit.
Note that these commands include the letter and the angle brackets.
Press Enter to accept the default or supply alternate text and press Enter.
Default: /sasdepots/sas94ts1m2-rev940-15w20
SAS Software Depot Directory: /sasdepots/sas94ts1m3-rev940-15w29

The directory contains existing files.  If you create a SAS Software Depot in this
location, existing files may be replaced during the process.

Would you like to proceed anyway?
Default: y
Yes(y) or No(n): [ENTER]

--------------------------------------------------------------------------------

Final Review
Confirm the following information.

You are creating a new SAS Software Depot.

SAS Software Depot location:           /sasdepots/sas94ts1m3-rev940-15w29
Order number:                          9ZZZZZ
Order description:                     SAS 9.4 M3 Linux Server x64
Disk space available (GBs):            592.8
Disk space required (GBs):             41.3
Number of files to be downloaded:      1025
Number of hot fixes to be downloaded:  3

Enter <b> to go back to the previous prompt, <h> for help, or <q> to quit.
Note that these commands include the letter and the angle brackets.
Press Enter to continue: [ENTER]

--------------------------------------------------------------------------------

Download in Progress
Software download in progress.
Press the Enter key to bring up a menu of options during download.
Downloaded: 0.0 of 41,241.9 MB, Rate: 0.2 KB/sec
Extracted: 0.0 of 42,309.4 MB, Rate: 0.0 KB/sec
Downloaded: 0.0 of 41,241.9 MB, Rate: 0.8 KB/sec
Extracted: 0.0 of 42,309.4 MB, Rate: 0.0 KB/sec
Downloaded: 0.0 of 41,241.9 MB, Rate: 1.5 KB/sec
Extracted: 0.0 of 42,309.4 MB, Rate: 0.0 KB/sec
Downloaded: 0.0 of 41,241.9 MB, Rate: 1.8 KB/sec
Extracted: 0.0 of 42,309.4 MB, Rate: 0.0 KB/sec
Progress: <0%-------------------------------------------------->

........

Progress: <----------------------------56%---------------------->
Estimated time remaining: 3 hours, 19 minutes, 12 seconds
Downloaded: 23,262.6 of 41,241.9 MB, Rate: 1.9 MB/sec
Extracted: 23,737.8 of 42,309.4 MB, Rate: 0.0 KB/sec
Downloaded: 23,270.4 of 41,241.9 MB, Rate: 1.8 MB/sec
Extracted: 23,737.8 of 42,309.4 MB, Rate: 0.0 KB/sec
Downloaded: 23,279.3 of 41,241.9 MB, Rate: 1.8 MB/sec
Extracted: 23,737.8 of 42,309.4 MB, Rate: 0.0 KB/sec
Downloaded: 23,287.2 of 41,241.9 MB, Rate: 1.8 MB/sec
Extracted: 23,737.8 of 42,309.4 MB, Rate: 0.0 KB/sec

........

Software download is complete.
Press Enter to continue: [ENTER]


--------------------------------------------------------------------------------

Download Complete
Software download is complete.

You have successfully added order 9ZZZZZ (SAS 9.4 M3 Linux Server x64) to your
SAS Software Depot, from which you should run the SAS Deployment Wizard to
deploy your software.

The following index page provides summary and QuickStart information for all the SAS
Software Orders in the SAS Software Depot:
/sasdepots/sas94ts1m3-rev940-15w29/depotsummary.html

To launch the SAS Deployment Wizard from your SAS Software Depot, go to the location
listed below and use one of the following commands based on the operating system
you are currently running.

SAS Software Depot Location: /sasdepots/sas94ts1m3-rev940-15w29

 Windows:setup.exe    UNIX:setup.sh    z/OS:setup.rexx
The process of downloading your software from SAS should not be used as a mechanism
for distributing your software across your organization. Instead, users should
install from the SAS Software Depot in accordance with your licensed number of
users or copies.

Press Enter to finish: [ENTER]

You can find out more about running SAS Download Manager in console mode from the SAS Download Manager documentation, available for download from the same location you download SAS Download Manager itself.

7 thoughts on “SAS Download Manager in Console Mode”

  1. Hi Paul, very useful indeed. Thank You.

    I also adopted the same principle for the installation. I did first just the installation of the binaries, after that I launched the SAS Deployment Wizard in record mode for the configuration

    /SASDepot/SAS9.4_TS1M3_Rev_940_15w38/setup.sh -record -responsefile /sas/response_file_config.properties

    After that I launch

    screen -L

    and then

    /SASDepot/SAS9.4_TS1M3_Rev_940_15w38/setup.sh -console -deploy -partialprompt -responsefile /sas/response_file_config.properties

    This launches the configuration process in headless mode using the response file created previously. SAS Deployment Wizard also has a quiet mode, but that does not give any feedback to the user, so I prefer to use -console which prompts you in case of errors and allows you to fix (see http server on port 80, or setuid.sh). Configurations usually takes a while, with this method you can leave it and not depend on an X11 session

    Hope this is useful.

    Regards

  2. Hi all,

    Thanks for very usefull material. But I have a problem during downloading the SAS software. Namely after I put the order number and SAS installation key I got the error message:

    Exception in thread “main” java.awt.HeadlessException
    at java.awt.GraphicsEnvironment.checkHeadless(Unknown Source)
    at java.awt.Window.(Unknown Source)
    at java.awt.Frame.(Unknown Source)
    at java.awt.Frame.(Unknown Source)
    at javax.swing.SwingUtilities$SharedOwnerFrame.(Unknown Source)
    at javax.swing.SwingUtilities.getSharedOwnerFrame(Unknown Source)
    at javax.swing.JOptionPane.getRootFrame(Unknown Source)
    at javax.swing.JOptionPane.showOptionDialog(Unknown Source)
    at com.sas.ssn.EsdControl$ShowDLMOutOfDateMsg.showMsg(EsdControl.java:2345)
    at com.sas.ssn.EsdControl.checkProtocolVersion(EsdControl.java:1992)
    at com.sas.ssn.EsdControl.downloadControl(EsdControl.java:477)
    at com.sas.ssn.EsdControl.(EsdControl.java:179)
    at com.sas.ssn.PanelOrderInfo.validateData(PanelOrderInfo.java:178)
    at com.sas.ssn.Wizard.driveConsoleDialog(Wizard.java:400)
    at com.sas.ssn.Wizard.consoleDialogs(Wizard.java:345)
    at com.sas.ssn.Wizard.show(Wizard.java:274)
    at com.sas.ssn.Kit.showWizard(Kit.java:1117)
    at com.sas.ssn.Kit.(Kit.java:705)
    at com.sas.ssn.Kit.main(Kit.java:1678)

    Could you help me with it?

  3. Hi Tomasz,

    I haven’t seen that particular message myself but, given the stacktrace (ShowDLMOutOfDateMsg), I would guess that you might be using an old version of the SAS Download Manager and need to get the latest version from http://support.sas.com/downloads/browse.htm?cat=49

    If you are already using the latest version of the SAS Download Manager I would suggest you contact SAS Technical Support for further help.

    Cheers
    Paul

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.