Isilon: How to gather InsightIQ logs

This article explains how to gather InsightIQ log files for troubleshooting purposes and send them to Isilon Technical Support for review. The instructions apply to all versions of InsightIQ.

Choose steps based on the IIQ version.

IIQ 4.x:

1. Open an SSH connection to the InsightIQ virtual machine and log in using the "administrator" account. If InsightIQ is installed on a Linux server (CentOS, Red Hat), ensure you are at the home directory of the user being logged in as. Issue this command to change the directory to home:

   # cd ~

2. Run the following commands to gather InsightIQ configuration information:

   # cat /etc/isilon/insightiq.ini > ~/insightiq.ini; ifconfig > ~/ifconfig.txt; mount > ~/mount.txt; rpm -qa | grep -i insightiq > ~/iiqversion.txt; df -h > ~/df.txt; top -n1 -b > ~/top.txt; ps auxww > ~/ps.txt; free -m > ~/memory.txt; cat /etc/*release > ~/release.txt; uname -a > ~/kernel.txt; cat /var/cache/insightiq/datastore_3_2.pickle > ~/datastore_3_2.pickle; cat /etc/isilon/uwsgi.ini > ~/insightiq_uwsgi.ini

3. Run the following command to compress the files that are generated by the previous commands and the contents of the "/var/log" and the "/var/cache/insightiq/pgsql/pgstartup.log" directories, where <case_number> is your Isilon Technical Support case number:

   # sudo tar -czvf ~/<case_number>.tgz /var/log /var/cache/insightiq/pgsql/pgstartup.log insightiq.ini ifconfig.txt mount.txt iiqversion.txt df.txt top.txt ps.txt memory.txt release.txt kernel.txt datastore_3_2.pickle insightiq_uwsgi.ini

4. Attach the .tgz file to SR or copy the compressed file to the "/ifs/data/Isilon_Support" directory on the monitored cluster using the secure copy (SCP) command, where <node_ip> is an IP address of any node in the cluster:

   # scp ~/<case_number>.tgz root@<node_ip>:/ifs/data/Isilon_Support

5. Upload the <case_number>.tgz file to Isilon Technical Support. This can be done over:

   1. # isi_gather_info -f <path of .tgz file>

   2. SCP file to the SR (this can be done before moving it to the Isilon)
   3. Upload to temp MFT folder given by support.

IIQ 5.x:

1. Open an SSH connection to the InsightIQ virtual machine and ensure you are at the home directory of the user being logged in as (root for Scale/administrator for Simple). Issue this command to change the directory to home:

   # cd ~

2. Run the following command to create a support package:

   # bash /usr/share/storagemonitoring/scripts/deploymentmanager/iiq_log_bundler.sh

3. Verify that the log bundle is saved to the correct location as a tar.gz file

   # ls -l /var/log | grep insightiq_log

4. Attach the tar.gz file to SR or copy the compressed file to the "/ifs/data/Isilon_Support" directory on the monitored cluster using the secure copy (SCP) command, where <node_ip> is an IP address of any node in the cluster:

   # scp /var/log/insightiq_logs.tar.gz root@<node_ip>:/ifs/data/Isilon_Support 

5. Upload the tar.gz file to Isilon Technical Support. This can be done over:

   1. # isi_gather_info -f <path of .tgz file>

   2. SCP file to the SR (this can be done before moving it to the Isilon)
   3. Upload to temp MFT folder given by support.

IIQ 6.x:

1. Open an SSH connection to the InsightIQ virtual machine and ensure you are at the home directory of the user being logged in as (root for Scale/administrator for Simple). Issue this command to change the directory to home:

   # cd ~

2. Run the following command to create a support package:

   # bash /usr/share/storagemonitoring/scripts/log_collection.sh

   example:

   administrator@localhost:~> bash /usr/share/storagemonitoring/scripts/log_collection.sh
   Please wait while we collect the InsightIQ Logs...
   
   InsightIQ Logs have been successfully bundled into /var/log/insightiq_logs_20250502_144838.tar.gz
   

3. Verify that the log bundle is saved to the correct location as a tar.gz file

   # ls -l /var/log | grep insightiq_log

4. Attach the tar.gz file to SR or copy the compressed file to the "/ifs/data/Isilon_Support" directory on the monitored cluster using the secure copy (SCP) command, where <node_ip> is an IP address of any node in the cluster:

   # scp /var/log/insightiq_logs_20250502_144838.tar.gz root@<node_ip>:/ifs/data/Isilon_Support 

5. Upload the tar.gz file to Isilon Technical Support. This can be done over:

   1. # isi_gather_info -f <path of .tgz file>

   2. SCP file to the SR (this can be done before moving it to the Isilon)
   3. Upload to temp MFT folder given by support.