KB-2250 How to run the Appian Log Generator and Diagnostics scripts

Kaushal Patel — Wed, 21 Jan 2026 16:42:30 GMT

Current Revision posted to Appian Knowledge Base by Kaushal Patel on 1/21/2026 4:42:30 PM

Purpose

Appian is made up of multiple components, all of which must remain healthy for the platform to function properly. Traditionally, checking the health of each component requires running separate built-in scripts, which can be time consuming. Troubleshooting often involves collecting various log files based on the issue at hand - a process that typically requires manually identifying, zipping, and compressing multiple files and folders across different components.

This article introduces the following tools that simplify and streamline this process:

The Appian Log Generator scripts - Quickly creates a tar file containing relevant logs from different Appian components, reducing the manual effort involved in log collection.
The Appian Diagnostics script - Gathers essential health metrics from the Appian environment and the underlying server in a fast and efficient way.
The Appian on Kubernetes Log Generator and Diagnostics script - Gathers logging, metrics, and configuration details from the Appian environment, designed specifically for Appian on Kubernetes.

Table of Contents:

What are the Appian Log Generator scripts?
What is the Appian Diagnostics script?
Equivalent for Appian on Kubernetes
Instructions (non-Kubernetes)
- Log Generator
- Diagnostics
Instructions (Kubernetes)

What are the Appian Log Generator scripts?

Appian Support maintains two scripts for log generation for non-containerized Appian (running on Windows or Linux OS):

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The logs/service-manager directory which has the kafka and zookeeper logs.
3. The forty five most recent db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

What is the Appian Diagnostics script?

The Appian Diagnostics script appian_health_diagnostics.sh combines the different diagnostic scripts into a single script so that the state of each component in the environment can be understood by running one single script. In addition to the health of the Appian components the script also provides system level details like the RAM, CPU and disk usage of the server used to host Appian.

Note that this script does not interact with log files or retrieves any information that could be deemed sensitive in nature, apart from server hostnames. The script only leverages the existing out-of-the-box diagnostic scripts and prints the output to a new log file. The script only gathers the details of the Appian components which are hosted on the server that the script is run on.

Equivalent for Appian on Kubernetes

In addition to the above scripts, Appian Support also maintains one script for both log generation and diagnostics for Appian on Kubernetes.

aok_log_diagnostic_script.sh - This script retrieves:
1. Pod logs for all core Appian components in the site's namespace.
2. Pod and node resource metrics and status outputs.
3. The Appian custom resource definition (CRD).

Instructions (non-Kubernetes)

Log Generation Scripts

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_sm_log_generator.sh
2. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_sm_log_generator.sh
2. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Diagnostic Script

Run the following steps to execute the script:

Download the script to the server which hosts Appian.
Make the appian_health_diagnostics.sh script executable.
1. chmod +x appian_health_diagnostics.sh
Run the following command: appian_health_diagnostics.sh -d *APPIAN_HOME* -p *SERVICE_MANAGER_PASSWORD*
1. eg: ./appian_health_diagnostics.sh -d /usr/local/appian/ae -p password
The script will generate the diagnostic file in the APPIAN_HOME/logs directory.
Attach the newly created diagnostic file to the support case.

Instructions (Appian on Kubernetes)

The script to gather logs and metrics for Appian on Kubernetes can be downloaded here.

Run the following steps to execute the script

Place the script in a location where it can reach the cluster. The script works by executing a series of kubectl commands, so any CLI that can reach the cluster's API Server should work.
Make the script executable. For example:
1. chmod +x aok_log_diagnostic_script.sh
Execute the script, passing in a parameter for the namespace for your Appian site. For example:
1. ./aok_log_diagnostic_script.sh *my-appian-site*
Optionally you can also pass in a parameter to specify how many days of logging to collect (default is logs from the last 2 days). For example, to collect logs from the past 3 days you would run
1. ./aok_log_diagnostic_script.sh *my-appian-site* 3
The script will generate a file called aok_log_diagnostic_bundle.tar in the directory the script is executed in.
Attach the newly generated .tar file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: January 2025

Tags: Tomcat, logging, how-to, search server, data-server, service manager

KB-2250 How to run the Appian Log Generator and Diagnostics scripts

Kaushal Patel — Wed, 21 Jan 2026 16:41:20 GMT

Revision 18 posted to Appian Knowledge Base by Kaushal Patel on 1/21/2026 4:41:20 PM

Purpose

This article introduces the following tools that simplify and streamline this process:

The Appian Log Generator scripts - Quickly creates a tar file containing relevant logs from different Appian components, reducing the manual effort involved in log collection.
The Appian Diagnostics script - Gathers essential health metrics from the Appian environment and the underlying server in a fast and efficient way.
The Appian on Kubernetes Log Generator and Diagnostics script - Gathers logging, metrics, and configuration details from the Appian environment, designed specifically for Appian on Kubernetes.

Table of Contents:

What are the Appian Log Generator scripts?
What is the Appian Diagnostics script?
Equivalent for Appian on Kubernetes
Instructions (non-Kubernetes)
- Log Generator
- Diagnostics
Instructions (Kubernetes)

What are the Appian Log Generator scripts?

Appian Support maintains two scripts for log generation for non-containerized Appian (running on Windows or Linux OS):

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The logs/service-manager directory which has the kafka and zookeeper logs.
3. The forty five most recent db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

What is the Appian Diagnostics script?

Equivalent for Appian on Kubernetes

In addition to the above scripts, Appian Support also maintains one script for both log generation and diagnostics for Appian on Kubernetes.

aok_log_diagnostic_script.sh - This script retrieves:
1. Pod logs for all core Appian components in the site's namespace.
2. Pod and node resource metrics and status outputs.
3. The Appian custom resource definition (CRD).

Instructions (non-Kubernetes)

Log Generation Scripts

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_sm_log_generator.sh
2. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_sm_log_generator.sh
2. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Diagnostic Script

Run the following steps to execute the script:

Download the script to the server which hosts Appian.
Make the appian_health_diagnostics.sh script executable.
1. chmod +x appian_health_diagnostics.sh
Run the following command: appian_health_diagnostics.sh -d *APPIAN_HOME* -p *SERVICE_MANAGER_PASSWORD*
1. eg: ./appian_health_diagnostics.sh -d /usr/local/appian/ae -p password
The script will generate the diagnostic file in the APPIAN_HOME/logs directory.
Attach the newly created diagnostic file to the support case.

Instructions (Appian on Kubernetes)

The script to gather logs and metrics for Appian on Kubernetes can be downloaded here.

Run the following steps to execute the script

Place the script in a location where it can reach the cluster. The script works by executing a series of kubectl commands, so any CLI that can reach the cluster's API Server should work.
Make the script executable. For example:
1. chmod +x aok_log_diagnostic_script.sh
Execute the script, passing in a parameter for the namespace for your Appian site. For example:
1. ./aok_log_diagnostic_script.sh *my-appian-site*
Optionally you can also pass in a parameter to specify how many days of logging to collect (default is logs from the last 2 days). For example, to collect logs from the past 3 days you would run
1. ./aok_log_diagnostic_script.sh *my-appian-site* 3
The script will generate a file called aok_log_diagnostic_bundle.tar in the directory the script is executed in.
Attach the newly generated .tar file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: July 2025

Tags: Tomcat, logging, how-to, search server, data-server, service manager

KB-2250 How to run the Appian Log Generator and Diagnostics scripts

pauline.delacruz — Thu, 28 Aug 2025 14:30:19 GMT

Revision 17 posted to Appian Knowledge Base by pauline.delacruz on 8/28/2025 2:30:19 PM

Purpose

This article introduces the following tools that simplify and streamline this process:

The Appian Log Generator scripts - Quickly creates a tar file containing relevant logs from different Appian components, reducing the manual effort involved in log collection.
The Appian Diagnostics script - Gathers essential health metrics from the Appian environment and the underlying server in a fast and efficient way.
The Appian on Kubernetes Log Generator and Diagnostics script - Gathers logging, metrics, and configuration details from the Appian environment, designed specifically for Appian on Kubernetes.

Table of Contents:

What are the Appian Log Generator scripts?
What is the Appian Diagnostics script?
Equivalent for Appian on Kubernetes
Instructions (non-Kubernetes)
- Log Generator
- Diagnostics
Instructions (Kubernetes)

What are the Appian Log Generator scripts?

Appian Support maintains two scripts for log generation for non-containerized Appian (running on Windows or Linux OS):

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The logs/service-manager directory which has the kafka and zookeeper logs.
3. The forty five most recent db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

What is the Appian Diagnostics script?

Equivalent for Appian on Kubernetes

In addition to the above scripts, Appian Support also maintains one script for both log generation and diagnostics for Appian on Kubernetes.

aok_log_diagnostic_script.sh - This script retrieves:
1. Pod logs for all core Appian components in the site's namespace.
2. Pod and node resource metrics and status outputs.
3. The Appian custom resource definition (CRD).

Instructions (non-Kubernetes)

Log Generation Scripts

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_sm_log_generator.sh
2. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_sm_log_generator.sh
2. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Diagnostic Script

Run the following steps to execute the script:

Download the script to the server which hosts Appian.
Make the appian_health_diagnostics.sh script executable.
1. chmod +x appian_health_diagnostics.sh
Run the following command: appian_health_diagnostics.sh -d *APPIAN_HOME* -p *SERVICE_MANAGER_PASSWORD*
1. eg: ./appian_health_diagnostics.sh -d /usr/local/appian/ae -p password
The script will generate the diagnostic file in the APPIAN_HOME/logs directory.
Attach the newly created diagnostic file to the support case.

Instructions (Appian on Kubernetes)

The script to gather logs and metrics for Appian on Kubernetes can be downloaded here.

Run the following steps to execute the script

Place the script in a location where it can reach the cluster. The script works by executing a series of kubectl commands, so any CLI that can reach the cluster's API Server should work.
Make the script executable. For example:
1. chmod +x aok_log_diagnostic_script.sh
Execute the script, passing in a parameter for the namespace for your Appian site. For example:
1. ./aok_log_diagnostic_script.sh *my-appian-site*
Optionally you can also pass in a parameter to specify how many days of logging to collect (default is logs from the last 2 days). For example, to collect logs from the past 3 days you would run
1. ./aok_log_diagnostic_script.sh *my-appian-site* 3
The script will generate a file called aok_log_diagnostic_bundle.tar in the directory the script is executed in.
Attach the newly generated .tar file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: July 2025

Tags: Tomcat, logging, how-to, search server, data-server, service manager

KB-2250 How to run the Appian Log Generator and Diagnostics scripts

pauline.delacruz — Wed, 02 Jul 2025 20:54:59 GMT

Revision 16 posted to Appian Knowledge Base by pauline.delacruz on 7/2/2025 8:54:59 PM

Purpose

This article introduces the following tools that simplify and streamline this process:

The Appian Log Generator scripts - Quickly creates a tar file containing relevant logs from different Appian components, reducing the manual effort involved in log collection.
The Appian Diagnostics script - Gathers essential health metrics from the Appian environment and the underlying server in a fast and efficient way.
The Appian on Kubernetes Log Generator and Diagnostics script - Gathers logging, metrics, and configuration details from the Appian environment, designed specifically for Appian on Kubernetes.

Table of Contents:

What are the Appian Log Generator scripts?
What is the Appian Diagnostics script?
Equivalent for Appian on Kubernetes
Instructions (non-Kubernetes)
- Log Generator
- Diagnostics
Instructions (Kubernetes)

What are the Appian Log Generator scripts?

Appian Support maintains two scripts for log generation for non-containerized Appian (running on Windows or Linux OS):

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The logs/service-manager directory which has the kafka and zookeeper logs.
3. The forty five most recent db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

What is the Appian Diagnostics script?

Equivalent for Appian on Kubernetes

In addition to the above scripts, Appian Support also maintains one script for both log generation and diagnostics for Appian on Kubernetes.

aok_log_diagnostic_script.sh - This script retrieves:
1. Pod logs for all core Appian components in the site's namespace.
2. Pod and node resource metrics and status outputs.
3. The Appian custom resource definition (CRD).

Instructions (non-Kubernetes)

Log Generation Scripts

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_sm_log_generator.sh
2. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_sm_log_generator.sh
2. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Diagnostic Script

Run the following steps to execute the script:

Download the script to the server which hosts Appian.
Make the appian_health_diagnostics.sh script executable.
1. chmod +x appian_health_diagnostics.sh
Run the following command: appian_health_diagnostics.sh -d *APPIAN_HOME* -p *SERVICE_MANAGER_PASSWORD*
1. eg: ./appian_health_diagnostics.sh -d /usr/local/appian/ae -p password
The script will generate the diagnostic file in the APPIAN_HOME/logs directory.
Attach the newly created diagnostic file to the support case.

Instructions (Appian on Kubernetes)

The script to gather logs and metrics for Appian on Kubernetes can be downloaded here.

Run the following steps to execute the script

Place the script in a location where it can reach the cluster. The script works by executing a series of kubectl commands, so any CLI that can reach the cluster's API Server should work.
Make the script executable. For example:
1. chmod +x aok_log_diagnostic_script.sh
Execute the script, passing in a parameter for the namespace for your Appian site. For example:
1. ./aok_log_diagnostic_script.sh *my-appian-site*
Optionally you can also pass in a parameter to specify how many days of logging to collect (default is logs from the last 2 days). For example, to collect logs from the past 3 days you would run
1. ./aok_log_diagnostic_script.sh *my-appian-site* 3
The script will generate a file called aok_log_diagnostic_bundle.tar in the directory the script is executed in.
Attach the newly generated .tar file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: July 2025

Tags: Tomcat, logging, how-to, search server, data-server, service manager

KB-2250 How to run the Appian Log Generator and Diagnostics scripts

pauline.delacruz — Wed, 02 Jul 2025 20:53:42 GMT

Revision 15 posted to Appian Knowledge Base by pauline.delacruz on 7/2/2025 8:53:42 PM

Purpose

This article introduces the following tools that simplify and streamline this process:

The Appian Log Generator scripts - Quickly creates a tar file containing relevant logs from different Appian components, reducing the manual effort involved in log collection.
The Appian Diagnostics script - Gathers essential health metrics from the Appian environment and the underlying server in a fast and efficient way.
The Appian on Kubernetes Log Generator and Diagnostics script - Gathers logging, metrics, and configuration details from the Appian environment, designed specifically for Appian on Kubernetes.

Table of Contents:

What are the Appian Log Generator scripts?
What is the Appian Diagnostics script?
Equivalent for Appian on Kubernetes
Instructions (non-Kubernetes)
- Log Generator
- Diagnostics
Instructions (Kubernetes)

What are the Appian Log Generator scripts?

Appian Support maintains two scripts for log generation for non-containerized Appian (running on Windows or Linux OS):

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The logs/service-manager directory which has the kafka and zookeeper logs.
3. The forty five most recent db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

What is the Appian Diagnostics script?

Equivalent for Appian on Kubernetes

In addition to the above scripts, Appian Support also maintains one script for both log generation and diagnostics for Appian on Kubernetes.

aok_log_diagnostic_script.sh - This script retrieves:
1. Pod logs for all core Appian components in the site's namespace.
2. Pod and node resource metrics and status outputs.
3. The Appian custom resource definition (CRD).

Instructions (non-Kubernetes)

Log Generation Scripts

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Diagnostic Script

Run the following steps to execute the script:

Download the script to the server which hosts Appian.
Make the appian_health_diagnostics.sh script executable.
1. chmod +x appian_health_diagnostics.sh
Run the following command: appian_health_diagnostics.sh -d *APPIAN_HOME* -p *SERVICE_MANAGER_PASSWORD*
1. eg: ./appian_health_diagnostics.sh -d /usr/local/appian/ae -p password
The script will generate the diagnostic file in the APPIAN_HOME/logs directory.
Attach the newly created diagnostic file to the support case.

Instructions (Appian on Kubernetes)

The script to gather logs and metrics for Appian on Kubernetes can be downloaded here.

Run the following steps to execute the script

Place the script in a location where it can reach the cluster. The script works by executing a series of kubectl commands, so any CLI that can reach the cluster's API Server should work.
Make the script executable. For example:
1. chmod +x aok_log_diagnostic_script.sh
Execute the script, passing in a parameter for the namespace for your Appian site. For example:
1. ./aok_log_diagnostic_script.sh *my-appian-site*
Optionally you can also pass in a parameter to specify how many days of logging to collect (default is logs from the last 2 days). For example, to collect logs from the past 3 days you would run
1. ./aok_log_diagnostic_script.sh *my-appian-site* 3
The script will generate a file called aok_log_diagnostic_bundle.tar in the directory the script is executed in.
Attach the newly generated .tar file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: July 2025

Tags: Tomcat, logging, how-to, search server, data-server, service manager

KB-2250 How to run the Appian Log Generator and Diagnostics scripts

pauline.delacruz — Thu, 01 May 2025 19:29:07 GMT

Revision 14 posted to Appian Knowledge Base by pauline.delacruz on 5/1/2025 7:29:07 PM

Purpose

This article introduces the following tools that simplify and streamline this process:

The Appian Log Generator scripts - Quickly creates a tar file containing relevant logs from different Appian components, reducing the manual effort involved in log collection.
The Appian Diagnostics script - Gathers essential health metrics from the Appian environment and the underlying server in a fast and efficient way.
The Appian on Kubernetes Log Generator and Diagnostics script - Gathers logging, metrics, and configuration details from the Appian environment, designed specifically for Appian on Kubernetes.

Table of Contents:

What are the Appian Log Generator scripts?
What is the Appian Diagnostics script?
Equivalent for Appian on Kubernetes
Instructions (non-Kubernetes)
- Log Generator
- Diagnostics
Instructions (Kubernetes)

What are the Appian Log Generator scripts?

Appian Support maintains two scripts for log generation for non-containerized Appian (running on Windows or Linux OS):

appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The logs/service-manager directory which has the kafka and zookeeper logs.
3. The forty five most recent db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

What is the Appian Diagnostics script?

Equivalent for Appian on Kubernetes

In addition to the above scripts, Appian Support also maintains one script for both log generation and diagnostics for Appian on Kubernetes.

aok_log_diagnostic_script.sh - This script retrieves:
1. Pod logs for all core Appian components in the site's namespace.
2. Pod and node resource metrics and status outputs.
3. The Appian custom resource definition (CRD).

Instructions (non-Kubernetes)

Log Generation Scripts

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Diagnostic Script

Run the following steps to execute the script:

Download the script to the server which hosts Appian.
Make the appian_health_diagnostics.sh script executable.
1. chmod +x appian_health_diagnostics.sh
Run the following command: appian_health_diagnostics.sh -d *APPIAN_HOME* -p *SERVICE_MANAGER_PASSWORD*
1. eg: ./appian_health_diagnostics.sh -d /usr/local/appian/ae -p password
The script will generate the diagnostic file in the APPIAN_HOME/logs directory.
Attach the newly created diagnostic file to the support case.

Instructions (Appian on Kubernetes)

The script to gather logs and metrics for Appian on Kubernetes can be downloaded here.

Run the following steps to execute the script

Place the script in a location where it can reach the cluster. The script works by executing a series of kubectl commands, so any CLI that can reach the cluster's API Server should work.
Make the script executable. For example:
1. chmod +x aok_log_diagnostic_script.sh
Execute the script, passing in a parameter for the namespace for your Appian site. For example:
1. ./aok_log_diagnostic_script.sh *my-appian-site*
Optionally you can also pass in a parameter to specify how many days of logging to collect (default is logs from the last 2 days). For example, to collect logs from the past 3 days you would run
1. ./aok_log_diagnostic_script.sh *my-appian-site* 3
The script will generate a file called aok_log_diagnostic_bundle.tar in the directory the script is executed in.
Attach the newly generated .tar file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: May 2025

Tags: Tomcat, logging, how-to, search server, data-server, service manager

KB-2250 How to run the Appian Log Generator and Diagnostics scripts

pauline.delacruz — Thu, 01 May 2025 19:22:35 GMT

Revision 13 posted to Appian Knowledge Base by pauline.delacruz on 5/1/2025 7:22:35 PM

Purpose

This article introduces the following tools that simplify and streamline this process:

The Appian Log Generator scripts - Quickly creates a tar file containing relevant logs from different Appian components, reducing the manual effort involved in log collection.
The Appian Diagnostics script - Gathers essential health metrics from the Appian environment and the underlying server in a fast and efficient way.
The Appian on Kubernetes Log Generator and Diagnostics script - Gathers logging, metrics, and configuration details from the Appian environment, designed specifically for Appian on Kubernetes.

Table of Contents:

What are the Appian Log Generator scripts?
What is the Appian Diagnostics script?
Equivalent for Appian on Kubernetes
Instructions (non-Kubernetes)
- Log Generator
- Diagnostics
Instructions (Kubernetes)

What are the Appian Log Generator scripts?

Appian Support maintains two scripts for log generation for non-containerized Appian (running on Windows or Linux OS):

appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The logs/service-manager directory which has the kafka and zookeeper logs.
3. The forty five most recent db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

What is the Appian Diagnostics script?

Equivalent for Appian on Kubernetes

In addition to the above scripts, Appian Support also maintains one script for both log generation and diagnostics for Appian on Kubernetes.

aok_log_diagnostic_script.sh - This script retrieves:
1. Pod logs for all core Appian components in the site's namespace.
2. Pod and node resource metrics and status outputs.
3. The Appian custom resource definition (CRD).

Instructions (non-Kubernetes)

Log Generation Scripts

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Diagnostic Script

Run the following steps to execute the script:

Download the script to the server which hosts Appian.
Make the appian_health_diagnostics.sh script executable.
1. chmod +x appian_health_diagnostics.sh
Run the following command: appian_health_diagnostics.sh -d *APPIAN_HOME* -p *SERVICE_MANAGER_PASSWORD*
1. eg: ./appian_health_diagnostics.sh -d /usr/local/appian/ae -p password
The script will generate the diagnostic file in the APPIAN_HOME/logs directory.
Attach the newly created diagnostic file to the support case.

Instructions (Appian on Kubernetes)

The script to gather logs and metrics for Appian on Kubernetes can be downloaded here.

Run the following steps to execute the script

Place the script in a location where it can reach the cluster. The script works by executing a series of kubectl commands, so any CLI that can reach the cluster's API Server should work.
Make the script executable. For example:
1. chmod +x aok_log_diagnostic_script.sh
Execute the script, passing in a parameter for the namespace for your Appian site. For example:
1. ./aok_log_diagnostic_script.sh my-appian-site
Optionally you can also pass in a parameter to specify how many days of logging to collect (default is logs from the last 2 days). For example, to collect logs from the past 3 days you would run
1. ./aok_log_diagnostic_script.sh my-appian-site 3
The script will generate a file called aok_log_diagnostic_bundle.tar in the directory the script is executed in.
Attach the newly generated .tar file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: May 2025

Tags: Tomcat, logging, how-to, search server, data-server, service manager

KB-2250 How to run the Appian Log Generator and Diagnostics scripts

pauline.delacruz — Thu, 01 May 2025 19:21:54 GMT

Revision 12 posted to Appian Knowledge Base by pauline.delacruz on 5/1/2025 7:21:54 PM

Purpose

This article introduces the following tools that simplify and streamline this process:

The Appian Log Generator scripts - Quickly creates a tar file containing relevant logs from different Appian components, reducing the manual effort involved in log collection.
The Appian Diagnostics script - Gathers essential health metrics from the Appian environment and the underlying server in a fast and efficient way.
The Appian on Kubernetes Log Generator and Diagnostics script - Gathers logging, metrics, and configuration details from the Appian environment, designed specifically for Appian on Kubernetes.

Table of Contents:

What are the Appian Log Generator scripts?

Appian Support maintains two scripts for log generation for non-containerized Appian (running on Windows or Linux OS):

appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The logs/service-manager directory which has the kafka and zookeeper logs.
3. The forty five most recent db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

What is the Appian Diagnostics script?

Equivalent for Appian on Kubernetes

In addition to the above scripts, Appian Support also maintains one script for both log generation and diagnostics for Appian on Kubernetes.

aok_log_diagnostic_script.sh - This script retrieves:
1. Pod logs for all core Appian components in the site's namespace.
2. Pod and node resource metrics and status outputs.
3. The Appian custom resource definition (CRD).

Instructions (non-Kubernetes)

Log Generation Scripts

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Diagnostic Script

Run the following steps to execute the script:

Download the script to the server which hosts Appian.
Make the appian_health_diagnostics.sh script executable.
1. chmod +x appian_health_diagnostics.sh
Run the following command: appian_health_diagnostics.sh -d *APPIAN_HOME* -p *SERVICE_MANAGER_PASSWORD*
1. eg: ./appian_health_diagnostics.sh -d /usr/local/appian/ae -p password
The script will generate the diagnostic file in the APPIAN_HOME/logs directory.
Attach the newly created diagnostic file to the support case.

Instructions (Appian on Kubernetes)

The script to gather logs and metrics for Appian on Kubernetes can be downloaded here.

Run the following steps to execute the script

Place the script in a location where it can reach the cluster. The script works by executing a series of kubectl commands, so any CLI that can reach the cluster's API Server should work.
Make the script executable. For example:
1. chmod +x aok_log_diagnostic_script.sh
Execute the script, passing in a parameter for the namespace for your Appian site. For example:
1. ./aok_log_diagnostic_script.sh my-appian-site
Optionally you can also pass in a parameter to specify how many days of logging to collect (default is logs from the last 2 days). For example, to collect logs from the past 3 days you would run
1. ./aok_log_diagnostic_script.sh my-appian-site 3
The script will generate a file called aok_log_diagnostic_bundle.tar in the directory the script is executed in.
Attach the newly generated .tar file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: May 2025

Tags: Tomcat, logging, how-to, search server, data-server, service manager

KB-2250 How to run the Appian Log Generator and Diagnostics scripts

pauline.delacruz — Thu, 01 May 2025 18:16:55 GMT

Revision 11 posted to Appian Knowledge Base by pauline.delacruz on 5/1/2025 6:16:55 PM

Purpose

This article introduces the following tools that simplify and streamline this process:

The Appian Log Generator scripts - Quickly creates a tar file containing relevant logs from different Appian components, reducing the manual effort involved in log collection.
The Appian Diagnostics script - Gathers essential health metrics from the Appian environment and the underlying server in a fast and efficient way.
The Appian on Kubernetes Log Generator and Diagnostics script - Gathers logging, metrics, and configuration details from the Appian environment, designed specifically for Appian on Kubernetes.

Table of Contents:

What are the Appian Log Generator scripts?

Appian Support maintains two scripts for log generation for non-containerized Appian (running on Windows or Linux OS):

appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The logs/service-manager directory which has the kafka and zookeeper logs.
3. The forty five most recent db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

What is the Appian Diagnostics script?

Equivalent for Appian on Kubernetes

In addition to the above scripts, Appian Support also maintains one script for both log generation and diagnostics for Appian on Kubernetes.

aok_log_diagnostic_script.sh - This script retrieves:
1. Pod logs for all core Appian components in the site's namespace.
2. Pod and node resource metrics and status outputs.
3. The Appian custom resource definition (CRD).

Instructions (non-Kubernetes)

Log Generation Scripts

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Diagnostic Script

Run the following steps to execute the script:

Download the script to the server which hosts Appian.
Make the appian_health_diagnostics.sh script executable.
1. chmod +x appian_health_diagnostics.sh
Run the following command: appian_health_diagnostics.sh -d *APPIAN_HOME* -p *SERVICE_MANAGER_PASSWORD*
1. eg: ./appian_health_diagnostics.sh -d /usr/local/appian/ae -p password
The script will generate the diagnostic file in the APPIAN_HOME/logs directory.
Attach the newly created diagnostic file to the support case.

Instructions (Appian on Kubernetes)

The script to gather logs and metrics for Appian on Kubernetes can be downloaded here.

Run the following steps to execute the script

Place the script in a location where it can reach the cluster. The script works by executing a series of kubectl commands, so any CLI that can reach the cluster's API Server should work.
Make the script executable. For example:
1. chmod +x aok_log_diagnostic_script.sh
Execute the script, passing in a parameter for the namespace for your Appian site. For example:
1. ./aok_log_diagnostic_script.sh my-appian-site
Optionally you can also pass in a parameter to specify how many days of logging to collect (default is logs from the last 2 days). For example, to collect logs from the past 3 days you would run
1. ./aok_log_diagnostic_script.sh my-appian-site 3
The script will generate a file called aok_log_diagnostic_bundle.tar in the directory the script is executed in.
Attach the newly generated .tar file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: May 2025

Tags: Tomcat, logging, how-to, search server, data-server, service manager

KB-2250 How to run the Appian Log Generator scripts

Maggie Deppe-Walker — Wed, 21 Jun 2023 06:01:14 GMT

Revision 10 posted to Appian Knowledge Base by Maggie Deppe-Walker on 6/21/2023 6:01:14 AM

Purpose

Providing different log files depending on the underlying issue is often a vital step to further an investigation. Appian Log Generator scripts are quick and efficient ways to generate tar files of logs belonging to different Appian components. The scripts replace the manual effort required to identify, zip, compress different files and folders relevant to different Appian components. This article explains how to run the log generator scripts.

What are the Appian Log Generator scripts?

Appian Support maintains two scripts for log generation:

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The service-manager directory which has the kafka and zookeeper logs.
3. The forty five most recent db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

Instructions

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: June 2023

Tags: Tomcat, logging, how-to, search server, data-server, service manager

INT-2250 How to run the Appian Log Generator scripts

Tejas Kargutkar — Tue, 20 Jun 2023 13:27:14 GMT

Revision 9 posted to Appian Knowledge Base by Tejas Kargutkar on 6/20/2023 1:27:14 PM

Purpose

Solution Engineering frequently asks customers to provide different log files depending on the underlying issue. Appian Log Generator scripts are quick and efficient ways for customers to generate tar files of logs belonging to different Appian components. The scripts replace the manual effort required to identify, zip, compress different files and folders relevant to different Appian components. This article explains how to run the log generator scripts.

What are the Appian Log Generator scripts?

Appian Solution Engineering maintains two scripts for log generation:

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The service-manager directory which has the kafka and zookeeper logs.
3. The forty five most recent db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

Instructions

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: June 2023

Tags: Tomcat, logging, how-to, search server, data-server, service manager

INT-2250 How to run the Appian Log Generator scripts

Tejas Kargutkar — Tue, 20 Jun 2023 13:20:41 GMT

Revision 8 posted to Appian Knowledge Base by Tejas Kargutkar on 6/20/2023 1:20:41 PM

Purpose

What are the Appian Log Generator scripts?

Appian Solution Engineering maintains two scripts for log generation:

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The service-manager directory which has the kafka and zookeeper logs.
3. The db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

Instructions

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: June 2023

Tags: Tomcat, logging, how-to, search server, data-server, service manager

INT-2250 How to run the Appian Log Generator scripts

Tejas Kargutkar — Tue, 20 Jun 2023 12:11:52 GMT

Revision 7 posted to Appian Knowledge Base by Tejas Kargutkar on 6/20/2023 12:11:52 PM

Purpose

What are the Appian Log Generator scripts?

Appian Solution Engineering maintains two scripts for log generation:

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The service-manager directory which has the kafka and zookeeper logs.
3. The db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

Instructions

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: June 2023

Tags: Tomcat, logging, how-to, search server, data-server, service manager

INT-2250 How to run the Appian Log Generator scripts

Tejas Kargutkar — Tue, 20 Jun 2023 11:58:36 GMT

Revision 6 posted to Appian Knowledge Base by Tejas Kargutkar on 6/20/2023 11:58:36 AM

Purpose

What are the Appian Log Generator scripts?

Appian Solution Engineering maintains two scripts for log generation:

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The service-manager directory which has the kafka and zookeeper logs.
3. The db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

Instructions

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: June 2023

Tags: Tomcat, logging, how-to, search server, data-server, service manager

INT-2250 How to run the Appian Log Generator scripts

Maggie Deppe-Walker — Tue, 20 Jun 2023 02:50:59 GMT

Revision 5 posted to Appian Knowledge Base by Maggie Deppe-Walker on 6/20/2023 2:50:59 AM

Purpose

What are the Appian Log Generator scripts?

Appian Solution Engineering maintains two scripts for log generation:

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The service-manager directory which has the kafka and zookeeper logs.
3. The db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

Instructions

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: June 2023

Tags: Tomcat, logging, how-to, search server, data-server, service manager

INT-2250 How to run the Appian Log Generator scripts

Maggie Deppe-Walker — Fri, 16 Jun 2023 03:52:53 GMT

Revision 4 posted to Appian Knowledge Base by Maggie Deppe-Walker on 6/16/2023 3:52:53 AM

Purpose

This article explains how to run the log generator scripts maintained by the SE Infrastructure squad.

What are the Appian Log Generator scripts?

Appian Solution Engineering maintains two scripts for this purpose:

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The service-manager directory which has the kafka and zookeeper logs.
3. The db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

Instructions

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: June 2023

Tags: Tomcat, logging, how-to, search server, data-server, service manager

INT-XXXX How to run Appian Log Generator scripts

Maggie Deppe-Walker — Fri, 16 Jun 2023 03:46:26 GMT

Revision 3 posted to Appian Knowledge Base by Maggie Deppe-Walker on 6/16/2023 3:46:26 AM

Purpose

What are the Appian Log Generator scripts?

Appian Solution Engineering maintains two scripts for this purpose:

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The service-manager directory which has the kafka and zookeeper logs.
3. The db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

Instructions

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: June 2023

Tags: Tomcat, logging, how-to, search server, data-server, service manager

How to run Appian Log Generator scripts

Maggie Deppe-Walker — Fri, 16 Jun 2023 03:46:08 GMT

Revision 2 posted to Appian Knowledge Base by Maggie Deppe-Walker on 6/16/2023 3:46:08 AM

Purpose

What are the Appian Log Generator scripts?

Appian Solution Engineering maintains two scripts for this purpose:

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The service-manager directory which has the kafka and zookeeper logs.
3. The db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

Instructions

The script to gather engine, service-manager, kafka, and zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, and Appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the <APPIAN_HOME>/logs of the server the logs need to be generated on.
1. For high availability environments, the script should be placed in <APPIAN_HOME>/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the Support Case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: June 2023

Tags: Tomcat, logging, search server, data-server, service manager

Instructions to run Appian Log Generator scripts

Tejas Kargutkar — Thu, 15 Jun 2023 15:30:24 GMT

Revision 1 posted to Appian Knowledge Base by Tejas Kargutkar on 6/15/2023 3:30:24 PM

What are the Appian Log Generator scripts?

Appian Solution Engineering maintains two scripts for this purpose:

appian_sm_log_generator.sh - This script retrieves:
1. The five most recent service_manager*.log.
2. The service-manager folder which has the kafka and zookeeper logs.
3. The db_* logs.
appian_tomcat_ss_ads_log_generator.sh - This script retrieves:
1. The five most recent tomcat-stdOut* log.
2. The search-server directory hosting the search-server logs.
3. The data-server directory hosting the data-server logs.

Note that the script only gathers the logs from the server that the script is run on. The script should be run individually on each server that the logs should be fetched from.

How do I use it?

The script to gather engine, service-manager, kafka, zookeeper logs can be downloaded here.

The script to gather tomcat, search-server, appian data-server logs can be downloaded here.

Run the following steps to execute the script:

Place the relevant script in the AE_HOME/logs of the server the logs need to be generated on. For high availability environments, the script should be placed in AE_HOME/shared-logs/*server_name* folder of the server the logs need to be generated on. For example: <APPIAN_HOME>/shared-logs/machine1.example.com/
Make the script executable. For example:
1. chmod +x appian_tomcat_ss_ads_log_generator.sh
Execute the script. For example:
1. ./appian_tomcat_ss_ads_log_generator.sh
The script will generate the a file of the format hostname_date*.tar.gz in the directory the script is executed in.
Attach the newly generated tar.gz file to the support case.

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: June 2023

Tags: Tomcat, logging, search server, data-server, service manager