Create a SAS Viya 3.5 Mirror Repository – Windows

SAS Mirror Manager and the Mirror Repository – Overview and Requirements for Windows

SAS Mirror Manager is a command-line utility for synchronizing a collection of SAS software repositories. Its primary use is to create and manage mirror repositories for software deployment. A mirror repository is required for all the SAS Embedded Process deployments.

Consider the requirements for your mirror repository:

• SAS Mirror Manager can be used to put the files in several locations, such as on a web server that serves the files via HTTP or on a shared NFS mount point.
• The default location for the files that SAS Mirror Manager downloads is the C:\Users\user-ID\sas_repos directory. Ensure that the default location or the location that you select has adequate space. Also ensure that the machine where the mirror repository is located has adequate space. SAS Embedded Process requires approximately 300 MB of space.

Creating a Mirror Repository for Windows

To create a mirror repository with SAS Mirror Manager:

1. The Software Order Email (SOE) indicated that you should save the SAS_Viya_deployment_data.zip file attachment. If you have not already done so, save that file now to a directory on the machine on which you plan to launch your deployment.
2. Download SAS Mirror Manager from the SAS Mirror Manager download site to the machine on which you want to put your mirror repository.

   This step requires internet connectivity. If you receive warnings or errors regarding connectivity, then work with your system administrator to correct them.

   Note: The file is saved as a ZIP file.
3. Unzip the downloaded file using your preferred method.
4. Run the following command to create a mirror repository:

   mirrormgr.exe mirror --deployment-data 
      path-to-deployment-zip-file-from-SOE <options>

   For more information about the options that are available, see Options for the mirrormgr mirror Command.

   Note: If you have an HTTPS proxy, you might also need the --cacert option, which indicates the location of the certificate the proxy will have to use. The proxy certificate will be one that your company manages.

   By default, the repositories are placed in C:\Users\user-ID\sas_repos. If you want to put them in another location, use the --path option followed by the full directory location of the mirror destination. This guide will refer to that location as \sas_repos. However, if you choose to use a different location, replace instances of \sas_repos used in this guide with the actual location that you select.

   The sas_repos directories are organized as follows:

   • The entitlements.json file contains a list of the repositories to which you are entitled.
   • The location_group_declarations.json file and the sasmd directory contain data that is used by the SAS Orchestration CLI to create the order-specific tools for your deployment.
   • Any remaining directories are the software repositories that are organized by native deployment tools:
     • The repository repos contains yum files for Linux.
     • The repository win contains MSI files for Windows.
     • The repository deb contains APT files for Debian.
     • The repository bosh contains BOSH releases for BOSH.
5. (Optional) After the initial download is complete, copy the file structure to a web server or shared NFS mount. The destination machine does not have to be connected to the internet.

Additional tips:

• You can use the mirrormgr verify command to verify the contents of a mirror repository before installation.
• For more information, you can request --help for any command. For example, you can submit mirrormgr mirror --help to read about more flags that could be useful.