The Problem Determination Analyzer Tool (PDATool) is an automated, Java-based tool that enables you to collect SAS^® server services log files and relevant configuration files. In addition, the tool can perform health monitoring for defined SAS^® 9.4 functionality for specific SAS services or solutions. (See the table in Usage Options, later in this article.) You must place this tool on the SAS 9.4 server-tier machine where these SAS 9.4 server services run. As currently designed, this tool works for SAS^® 9.4 installations only.

Installation and Configuration

This section explains how to configure the PDATool automated tool to collect the SAS 9.4 Server Services log and configuration files.

1. Click here to download the PDATool. The PDTool.zip file in a specific folder of your choice on the machine where SAS 9.4 Server tier services are installed and running.
2. In UNIX operating environments, set execution permissions for the PDATool.sh script by execution the following command. (If you have a Microsoft Windows environment, then you can skip this step.)

chmod 765 PDATool.sh

See the Usage Options table in the "Execution Commands" section below and review the command options that are available.

Execution Commands

This section provides several examples of execution commands and a table of additional options that are available.

Example Execution Commands

For Windows operating environments:

For UNIX operating environments:

Output Locations

All of the output files are placed under the following folder structure based on the execution examples that are shown in the Example Execution Commands section.

Note: In the following paths, date-time specifies the actual date and time (for example, 20141212-164645).

For Windows operating environments:

For UNIX operating environments:

Usage Options

Valid Parameter Options	Explanation
activemq	Collects the SAS 9.4 ActiveMQ JMS Broker log as well as configuration files. This option creates the following ZIP files under the output folder: ActiveMQ_bin.zip, ActiveMQ_conf.zip, and ActiveMQ_data.zip.
cachelocator	Collects the SAS 9.4 Cache Locator (gemfire) log as well as configuration files. This option creates the following ZIP files under the output folder: CacheLocator_logs_bin.zip and CacheLocator_instances.zip.
dmcdataserver	Collects the SAS 9.4 Decision Manager Common Data Server log as well as configuration files. This option creates the following ZIP files under the output folder: DMCDataServer_log.zip and DMCDataServer_conf.zip
installation	Collects the SAS 9.4 Configure log as well as configuration files. This option creates the following ZIP files under the output folder: Installation_configurelogs.zip, Installation_documentshtml.zip, Installation_levelUtilities.zip, Installation_AppServerProps.zip, and InstallMisc_hotfixlog.zip
metdataserver	Collects the SAS 9.4 Metadata Server log as well as configuration files. This option creates the following ZIP files under the output folder: MetaDataServer_CFGConfig.zip, MetaDataServer_Logs.zip, MetaDataServer_TXTConfig.zip, and MetaDataServer_XMLConfig.zip.
objectspawner	Collects the SAS 9.4 Object Spawner log as well as configuration files. This option creates the following ZIP file under the output folder: ObjectSpawner_Logs_Config.zip.
olapserver	Collects the SAS 9.4 SASApp - OLAP Server log as well as configuration files. This option creates the following ZIP file under the output folder: OLAPServer_Logs_Config.zip.
pooledworkspaceserver	Collects the SAS 9.4 SASApp - PooledWorkspaceServer log as well as configuration files. This option creates the following ZIP file under the output folder: PooledWorkSpaceServer_Logs_Config.zip.
rgfapp	Collects only SAS®9 Risk Governance Framework Application v7.*  log and configuration files. This option creates several ZIP files pertaining to SAS Risk Governance Framework Application and dependent services or applications. It also collects SAS Metadata Configuration relevant to SAS Risk Governance Framework Application v7.*. It also performs basic checks on SAS Web Application availability.
rgfcontent	Collects only SAS®9 Risk Governance Framework Content Installation log and configuration files. This option creates the following ZIP file under the output folder: serverprops.zip, dbscripts, CRTOOL.zip, and CRContent.zip
rgfdataserver	Collects SAS 9.4 Risk Governance Framework Data Server log as well as configuration files. This option creates the following ZIP files under the output folder: RGFDataServer_log.zip, and RGFDataServer_conf.zip
rgfinstall	Collects only SAS®9 Risk Governance Framework v7.*  Installation log and configuration files. This option creates the following ZIP files under the output folder: Installation_AppServerProps.zip, Installation_levelUtilities.zip, InstallMisc_hotfixlog.zip, and Install_statusxml.zip
sascontentserver	Collects SAS 9.4 Content Server log as well as configuration files. This option creates the following ZIP files under the output folder: SASContentServer_Logs.zip and SASContentServer_Repository.zip.
-output	Specifies the output folder where data that is collected by the tool is stored. If the output directory does not exist, then the tool creates it first. In addition, this option creates a unique subfolder named date-time under the requested output folder, which consists of various ZIP files for the SAS services that are requested.
evmanager	Collects SAS® 9.4 Environment Manager server and agent logs as well as configuration files. This option creates the following ZIP files under the output folder: SASEMAgent_bin.zip, SASEMAgent_conf.zip, SASEMAgent_data.zip, SASEMApplication_log.zip, SASEMServer_activemq.zip, SASEMServer_bin.zip, SASEMServer_conf.zip, SASEMServer_data.zip, and SASEMServer_logs.zip.
schedulingserver	Collects SAS 9.4 Scheduling Server logs as well as configuration files. This option creates the following ZIP file under the output folder: SchedulingServer_Logs_Config.zip.
scslcanalyzer	Collects the SAS® 9.4 Content Server log as well as configuration files. This option creates the following ZIP files under the output folder: SASContentServer_Logs.zip and SASContentServer_Repository.zip. The option also collects metadata configuration information that is relevant  to SAS Content Server. It also performs basic checks on WebDAV Repository availability.
srcdataserver	Collects SAS 9.4 Risk Common Data Server log as well as configuration files. This option creates the following ZIP files under the output folder: SRCDataServer_log.zip and SRCDataServer_conf.zip
storedprocesssserver	Collects the SAS 9.4 Stored Process Server log as well as configuration files. This option creates the following ZIP fils under the output folder: StoredProcessServer_logConfig.zip
webappserver	Collects SAS® 9.4 Web Application Server (tcServer) or Tomcat Server logs as well as configuration files. This option creates the following ZIP files (for all of the SASServer instances) under the output folder: SASServerX_X_bin.zip, SASServerX_X_conf.zip, and SASServerX_X_logs.zip.
weblogs	Collects only SAS 9.4 web application logs (web logs). This option creates the following ZIP file under the output folder: WebApplications_Logs.zip.
webserver	Collects SAS 9.4 Web Server logs as well as configuration files. This option creates the following ZIP files under the output folder: WebServer_conf.zip, WebServer_logs.zip, and WebServer_ssl.zip.
wipdataserver	Collects SAS 9.4 Web Infrastructure Platform Data Server logs as well as configuration files. This option creates the following ZIP files under the output folder: WIPDataServer_data.zip and WIPDataServer_logs.zip.
workspaceserver	Collects SAS 9.4 SASApp - WorkSpace Server logs as well as configuration files. This option creates the following ZIP file under the output folder: WorkSpaceServer_Logs_Config.zip.