Smart Suite - Performing a Server Audit
Overview
Support may be called upon to provide server audits for customer sites. Generally, this is requested by sales engineers looking to understand and verify the customer's current environment. Note that customer approval is required before running reports involving Protected Health Information (PHI) or other patient details, however the script identified in this article does not touch any of that data. The Server Audit script is an easy way to gather detailed information about a server, including System Configuration, Spok/Amcom Product Breakdown, and System Performance.
Goal
Using this process, you will be able to quickly and easily assemble the requested information.
First Step
Begin the process by obtaining a copy of the server audit script (current version as of this article draft: server_audit_v1.4.1.sh). A version will be attached to this article, however you may wish to check to see if an updated version may be found elsewhere, for example in the \\amcomsoft.com\teams\Support\MSP Support\Process & Project Management shared folder.
Second Step
Connect to the customer and log in to one of their servers. Check the hosts file using the command: #cat /etc/hosts
Take note how many servers they are using, as you will need to perform the audit separately on each.
Third Step
Upload the audit script to the server to a easy to find directory. ex: /home/amcom
Fourth Step
As root, you may need to change permissions on the script:
[root@spokweb amcom]# cd /home/amcom/
[root@spokweb amcom]# chown amcom:amcom server_audit_v1.4.1.sh
[root@spokweb amcom}# chmod755 server_audit_v1.4.1.sh
Fifth Step
Run the script from the directory it resides on the server:
[root@spokweb amcom]# ./server_audit_v1.4.1.sh
Sixth Step
Upon completion, the script will ask if you want to email, download, or discard the report. Selecting the email option will require that you enter the recipient email address (yours). The download option will automatically download the file to your workstation using zmodem to the download directory specified in your terminal program. There will be two files: [servername].spok.audit_report.txt and sys_errors.txt (which you can usually ignore).
Final Step
Repeat steps three through six for each server in which you need to obtain a audit report.
Additional Step
Most audit requests will want usage statistics pulled directly from the database and another script was developed for this purpose. The gather_stats.sh generates this report and creates a file in /home/amcom when it is complete. It is in the same folder at the server script and needs to be run only on the primary database server. Repeat steps 3-5 to complete then send along with the other files to the customer.
What's Next
Once the audits are complete, you can remove the script and/or any report output still on the server (this is optional, the script and additional files will not utilize much drive space).