Getting Started

This section discusses the following topics:

• Installing the Globalyzer Client
• Starting the Globalyzer Client
• Globalyzer Window Overview
• Using Globalyzer
• Exiting Globalyzer

Installing the Globalyzer Client

Starting the Globalyzer Client

1. Follow your platform-specific startup instructions below:

   Windows Instructions:
   

   • If you have followed the default Windows installation, to start Globalyzer, go to: Start menu => All Programs => Globalyzer => Globalyzer 3.3

   Linux Instructions:
   

   • After downloading, double-click on the Globalyzer 3.3 shortcut on the desktop (if created and permissions are set correctly)
   • Or, select Globalyzer 3.3 from the Applications menu (under Globalyzer)
   • You can also run from a terminal window:
      $ java -Xmx1024m -jar globalyzer-client.jar

   Mac Instructions:
   

   • After downloading, double-click on the globalyzer-client.jar file under the install directory
   • You can also run from the command line:
      $ java -Xmx1024m -jar /Applications/Globalyzer 3.3/globalyzer-client.jar
2. If the startup process was successfull, the login window appears. If this is the first time you have logged in, the fields will be empty.
3. Enter your email address and password. When you created your Globalyzer account, or the administrator of your Globalyzer user group created your account, you should have been emailed your username and password along with the login url.

   If you do not know what to enter here, see your Globalyzer administrator. If your company has a Globalyzer Server license, this administrator will be within your company. If you are operating under a Globalyzer Client license only, you can contact the Lingoport Globalyzer administrator at support@lingoport.com.

   

4. If your group or company is running the Globalyzer Server internally, you will need to edit the server url. If you are using the standard Lingoport Globalyzer Server (this is the most common scenario) you can skip this step and the following. To edit the server url, click the Connections button. The Login Connections dialog appears. Enter the server URL in the field provided. If you do not know the URL, you can obtain it from your Globalyzer Administrator. This url should have been included in the email that included your username and password.

   

5. If you are connecting to a Globalyzer Server running within your company's intranet, it is unlikely that you will need to set the proxy server settings, in which case you can leave them blank and can now click OK in the Login Connections dialog. If you do need to set proxy server information, see the next step.
6. If you are connecting to a Globalyzer Server - whether it is in-company or the Lingoport Globalyzer Server - and your http calls will be going through a proxy server, you will need to fill in all or some of the elements of the Proxy Server Information section of this dialog box. The settings can often be obtained directly from your web browser configuration. Leave the Login Name and Password fields blank if you don't log in to connect to the internet.

7. Click OK in the Login Connections dialog.
8. Click OK in the Globalyzer Login dialog.

After you have been successfully logged into the server, the main Globalyzer window appears.

Globalyzer Window Overview

When you start Globalyzer, the application window appears, as shown below. The main parts of the interface are labeled, and briefly described below.

The Toolbar has buttons linked to the most common actions used in Globalyzer. All these can also be found in the Menubar.

The Source Tree pane displays the current Base Source Directory along with its subdirectories and files. Note that only files that match the File Extensions list for the currently-selected Scan will be displayed.

The Scan Results pane contains all the scan results. By using the dropdowns in this pane you can navigate between different scans and/or result types, and apply and add filters to the scan results.

When you double-click on a row in the Scan Results table, Globalyzer will open the associated source file in the Source Files pane and highlight the issue.

The Quick Summary pane displays a summary from the most recent scan. Each Results type (Embedded Strings, Unsafe Methods, General Patterns and Static File References) has its own section in the Summary.

The Status pane will display various messages. For example, during a scan, the names of individual files scanned will be displayed.

Using Globalyzer

Before you scan code, you must create one or more Rule Sets, or obtain access to Rule Sets created by someone else for your project. After you have a Rule Set to use, you can configure the Globalyzer Client to use the Rule Set and set up other properties Globalyzer needs to perform a scan. For instance, you need to tell Globalyzer where to find source files to scan, where to put reports, and so on. These procedures are described in Configuring Rule Sets and Scanning Source Code.

If you intend to use Globalyzer to fix code, then you also need to configure several project properties. For instance, you need to specify a method to replace embedded text that has been externalized. These properties and procedures are described in Fixing Source Code.

Exiting Globalyzer

To exit Globalyzer, select File=>Exit from the Menubar. Globalyzer will display a warning if there are unsaved Source File changes.

Only files that were modified since last being saved will show up in the list. To select or deselect a single file, click the checkbox next to the filename.

All -- Selects all of the listed files.

None -- Deselects all of the listed files.

OK -- Saves the selected files and then exits Globalyzer.

Cancel -- Closes the dialog box without saving any files: Exit is aborted.

 User's Guide Contents