Device logging
Use this information to enable tracing on the device, reproduce a problem, and submit a Traveler Problem Report (TPR) to the IBM Traveler server. The system administrator can then notify IBM Support that a TPR has been submitted.
Android devices
To submit a problem report to your system administrator from an Android device, perform the following procedure:- When you encounter a problem, turn logging on by clicking the IBM® Traveler icon and selecting Menu > Settings > Logging > Enable Logging.
- Reproduce the problem if possible. It is important to demonstrate the problem with logging turned on.
- Submit a TPR by clicking the IBM Traveler icon and selecting Menu > About > Report
Problem. Note: For release 8.5.3 and earlier, the option is under Menu > Tools > Report Problem.
- The device collects the logs and sends them to the server. Logs are typically stored in the traveler/logs/tprs folder.
- If the problem is connectivity-related, the log files may not be sent to the server. In this case return to the Report Problem screen by selecting Menu > Tools > Report Problem and select Export. The TPR is placed on your SDcard. Use the Problem Report feature of the IBM Traveler servlet to upload the compressed file. The servlet can be accessed at http://hostname/traveler. For SSL, use HTTPS instead of HTTP in the browser URL.
- If the problem is connectivity-related, the log files may not be sent to the server. In this case return to the Report Problem screen by selecting Menu > Tools > Report Problem and select Export. The TPR is placed on your SDcard. Provide the TPR archive to IBM Support.
- Notify the system administrator of the problem. Be sure to include as much detail as possible and the steps to reproduce the problem.
Apple devices: Logging for issues in the native Mail, Calendar or Contacts apps
Unfortunately, Apple Devices do not have an IBM Traveler client for these
services and therefore have no logs to submit. For these applications, you are recommended to submit
an IBM Traveler Problem Report (TPR) from the IBM Traveler servlet pages using any connected web
browser. The servlet can be accessed at http://hostname/traveler
. For SSL, use
HTTPS instead of HTTP in the browser URL. Additional files can be uploaded as needed. For example,
you may want to upload a particular mail message that does not sync, or upload screen captures or
text documents of error messages. Be sure to also notify the system administrator of the problem and
include as much detail as possible in your report. Typically, the resulting TPR is written to the
sever in the traveler/logs/tprs
folder.
Unfortunately, Apple Devices do not have an IBM Traveler client for these services and therefore have no logs to submit.
Apple devices: Logging for To Do issues
- When you encounter the problem, open the iOS Settings application from the home screen and navigate to the settings sub-menu for To Do.
- Turn logging on by setting Enable Logging to On.
- Reproduce the problem in the To Do app if possible. It is important to demonstrate the problem with logging turned on.
- Submit a TPR by finding the Report a Problem option in the To Do
app.
On an iPhone, this is found in More > Account Settings > Help and Support > Report a Problem. On an iPad, use the Settings icon, then select Help and Support > Report a Problem.
- The device collects the logs and sends them to the server. Logs are typically stored in the
traveler/logs/tprs
folder. If the logs cannot be uploaded due to connectivity problems, the upload will be reattempted at regular intervals until connectivity is restored. - If the app is not able to connect with the server to upload the TPR, you may choose the View Log option under Help and Support to attempt sending the log to your system administrator manually.
- After creating the TPR, or if sending the log manually, notify the system administrator of the problem. Be sure to include as much detail as possible as well as the steps to reproduce the problem.
Apple devices: Logging for IBM Traveler Companion issues
- When you encounter the problem, open the iOS Settings application from the home screen and navigate to the Settings sub-menu for Companion.
- Turn logging on by setting Enable Logging to On.
- Reproduce the problem in the Companion app if possible. It is important to demonstrate the problem with logging turned on.
- Submit a TPR by finding the Report a Problem option in the Companion app, from Help and Support > Report a Problem. If you are currently viewing a mail message in Companion, this option will not be visible until you exit the app and launch it again from the home screen.
The device collects the logs and sends them to the server. Logs are typically stored in the
traveler/logs/tprs
folder. If the logs cannot be uploaded due to connectivity
problems, the upload will be reattempted at regular intervals until connectivity is restored. If the
app is not able to connect with the server to upload the TPR, you may choose the View
Log option under Help and Support to attempt sending the log to
your system administrator manually. After creating the TPR, or if sending the log manually, notify
the system administrator of the problem. Be sure to include as much detail as possible, as well as
the steps to reproduce the problem.
IBM Verse for Apple devices: Logging for mail, calendar or contacts issues
There are two ways to gather and report device information about IBM Verse using logs.
To View and mail logs directly, open the Settings menu in the app and tap View Log to display the user logging information. Tap the Email Log button to mail the log files. Send this to your system administrator with as much detail as possible as well as the steps to reproduce the problem.
The other option is to send a problem report. To do this, open the Settings menu and choose Send a Problem Report. From here, you can optionally identify the type of problem, enter a description of the problem and add attachments (such as screen shots). Tap Send to deliver the report directly to your IBM Traveler server.
IBM Verse for Apple devices: Enabling crash reports to be sent to Apple
- Open the iOS Settings app.
- Select Privacy, then select Analytics.
- Enable both Share iPhone & Watch Analytics and Share With App Developers.
- Open the iOS Settings app.
- Select Privacy > Analytics > Analytics Data.
- Locate any IBM Verse analytics data. The file format will be
IBM Verse-yyyy-mm-dd-ssss
. The file extension will be.ips
. - Select the desired entry to open it. The time stamp built into the name should match the time of your crash.
- In the analytics data, select the relevant text at the top of the file (usually from
{""app_name
down to the line beginning withCoalition
) then copy it. You may also take a screen shot of this section of the file to use as an attachment instead of copying. - To mail the crash analytics data, open the Settings menu in Verse, then tap View Log to display the user logging information. Tap Email Log. This creates a new mail message with the Verse logs already attached. You can then either paste the log text or attach the screen shot(s) of the analytics data. Send the mail to your system administrator with as much detail as possible, as well as the steps to reproduce the problem.
BlackBerry 10: Logging for mail, calendar or contacts issues
BlackBerry 10 devices do not have an IBM Traveler client for these services and therefore have no
logs to submit. For these applications, it is recommended that you submit an IBM Traveler Problem
Report (TPR) from the IBM Traveler servlet pages using any connected web browser. The servlet can be
accessed at http://hostname/traveler
. For SSL, use HTTPS instead of HTTP in the
browser URL. Additional files can be uploaded as needed. For example, you may want to upload a
particular mail message that does not sync, or upload screen captures or text documents of error
messages. Be sure to also notify the system administrator of the problem and include as much detail
as possible in your report. Typically, the resulting TPR is written to the sever in
the traveler/logs/tprs
folder.
Windows Phone devices: Logging for IBM Traveler Companion issues
IBM Traveler Companion (available through the Windows Phone Store) allows you to read encrypted mail on Windows Phone 8 devices. The use of IBM Traveler Companion is currently only supported on Windows Phone devices running IBM Traveler 9.0.1 IF1 or higher. Always ensure you are running the very latest version of IBM Traveler Companion available from the Windows Phone Store. The documentation in this section only applies to the latest version.
- Ensure Logging is turned on. It is disabled by default in the application. To enable it, tap the Additional settings button on the Settings panel in Companion. Touch the slider to toggle logging ON. Once Logging is enabled, you can also control the level of logging and the maximum log size.
- Ensure the logging level is set to All.
- Reproduce the problem in Companion.
- From the Settings panel in Companion, tap ... at the bottom, then choose Report a problem.
- Select the type of problem from the choices provided in the drop down menu.
- Provide a description of the problem and the steps to reproduce it.
- Attach any screenshots that can help with the determination of the problem.
- Select the check mark at the bottom to send this to your system administrator.
Windows Phone/Windows RT/Windows 8 Pro: Logging for mail, calendar or contacts issues
Windows Phone, Windows RT, and Windows 8 Pro devices do not have an IBM
Traveler client for these services and therefore have no logs to submit. For these applications, it
is recommend you submit an IBM Traveler Problem Report (TPR) from the IBM Traveler servlet pages
using any connected web browser. The servlet can be accessed
at http://hostname/traveler
. For SSL, use HTTPS instead of HTTP in the browser URL.
Additional files can be uploaded as needed. For example, you may want to upload a particular mail
message that does not sync, or upload screen captures or text documents of error messages. Be sure
to also notify the system administrator of the problem and include as much detail as possible in
your report. Typically, the resulting TPR is written to the sever in
the traveler/logs/tprs
folder.
Windows Phone, Windows RT, and Windows 8 Pro devices do not have an IBM Traveler client for these services and therefore have no logs to submit.