SAS Technical Support might request that you remove and reconfigure the SAS Environment Manager 9.4 server configuration as a part of the troubleshooting process. SAS Technical Support might recommend this process if the configuration is corrupted in some way and needs to be redeployed to bring it back to its out-of-the-box configuration.

---

Prerequisites

Before you attempt to remove and reconfigure SAS Environment Manager 9.4, review the following prerequisites and ensure that you are prepared. Below is a list of what you will need.

• access to the SAS Software Depot that contains the order for the current environment
• your current SAS Installation Data File (SID file), also known as your license file
• the plan.xml file that was used for the deployment
• the SAS Install User account ID and password
  • Note: You must run the SAS^® Deployment Manager and SAS^® Deployment Wizard tools as the SAS Install User.
• the sasadm@saspw password
• the sasevs@saspw password
• a copy of the current hyperic.keystore
  • Note: This copy is necessary only if SAS Environment Manager was already configured for HTTPS. In this scenario, copy hyperic.keystore to a location outside of the SAS Environment Manager server configuration directory.

---

Remove and Reconfigure SAS Environment Manager 9.4

Note: Before you complete these steps, SAS Technical Support suggests that you take a full backup of the environment (such as a snapshot). 

Remove the Configuration

1. Stop the SAS middle-tier services. 
   • Do not stop all SAS services. SAS^® Metadata Server and the Web Infrastructure Platform Data Server must be running.
   • For UNIX systems, there is a sas.servers.mid script that you can use in the SAS-configuration-directory/LevN/ directory.
   • For Windows systems, you need to shut down the SAS middle-tier services in the proper order. See the Starting Servers in the Correct Order section of the SAS^® 9.4 System Administration Guide for more information.
2. On the middle-tier host where SAS Environment Manager is configured, run SAS^® Deployment Manager.
3. Select Remove existing configuration.
4. Enter the correct file path for your SAS configuration directory. (For example, C:\SAS\Config or /opt/sas/config.)
5. Enter the sasadm@saspw password to establish a connection to SAS Metadata Server.
6. When prompted to select products, select the following:
   • SAS Environment Manager Configuration - Do NOT select SAS Environment Manager Mid-Tier 2.x; this is a different product.
   • SAS Environment Manager Enablement Kit Plug-in - Do NOT select SAS Environment Manager Enablement Kit Server; this is a different product.
   • SAS Job Monitor Hyperic Plug-in - Note that this product might not exist in your environment.
7. Continue through the prompts to remove the configuration for the selected items.

Uninstall SAS Environment Manager 9.4

1. Once SAS Deployment Manager finishes removing the configuration, launch SAS Deployment Manager again.
2. Select Uninstall SAS Software.
3. Select ONLY SAS Environment Manager 2.X to uninstall.
4. Continue through the prompts.
5. Once the uninstallation completes, take a backup of your metadata. A full system backup is also sufficient if you are able to do so. See the About Backing Up and Restoring Your SAS Content section of the SAS^® 9.4 System Administration Guide for metadata backup steps.

Redeploy SAS Environment Manager

1. From your middle-tier machine, launch SAS Deployment Wizard from your SAS Software Depot.
   • Run the setup.exe file for Windows systems.
   • Run the setup.sh file for UNIX systems.
2. Select Install SAS Software ► Planned Deployment. Select both INSTALL and CONFIGURE software on this prompt.
3. When prompted for a plan file, navigate to the plan.xml file that the current environment used. 
4. When prompted for products to INSTALL, select only SAS Environment Manager. In addition, choose the correct step from the Machine: drop-down list.
5. Browse and select the current SID file for the deployment.
6. Proceed through the system checks and choose the appropriate Configuration Prompting Level. Typical is usually OK.
7. Input the path to the current SAS configuration directory. A pop-up box is displayed stating that SAS Deployment Wizard detects software there. Click Yes. This software detection is expected since you are adding SAS Environment Manager back to an existing configuration.
8. When prompted for products to CONFIGURE, select the following products:
   • SAS Environment Manager
   • SAS Environment Manager Enablement Kit Plugin
   • SAS Job Monitor Hyperic Plugin (select this product only if you had to remove it the first time)
     Note: If SAS Environment Manager Plugins for Foundation Servers is selected by default, then it is OK to leave it selected.
9. Continue through the prompts to perform the re-install and configure.

Note: If you are prompted for a hyperic.keystore file at any point because you had SAS Environment Manager set up for SSL previously, navigate to the backup copy of the hyperic.keystore file that was made before you completed these steps.

---

If any issues occur during this process, or if you have any questions, open a case with SAS Technical Support and provide the Configuration logs from the SAS-configuration-directory/Lev/Logs/Configure/* directory. In addition, provide a screenshot of the step that SAS Deployment Manager or SAS Deployment Wizard fails on.