Skip to content

First Time Use

Note

All references to desktop_personal below should be replaced with command specific to your system, i.e. desktop_personal_linux for Linux and desktop_personal_darwin for Mac

Below are the recommended steps for running SAS Analytics Pro for the first time.

1. Configure your desktop

Run the following command to configure the features you want to use:

desktop_personal --configure

The very first time this is run you will get the following prompt:

A Desktop called 'sas-analytics-pro' does not exist. Do you want to create one? [y/n]

Enter y to proceed.

What follows next is a series of questions about the specific features you want to use. You can simply press ENTER for each to accept the defaults (SAS Studio is enabled with no add-ons):

Do you want to enable studio? [y/n] (y):
studio_http_port (81):
Do you want to enable jupyter? [y/n] (n):
Do you want to enable cst? [y/n] (n):
Do you want to enable python? [y/n] (n):
Do you want to enable perl? [y/n] (n):
Do you want to enable sasoq? [y/n] (n):
Do you want to enable sshd? [y/n] (n):
Do you want to customise SAS Studio? [y/n] (n):
Do you want to configure custom mounts? [y/n] (n):

2. Start your desktop

To start using SAS Analytics Pro, run the following command:

desktop_personal --start

If this is the first time your are starting up your desktop then you will see something similar to the following:

                          Selerity Personal Desktop                         
┌────────────────────────┬──────────────────────────────────────────────────┐
│           Desktop Name │ sas-analytics-pro - Not Running                  │
├────────────────────────┼──────────────────────────────────────────────────┤
│      SAS Analytics Pro │ Version: Unknown ()                              │
├────────────────────────┼──────────────────────────────────────────────────┤
│  Shared Home Directory │ C:\User\selerity\personal\sas-analytics-pro\data │
└────────────────────────┴──────────────────────────────────────────────────┘
Enter the full path and filename to your license file 
(SASViyaV4_XXXXX_0_stable_2021.1.5_license_2021-09-27T045851.jwt): 
Enter the full path and filename to your certificate file 
(SASViyaV4_XXXXX_certs.zip): 
Latest image found at SAS:  0.12.28-20220315.1647335918443

If you have saved your License and Certificate files to the same directory as desktop_personal then they will both be automatically found. If not, you will be prompted to enter their location.

It may take some time for the SAS Analytics Pro image to be downloaded from SAS, but this is only done once. Subsequent starts will not need to re-download the image.

3. A Successful Start

When your desktop has successfully started you will see output including:

  • Your SAS License information
                            SAS License Information                             
┌─────────────────┬────────────────────────────────────────────────────────────┐
│           Order │ XXXXXX                                                     │
├─────────────────┼────────────────────────────────────────────────────────────┤
│            Site │ 12345678                                                   │
├─────────────────┼────────────────────────────────────────────────────────────┤
│       Site Name │ CUSTOMER NAME - ANALYTICS PRO VIYA4                        │
├─────────────────┼────────────────────────────────────────────────────────────┤
│          Expiry │ 30JUN2022                                                  │
└─────────────────┴────────────────────────────────────────────────────────────┘
  • Credentials to be used
                                  Credentials                                   
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ User                                     ┃ Password                          ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ michael                                  │ z0pENHTZUR                        │
└──────────────────────────────────────────┴───────────────────────────────────┘
  • Directories available
                                     Mounts                                     
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Local Path                                       ┃ Path within SAS Container ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ C:\User\selerity\personal\sas-analytics-pro\data │ /data                     │
│ C:\User\selerity\personal\sas-analytics-pro\sas… │ /sasinside                │
│ C:\                                              │ /mnt/c                    │
│ D:\                                              │ /mnt/d                    │
└──────────────────────────────────────────────────┴───────────────────────────┘
  • Application Links
                               Application Links                                
┏━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Application           ┃ URL                                                  ┃
┡━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ SAS Studio            │ http://localhost:81/SASStudio                        │
└───────────────────────┴──────────────────────────────────────────────────────┘

4. Start using SAS

Now you can take the SAS Studio URL provided in the Application Links, enter that into your web browser and log in using the credentials provided.

SAS Studio Login