Right Frame

Article ID: 17886
Product Line: Good Mobile Messaging
Product: Good Messaging Server for Exchange
Date: 12 October 2006
Updated: 5 December 2006

GoodTools User Interface

A user interface provided by GoodTools.exe, located in the Good Messaging Server utils directory, which allows the administrator to run the Good Mobile Messaging utilities using a tabbed interface with fields for entry of the values for required utility parameters.

To see how each tool works click on the tool name on the left or its tab in the image below and you will be taken to the command line instructions and a link to the GUI directions.

goodtools utility

Each tab provides fields that allow you to enter that utility’s required data. Details about the data to be entered are provided in the following sections for the supported utilities.

You can then click Send to send the data to customer support or Save to save the data for later transmission to your authorized support representative.

The utilities described below can be run from the command line or from the user interface provided by GoodTools.exe, which is located in the Good Mobile Messaging Server utils directory.

The following information was taken from the Good Mobile Messaging Administrators Guide for Exchange environments.
You can download the guide from our documents page.

TestCDO
click the above link for the GUI instructions or scroll down for the command line instructions

testcdo is a test utility that creates a MAPI login for the indicated user, attempts to access all of the user's calendar events stored in the calendar folder, prints them out, and then logs out. This tool does not search subfolder calendar events.

Run testcdo from the command line. testcdo is found under the util\ folder in the Good Messaging Server installed location. To run the utility on another computer, you must copy all of the files (including all dll’s) from the util directory.

Syntax:

testcdo.exe exchangeserver mailboxname

exchangeserver - Name of the Exchange server that the mailbox username is located on

mailboxname - The mailbox account you want to log onto

Example:

testcdo.exe MAIL2K EricaBacardi

If the test is successful, all calendar events will be printed out. If the test is not successful, two things can occur:

A noted CDO failure
A popup dialogue box indicating an "Unhandled exception in testcdo.dll. Access denied"

Common Resolutions
The usual cause for problems is that permissions for the GoodAdmin account are set incorrectly.

Checklist for debugging

Log all the results from this checklist before contacting your service
representative.
Verify the permissions set for the GoodAdmin account. The permissions differ depending on the Exchange environment. Refer to “Assigning Good Messaging Server and Good Management Server Host Local Permissions” on page 64 of the Good Administrator's Guide for information on setting permissions for the GoodAdmin account.
Locate where CDO.dll is installed on the Good Messaging Server machine and verify that it's the latest version.
Execute testcdo for the problem user and a newly created dummy user on the same Exchange server. Redirect the output to a file and have the customer send us the file. For example, "testcdo.exe MAIL2K JohnSmith > results.txt"
Create a temporary profile for the problem account and newly created dummy user on a test machine, log in to the machine under the GoodAdmin account, and open the user’s profile account. Report any errors to your service representative.
Verify that the Public Folder store is mounted. If the Public Folder store is unmounted, the Good Messaging Server will not be able to process Calendar messages from handhelds. The Public Folder store is used to maintain free/busy information. Calendar entries cannot be updated or created while the Public Folders are unavailable

back to TOP

GLS Connect
click the above link for the GUI instructions or scroll down for the command line instructions

GdGLSConnect tests connectivity from the server that it is running on to the Good Data Center.

Run this tool from the command line. GdGLSConnect is available under the util\ folder in the Good Messaging Server installed location. To run the utility on a different computer, you must copy all of the files (including all dll’s) from the util directory.

Syntax:

GdGLSConnect.exe -k login key -l license_key -s
serial_number [-p product name] [-u ‘<<<url>>>’]
[-n requests] [-w seconds] [-t] [-d]

where:

-k login key specifies the product login key. The key is stored in the following registry key on the Good Messaging Server host machine:

HKEY_LOCAL_MACHINE\SOFTWARE\Good Technology\GoodLink Install Parameters

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\GoodLinkServer\parameters

-l license key specifies the product license key.

-s serial number specifies the product serial number in
serialNumber.hostname format

-u ‘<<<url>>>’ optionally specifies the Good Operations Center url (defaults to '<<<https://xml028.good.com/>>>').

-n number of requests optionally specifies the number of times the request is issued (defaults to 1).

-w seconds between requests optionally specifies the time between requests in seconds when more than one is issued (defaults to 30).

-t turns on tracing.

-d turns on debugging.

Example output:

gdglsconnect built Nov 2 2004 at 14:17:12
Will test using
Version 4.8.0.0
URL: https://qa2xml.qa2.good.com/
SerialNumber: QA00000001
LicensKey: ASIA-ASIA-ASIA-ASIA-ASIA-ASIA
Number: 1
Timout: 20
CurDir is C:\Program Files\Good Technology\Good
Messaging Server\util
SSL dir set to C:\Program Files\Good Technology\
Good Messaging Server\etc\ssl
SSL library databases initialized OK
Attempting first connection to https://
qa2xml.qa2.good.com/
Initial connect to https://qa2xml.qa2.good.com/
okay.
OK (12 ms)
I made 1 operation requests, and all of them succeeded.
PASS
Starting Good Data Center address range check...
We are not using proxy server to get to the Good
Data Center...
checkIPRanges took 1 seconds
protocol:HTTP address:gw1.dev1.good.com port:10000
IPRange:172.18.7.31:172.18.7.32 isproxy:0 error:0
error String:errOk
protocol:HTTP address:gw2.dev1.good.com port:10000
IPRange:172.18.7.31:172.18.7.32 isproxy:0 error:0
error String:errOk
protocol:HTTP address:gw2.dev1.good.com port:10003
IPRange:172.18.7.31:172.18.7.32 isproxy:0
error:65538 error String:errNetConnect
Good Data Center address range check for 1 out of
3 range *** FAILED ***
===============================================
Testing retrieving device list from Orca.
Deleted device.xml file from previous run.
2005-12-30 11:38:54 -08:00 getDeviceTable() STARTING
2005-12-30 11:38:54 -08:00 getDeviceTable() FINISH.
Bytes Received: 78473
2005-12-30 11:38:54 -08:00 Start saving the device
file.
2005-12-30 11:38:54 -08:00 Finished saving the
device file.
Total time to download device table from Orca: 0
seconds.
**** GetDeviceList SUCCESS****

back to TOP

Test Create Profile
click the above link for the GUI instructions or scroll down for the command line instructions

testcreateprofile is a command-line tool for testing the GoodAdmin profile and Good Mobile Messaging Server's ability to create temporary user profiles. testcreateprofile runs nine separate tests.

testcreateprofile is installed by Good Messaging Server and can be found under the util\ folder in the Good Messaging Server installed location. Run the tool from the command line. To run the utility on another computer, you must copy all of the files (including all dll’s) from the util directory.

Syntax:

testcreateprofile.exe -m mailbox name -p “MAPI
profile name” > results.txt
-m Mailbox that you want to test
-p MAPI profile account to use (e.g., Good Messaging Server).
Quotes required.
Nine tests will be executed. If a test fails, a list of troubleshooting
steps will be displayed and logged in results.txt. If all tests are
successful, the message “All Tests PASSED!” will be displayed and
logged at the end of results.txt.
Contact your authorized support representative if taking the
troubleshooting steps doesn’t stop test failures.

back to TOP

Manage Profile
click the above link for the GUI instructions or scroll down for the command line instructions

manageprofile is a command-line tool for managing and testing MAPI profiles. It can be used as a replacement for the NTWMS tool. manageprofile can be used to:

List the currently configured MAPI profile(s)
Open an Exchange mailbox using MAPI as well as CDO via the
GAL application
Create a new MAPI profile
Edit an existing MAPI profile
Delete an existing MAPI profile

Operational events and errors are logged in a user-defined text file for review and troubleshooting.

manageprofile is installed by Good Management Server and can be found under the bin\ folder in the Good Management Server installed location. It is also found under the util\ folder in the Good Messaging Server installed location. Run the tool from the command line. To run the utility on another computer, you must copy all of the files (including all dll’s) from the util directory.

Syntax:

manageprofile -profile profilename -operation
<none/edit/delete> -showgal <yes/no> -log filepath
-reconnflags <yes/no>

To list the currently configured MAPI profile(s), enter the following command:

manageprofile -profile "" -operation none -showgal
no -log c:\manageprofile\log.txt

This command will output a list of MAPI profile names as well as related attribute information for each profile. Sample output followed by an explanation of each item:

CoInitializeEx for user 'THEFORCE\goodadmin'.
Result:0
MAPIInitialize. Result:0
List of all MAPI profiles for the user:'THEFORCE\
goodadmin' (Please wait...)
ProfileName[1]:"Good Management Console" [Connected:
Yes, ExchSrv:YODA, Mailbox:goodadmin,
Default:Yes, Offline:No, GCSrv:yoda.theforce.
good.com] ProfileName[2]:"Good Messaging Server" [Connected:
Yes, ExchSrv:YODA, Mailbox:goodadmin,
Default:No, Offline:No, GCSrv:yoda.theforce.
good.com]

Description of the profile attributes:

Connected: (Yes/No) - Indicates whether the logged-on user is able to log on with 'logon network security' set to 'NT Password Authentication'. If this is 'No', then it is a sign of trouble. If the profile is set to offline also, this will show as 'No'

ExchSrv - Name of the resolved Exchange server. If “CheckName” was not pressed in the profile, this may be empty. An empty value here is a sign of trouble.

Mailbox - Name (alias or display name) of the resolved Exchange User. If “CheckName” was not pressed in the profile, this may be empty. An empty value here is a sign of trouble.

Default: (Yes/No) - Whether this profile is set to default. This value is not significant for non-Outlook environments.

Offline:(Yes/No) - Whether the profile is Offline or set to “Use Local Copy of Mailbox.”

GCSrv - Name of the Global Catalog Server that the profile is connecting to. This value will be present only if connecting to Active Directory and E200x environments. An empty value here is OK. If this value is present, make sure that it is pointing to the correct Active Directory domain controller/Global Catalog Server.

Example log entry for unresolved profile:

12-04-2003 10-51-01 ProfileName[6]:"unresolved"
[Connected:No, ExchSrv:, Mailbox:, Default:No,
Offline:No, GCSrv:]

To test access to a mailbox via MAPI and CDO, enter the following command:

manageprofile -profile profileName -operation none
-showgal yes -log c:\manageprofile\log.txt

When this command is entered, a Global Address List (GAL) application will be launched. Select the user from the list to be tested and then click on the [OK] button. If successful, the following popup window will be displayed.

Opened 'Angel Bocan' mailbox using MAPI and CDO.
Please see file 'c:\manageprofile\log.txt' for
mailbox details

Click [OK] button to return to GAL application to test another mailbox. From the GAL application, click [Cancel] button to return to command prompt.

To create a new MAPI profile, enter the following command:

manageprofile -profile newProfileName -operation
edit -showgal no -log c:\manageprofile\log.txt

When this command is entered, a MAPI profile window will be launched. In the General tab, enter the Microsoft Exchange Server name and enter the Mailbox name. Select the [Check Name] button to resolve the mailbox name - it will underline if mailbox resolves successfully.

To edit an existing MAPI profile, enter the following command:

manageprofile -profile profileName -operation edit
-showgal no -log c:\manageprofile\log.txt

When this command is entered, a MAPI profile window will be launched. In the General tab, the Microsoft Exchange Server name and the Mailbox name will be displayed. Modify values as appropriate.

To delete an existing MAPI profile, enter the following command:

manageprofile -profile profileName -operation

delete -showgal no -log c:\manageprofile\log.txt

To view the log, enter the following command:

notepad log.txt

back to TOP

Purge User
click the above link for the GUI instructions or scroll down for the command line instructions

purgeuser is a command-line utility that purges a Good Messaging user’s configuration folders and disconnects the user’s handheld from Good Messaging Server. To be used, the handheld will need to be recradled and set up again.

Run the tool from the command line. purgeuser is found under the util\ folder in the Good Messaging Server installed location.

Syntax:

purgeuser "/o=mycompany/ou=myorg/cn=Recipients/
cn=myalias"

The required Exchange address information can be found in the Good Management Console by right-clicking on the user you want to purge and going to Properties | Details. The information is displayed on the second line, next to “Mailbox Address (DN).”

Suggestion: Type the user’s Exchange address information into Notepad so that when you run purgeuser, you can simply copy the information from Notepad and paste it at the command prompt.