SAS Cloud Analytic Services: How To (CAS Server Monitor)

• View CAS Server Properties and System Information
• View CAS Server Configuration
• View CAS Start-up Options and Environment Variables
• View CAS User Session Information
• Cancel Session
• Terminate Session
• View and Manage CAS Nodes
• Adjust Caslib Management Privileges
• Stop a CAS Server
• Remove CAS Worker Software

View CAS Server Properties and System Information

1. Sign in to CAS Server Monitor with a valid user ID and password.
2. In CAS Server Monitor, beneath the Cloud Analytic Services banner, click .
3. On the System State page, make sure that Controller is selected.
   IMPORTANT After a CAS license is renewed, the License File field is not updated until the CAS server is restarted.

View CAS Server Configuration

To use CAS Server Monitor to view the current list of CAS Server options and their values, follow these steps:

1. Sign in to CAS Server Monitor with a valid user ID and password.
2. In CAS Server Monitor, beneath the Cloud Analytic Services banner, click .
3. On the Configuration page, make sure that CAS Configuration is selected.

View CAS Start-up Options and Environment Variables

You can use CAS Server Monitor to view the option used when a CAS server was started and to see the current list of CAS environment variables and their values.

To view CAS start-up options and environment variable values, follow these steps:

1. Sign in to CAS Server Monitor with a valid user ID and password.
2. In CAS Server Monitor, beneath the Cloud Analytic Services banner, click .
3. On the System State page, select Runtime Environment.

View CAS User Session Information

You can use CAS Server Monitor to view information about a user’s session, such as connection port, length of connection time, and so on.

To view user session information, follow these steps:

1. Sign in to CAS Server Monitor with a valid user ID and password.
2. In CAS Server Monitor, beneath the Cloud Analytic Services banner, click .
3. On the System State page, select User Sessions.

Cancel a CAS User Session

To cancel a CAS server session, follow these steps:

1. Sign in to CAS Server Monitor with a valid user ID and password.
   Note: If you are canceling another user’s session, you must sign in to CAS Server Monitor with a user ID that has CAS Administrator privileges.
2. In CAS Server Monitor, beneath the Cloud Analytic Services banner, click .
3. On the System State page, select User Sessions.
4. At the end of the row for the session that you want to cancel, click and select Cancel Session.
   TipYou can also use to launch the Resource Monitor, cancel the CAS action, and terminate the session.

Terminate a CAS User Session

To terminate your CAS server session, follow these steps:

1. Sign in to CAS Server Monitor with a valid user ID and password.
2. In CAS Server Monitor, beneath the Cloud Analytic Services banner, click .
3. On the System State page, select User Sessions.
4. At the end of the row for the session that you want to terminate, click and select Terminate Session.

   When Terminate Session is selected, all the session processes are killed.

   TipYou can also use to launch the Resource Monitor, cancel the CAS action, and terminate the session.

View and Manage CAS Nodes

You can use CAS Server Monitor to view, add, and remove CAS nodes in your analytics cluster.

To view or manage a node, follow these steps:

1. Sign in to CAS Server Monitor with a user ID that has CAS Administrator privileges.
   Note: If you want only to view CAS server nodes, CAS Administrator privileges are not required.
2. In CAS Server Monitor, beneath the Cloud Analytic Services banner, click .
3. On the System State page, select Nodes.
4. From the Nodes table, you can:
   • View information about all the nodes in your analytics cluster.
   • Add nodes to your analytics cluster:
     Note: Before you can add new nodes to your cluster, you must have already added the CAS worker node software to the machine. For more information, see Convert SMP CAS Server to MPP CAS Server .
     • Click Add Nodes.
     • On the Add Nodes window, in Hostname, enter a simple host name, such as mygrid011, and click OK. The server monitor runs the CAS addNode action, which starts (or restarts) the node and joins it to the cluster.

       Separate multiple host names with a comma.

       If your hosts are named in numeric order (for example, host002, host003, ...) you can enter a range of host names. Use the form, host[start-number–end-number] (for example, mygrid[002–030]).

   • Drop worker nodes from your analytics cluster:

     Next to the node that you want to drop, click and select Remove Nodes. The server monitor runs the CAS removeNode action, which stops the node and redistributes its data to other nodes in the cluster.

     Note: The process of dropping (removing) a node ensures that active and backup copies of table blocks are preserved. This requires that all sessions complete their actions and pause while the blocks are moved. Long-running actions are canceled, and occasionally, a session might need to be killed so that the operation can proceed. The data movement often takes minutes.
     TipRemoving a node is best suited for times when the system is mainly processing batch jobs, where a delay is not a concern.
   • View information about processes running on a particular node:

     Next to the node that you want to view process information about, click and select Show Processes.

   • Stop the server immediately by sending a kill signal to the server process:

     Next to the node that you want to stop, click and select Terminate Server Instance. The server monitor issues a command to kill the node process.

     Note: Terminate a server instance only after having tried removing a node. Using terminate might not release resources (for example, mapped memory and memory involving database connections, and so on).

Adjust Caslib Management Privileges

To enable non-administrators to add global caslibs:

1. Sign in to CAS Server Monitor with a valid user ID and password that has administrator privileges.
2. In CAS Server Monitor, beneath the Cloud Analytic Services banner, click .
3. On the Configuration page, select Access Controls.
4. In the Caslibs list, select Global Caslib Creation.
   TipIf the Global Caslib Creation caslib is not listed, you are not signed in as an administrator.
5. In the upper right, click Edit.
6. In the Edit Access Controls window, adjust values as needed.

   Intent	Instructions
   Enable all users to add global caslibs.	In the existing row for Authenticated Users, select the Grant radio button.
   Enable a group to add global caslibs.	Click Add Row. Select Group, enter the group name, and select the Grant radio button.
   Enable an individual user to add global caslibs.	Click Add Row. Select User, enter the user name, and select the Grant radio button.

7. Click OK to save your changes.
8. Under Access Controls, review the results of your changes.
9. Verify that users who should be able to add global caslibs can do so.

Here are details:

• User and group names that you enter are not validated.
• Regardless of access controls, administrators can add and manage all caslibs.
• For the special caslibs (Global Caslib Creation and Session Caslib Creation), the only available value in the Activity column is Manage Access. The special caslibs are protected by role requirements, not by the ManageAccess permission. Granting or denying the ManageAccess permission on the special caslibs affects only the ability of non-administrators to manage other caslibs.
• If you want to restrict the ability to manage session caslibs, select Session Caslib Creation in the Caslibs list. Add direct denials as needed.

Stop a CAS Server

You can use CAS Server Monitor to shut down the CAS server. For a distributed CAS server, in addition to the controller, clicking the shutdown button stops all the CAS worker nodes and the backup controller (if present).

1. Sign in to CAS Server Monitor with a user ID that has CAS Administrator privileges.
2. In CAS Server Monitor, beneath the Cloud Analytic Services banner, click .
3. On the System State page, make sure that Controller is selected.
4. At the top, on the right side of the page, click Shutdown.

Remove CAS Worker Software

1. Sign in to CAS Server Monitor with a user ID that has CAS Administrator privileges.
2. Drop the CAS worker node whose software you want to remove.

   For more information, see View and Manage CAS Nodes.

3. Sign in to the CAS controller machine with root-level privileges.
4. On the CAS controller machine, remove the machine name of the worker node from /opt/sas/viya/config/etc/cas/default/cas.hosts.
5. Edit the inventory file on the Ansible controller machine to remove the deploy target definition at the top of the file. Also remove the deploy target name from [sas_casserver_worker].
6. Run the site.yml playbook to update Consul with the correct list of hosts.
7. Sign in to the CAS worker machine with sudo or root-level privileges.
8. Run the following commands from an operating system prompt:

   sudo /opt/sas/viya/home/libexec/deployment/stop-all-services.sh

   sudo /opt/sas/viya/home/libexec/deployment/pre-uninstall.sh

   sudo /opt/sas/viya/home/libexec/deployment/uninstall.sh

   sudo mv /opt/sas/viya/ /opt/sas/viya_$(date +"%m_%d_%Y")