Question about the SAS Mirror Manager behavior

[EyalGonen]

Hi experts,

I am using SAS Mirror Manager and I am noticing something odd. I am using the "--deployment-assets" parameter to point to the deployment assets file downloaded from my.sas.com but it seems like SAS Mirror Manager is always downloading the latest release and not the release found in the deployment assets file.

According to the doc I expected it to download the same cadence and release found in the deployment assets file and not the latest release. I verified the downloaded release in the downloaded path:

../sas_repos/rel/stable/2024.04

I see there:

relFormatVersion":"0.0.1","name":"stable","version":"2024.04","latest":{"duList":"lod/stable/2024.04/20240511.1715441583768

But my deployment assets file name has a different release:

stable_2024.04_20240423.1713898974806

The command I am using is:

$MIRRORMGRPATH/mirrormgr mirror registry --path ${MIRRORPATH} --deployment-data ${ASSETSPATH}/${CERTSFILE} --deployment-assets ${ASSETSPATH}/${ASSETSFILE}

What am I missing here? Maybe I am looking in the wrong place.. where can I see/verify which release was downloaded by mirror manager?

[gwootton · Accepted solution]

Mirror Manager has a --release option you can use to specify the release to download. If this is not specified it will pull the most recent release.
The command I use is:

cadencerelease=$(grep -E 'Cadence.Release' sas-bases/checksums.txt | awk '{print $NF}')
...
mirrormgr mirror registry --destination "$mirror" --deployment-data "SASViyaV4_${order}_certs.zip" --username "$mirroruser" --password "$mirrorpass" --cadence "${cadence}-${version}" --release "${cadencerelease}" --workers 10

[EyalGonen]

Hi @gwootton 

According to the doc at https://go.documentation.sas.com/doc/en/itopscdc/v_051/dplyml0phy0dkr/n1h0rgtr10fpnfn1mg0s8fgfuof8.h...  it says:

 you can use the -–deployment-assets flag to pass in the cadence and release automatically.

So according to this if I specify --deployment-assets (as I did) it should pick up the cadence and  the release automatically from the file pointed by this parameter.

So maybe I am looking at the wrong place to verify which release it actually downloaded. Can you please help telling me how to identify which exact release was downloaded with mirror manager?

[gwootton]

Sorry, you are correct that --deployment-assets should do the same thing. Also it seems the default behavior has changed so when no release is supplied it downloads all of them.
When I look at my sas-bases/lod/stable/2024.04/ contents the release there matches the release I specified in the release options, so it sounds like mirrormgr is not working as expected.
What version of mirror manager are you using? (mirrormgr --version)
Did you download it recently?

[EyalGonen]

Hi @gwootton 

My mirror manager version version is

mirrormgr:
version : v0.36.1
build date : 2023-12-08
git hash : a02be0f
go version : go1.21.4 X:boringcrypto
go compiler : gc
platform : linux/amd64

So what you are saying is that to verify which release was actually downloaded I need to look at "sas-repo/lod/stable/2024.04/ "? I should see there a folder with the release that was downloaded? This is the way to verify what was downloaded?

[gwootton]

@EyalGonen yes, the directories in that path would be for the various releases that have been downloaded. From the file you mentioned initially, it seems to have the release within an JSON object called "latest", so it may be that this was not what was downloaded and just the details on that cadence and version.

[EyalGonen]

Hi @gwootton 

Initially I did not know where to look to understand what was actually downloaded so I looked in the wrong place. Now in the folder you mentioned I have two files: one with the correct version (same as deployment assets) and another which is with a bit newer version:

-rw-r--r--. 1 ec2-user ec2-user 6302589 May 13 14:51 20240423.1713898974806
-rw-r--r--. 1 ec2-user ec2-user 6303778 May 11 16:19 20240511.1715441583768

I am not sure what I did anymore 🙂

I think I will delete and re-download and see what happens. I will update. Thanks a lot!

[EyalGonen]

So I think I messed things up 🙂

I just checked and if I use the --deployment-assets flag then mirror manager automatically selects and downloads the cadence and release specified in the deployment assets file. 

I am not sure how I ended up with two downloaded releases before...

Thanks @gwootton  for your help!

[EyalGonen]

Hi @gwootton 

One more general question about this subject: can I use mirror manager to download new releases of the same cadence version to the same download location I used to download earlier releases? 

Same question this time about downloading difference version of the same cadence to the same folder (for example, stable 2024.04 and stable 2024.05).

Same question about different cadences (for example stable 2024.04 and lts 2023.10)

Thanks,

Eyal

[gwootton]

@EyalGonen yes, you can use the same location, what you end up with is in the repo path under docker/v2/viya-4-x64_oci_linux_2-docker paths for each image and version associated with each release downloaded.