SAS Documentation Feedback

SAS Documentation is a wonderful resource. I have spent lots of time reading and searching through it, learning new things, refreshing existing knowledge, or trying to work out why something I am doing is not working. Very rarely you might encounter an error, as I did yesterday whilst reading about the changes in the recent SAS 9.4 M8 release. SAS have made it very easy to provide feedback when you encounter such things – up in the top right hand side of the page there’s a Feedback link, as highlight in the screenshot below:

Feedback button on the SAS Documentation site

Clicking on that link will open your email client and pre-populate a ready made email with the title of that page in the subject line and a link to the page in the body. All you need to do is provide your comments and hit send.

I was very impressed with the response to the feedback I provided yesterday. Reading my email this morning I already had replies and the documentation had already been updated too. How fast was that!

SAS 9.4 M8 … Some Surprises

SAS/IntrNet Hat Something I, and others, have been looking forward to for a while has been the release of SAS® 9.4 M8, and so I was excited to see Margaret Crevar’s SAS Communities post about it: SAS 9.4 M8 is now available!!. Chris Hemedinger also posted about it on the SAS Users blog: SAS 9.4 Maintenance 8 is available. I was keen to get stuck into the detail in the documentation: What’s New in SAS 9.4 Guide to Software Updates, January 2023 (SAS 9.4, Rev. 940_23w05), SAS 9.4M8 Is Released.

M8 is the latest maintenance release of SAS 9.4 and I have heard several times how it will help alleviate some of the uncertainty around the future of the SAS 9.4 platform by extending Standard Support for SAS 9.4 for another 5 years (until 2028) and, as Chris mentioned in his post, “… demonstrate the commitment of SAS to support users of the SAS 9.4 platform for many years to come.”

I find the fastest way to review the M8 changes is to search for “M8” in the large PDF documents rather than reading through each individual web page:

In my reading, Continue reading “SAS 9.4 M8 … Some Surprises”

Finding the SAS Viya 4 Consul Token

When you are working with the SAS® Viya® REST APIs you need to do a one-off registration process for your client using the Consul Token.

The SAS documentation for SAS REST APIs: Authentication & Authorization: Registering clients explains how to get access to the Consul client.token by looking in the file system at /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default/client.token

Now, SAS Viya 4 is based on Kubernetes and has lots of pods each with their own file system, so I was wondering where I’d locate this file. I started looking in the sas-login-app pod but didn’t find it there. Next stop was one of the sas-consul-server pods and that was where I found it (makes sense really, I should have started there!).

Now I know where to find it, in future I will use the following kubectl command to quickly print out the Consul client.token when I need it:

kubectl exec -q -n sasviyadev sas-consul-server-0 -c sas-consul-server -- cat /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default/client.token

… replacing sasviyadev with the name of the namespace in which SAS Viya 4 has been deployed.

After discovering the consul token using the method above I subsequently found a documented method in the SAS Viya Administration: Authentication: Additional Authentication Topics: Register a New Client ID

kubectl -n sasviyadev get secret sas-consul-client -o go-template='{{(index .data "CONSUL_HTTP_TOKEN")}}'| base64 -d

… so now I know two ways!

If you have any other helpful tips for locating the SAS Viya 4 Consul token please leave a comment below.