Restarting RAS

To restart the RAS application, follow the steps below.

The below steps are all per-server:

If restarting both RAS servers, the steps need to be performed independently on both web servers.
If you know that one server is specifically having issues (see Checking RAS Status) then you can restart just that one server while the other is running.

Steps

SSH to each web server (raprod-web-01, raprod-web-02) using PuTTY or SecureCRT.
Switch to the 'tomadm' user:
```
sudo su - tomadm
```
When prompted, enter your password (the same password you used to log into your own account).
Go to the tomcat directory:
```
cd /usr/local/apache-tomcat-8.5.38/bin
```
Run the 'shutdown' script:
```
./shutdown.sh
```
Wait for ten seconds to give the server time to shut down normally.
Check to see if the server is still running using the 'ps' command:
```
ps -ef|grep java
```
If you just see a single line that ends with "grep java", the server has stopped and you can proceed to restart it.
Fig. 1: Successful server shutdown
1. If you see a longer line ending with "org.apache.catalina.startup.Bootstrap start" then the server was unable to shut down normally and needs to be killed. Look for the process ID (the second value on the line, just after the user 'tomadm') and make a note of it. Then run the following command to manually kill the tomcat process, using the process ID in place of the #'s below:
```
kill -9 #####
```
  Wait another ten seconds and run the "ps -ef|grep java" command again. The tomcat process should be gone -- if not, try the kill command again.
  
  Fig. 2: Output of ps command showing server still running
Once the server is no longer running, restart it:
```
./startup.sh
```
While the server is starting, print the log output to the screen to monitor its progress:
```
tail -f /usr/local/apache-tomcat-8.5.38/logs/catalina.out
```
Startup can take anywhere from 1 to 5 minutes, but is usually around 1.5-2.5 minutes in production.
Log content will scroll by in quick bursts during startup; when it is finished, it will stop and the final line printed will display the startup time:
INFO: Server startup in ##### ms
(The log will also scroll as users log into and use the application, so once the server has started it may not stay at the "startup" line for long.)
You can press Ctrl+C to stop the log output once you're seen the startup message.

Fig. 3: Successful startup in the log output
Log into the application at ras.tufts.edu to verify that it started successfully. If you receive the red-and-white Kuali Coeus homepage that says "Welcome, (Your Name)" after logging in, then all is well.

Fig. 4: Home page after successful login