Reporting Issues

Version 21.1 by michaely on 2021/09/09 18:01
Warning: For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

 

On this page:

This article outlines the procedure for reporting issues you experience with iSymphony, along with information that is required for our support staff to troubleshot issues effectively. When reporting issues, providing as much information as possible can expedite issue resolution.

Creating Tickets

All bug reports and issues should be reported via our Ticket System.

Description

Make sure to include a detailed description of the bug/issue and what you were doing to cause it. Also include the time the bug occurred if possible. Be as detailed as possible.

Transferring Files

In most cases, support representatives will require files from your server in order to troubleshoot issues. You can utilize SCP to download the files onto your personal machine. Once the files are on your personal machine, you can attach them in a new ticket or in a reply to an existing ticket.

Using SCP requires that you know the SSH login credentials for the server.

Windows

To download files, via SCP, to a Windows machine, you can utilize the free application WinSCP (http://winscp.net/)

Linux/OS X

To download files, via SCP, to a Linux or OS X machine, you can utilize the "scp" command.

scp <ssh username>@<ip of server>:<path of file to download> <local file destination path>

For Example, the following command will download the file /root/islogs.tar.gz from the server at 192.168.1.1, to the /home/mike/Downloads directory on your local machine.

scp root@192.168.1.1:/root/islogs.tar.gz /home/mike/Downloads

Once executed, the command will prompt you for the root user password.

Support Packages

iSymphony now allows administrators to create support packages which contain useful information about the system. These packages are used by our support team to expedite the troubleshooting process. Creating s support package is easy, and can be done from the Administration Interface or the server command line.

Failed to execute the [error] macro. Cause: [The required content is missing.]. Click on this message for details.

Creating Support Packages from the Administration Interface

iSymphony provides an easy to use interface that allows administrators to create, and download, support packages directly from the Administration interface.

Failed to execute the [error] macro. Cause: [The required content is missing.]. Click on this message for details.

  1. Log into the Administration Interface. See Connecting to the Administration Interface.

  2. Select Global Configuration at the top right hand corner of the Administration Interface.

    Only super Administrators have access to the Global Configuration section. See Administrators for more information.

  3. Under Create Support Package, select the information you wish to be included in in the package. The default selection is usually sufficient. 
  4. Click Create.
  5. Once the package has been created you can use the Download button to download the package to your system and attach it to a support ticket.

Creating Support Packages from the Command Line

If you are unable to access the Administration Interface, you can create support packages from the server command line by executing the support.sh script. You can specify several parameters to tell the script which pieces of information to include in the package. 

  1. Log into the server via SSH or a terminal.

  2. Run the following command:

    /opt/isymphony3/server/support.sh

    The above command will package all information. If you wish to specify the information that is included in the package you can use the flags specified in the Package Options section below.

  3. Once the script has generated the package it can be found in the following directory on the server:

    /opt/isymphony3/server/support

    You will need to download the file from the server to your machine. See Transferring Files above.

Package Options

Admin Option

Script Flag

Includes

Application Logs

-l

  • All files in the /opt/isymphony3/server/log directory. Excludes any archived (tar.gz) logs.

Archived Logs

-a

  • All archived log files (tar.gz) in the /opt/isymphony3/server/log directory.

Thread Dump

-t

  • Generates a dump of all active threads in the JVM instance and writes it to the /opt/isymphony3/server/log/iSymphonyServer.out.log file.

Failed to execute the [error] macro. Cause: [The required content is missing.]. Click on this message for details.

Failed to execute the [error] macro. Cause: [The required content is missing.]. Click on this message for details.

Environment Information

-e

  • The process id of the running iSymphony server installation, if the server is running.
  • The contents of /proc/cpuinfo. (Processor information)
  • The contents of /proc/meminfo. (Memory Information)
  • The results of running the command free -m.
  • The results of running the netstat -lanp command.
  • A snapshot of the top command.

Configuration Files

-c

 

PBX Configuration

-p

 

Database Files

-d

 

 

Manual Collection

If you are using a version of iSymphony prior to 3.3, you can use the following instructions to collect system information to report to the iSymphony support team.

Logs

Include all log files from /opt/isymphony3/server/log in the ticket. You can make a archive of the logs via the following command.

tar -zcvf islogs.tar.gz /opt/isymphony3/server/log

Environment Information

In many cases it is useful for our support team to know details of the hardware, OS, and JRE used to run iSymphony. 

Operating System Details

You can acquire basic OS information by running the following command on your server's command line:

uname -a

Hardware Details

The following commands can be used to acquire details about the hardware installed on the server:

cat /proc/cpuinfo
free -m

JRE Version

The following command can be used to acquire the version of the JRE iSymphony is utilizing:

source /opt/isymphony3/server/config-vars.sh && ${JAVA_HOME}/bin/java -version

Extra Information For UI Issues

If you encounter a bug/issue with display in the client or administrator (i.e. UI not drawing correctly, phone state not showing what it should, ect.) Try the following steps to attempt to correct it. Please included which step, if any, resolved the issue in your issue report. This will give us a general idea of where the issue exists in the Application.

  1. First try a refresh of the page to see if that corrects the issue.

  2. If the refresh does not work try a restart of the client application by appending ?restartApplication to the end of the URL and hitting enter. 

    Remove the ?restartApplication from the URL once you have used it or else subsequent page refreshing will restart the application.

  3. If a refresh and a client application restart does not fix the issue try a restart of the iSymphony server.

Extra Information For FreePBX Module Issues

If you are using the iSymphony FreePBX Module and you are having issues with configuration syncing between the iSymphony FreePBX Module and the iSymphony Server you will want to add the module debug information to your ticket. See FreePBX Module Administration for more information on how to acquire the module debug contents.

   

Search

Navigation

iSymphony