Netscape logo
Guide to Customizing and Distributing Mozilla 1.4.1

Previous      Contents      Next     

Chapter 1   Getting Started

This chapter provides an overview of the customization and distribution process, a brief introduction to the kinds of customizations you can make with the Client Customization Kit (CCK), and a few simple guidelines for using the CCK Tool.

This chapter contains these sections:

Why Customize and Distribute Mozilla?
Overview of the Customization and Distribution Process
System Requirements
Platform Support
Installing the Client Customization Kit Tool
What Customizations Can I Make?
Which Customizations Can I Make Quickly?
Using the CCK Tool

Why Customize and Distribute Mozilla?


The Mozilla browser is the most customizable browser available today. By customizing Mozilla to match your business requirements, you can drive more traffic to your web site, increase revenue, and reduce development and support. Combined with the loyal Mozilla customer base and strong brand acceptance, the ability to tailor Mozilla to your needs makes it stand out as a powerful business asset compared to other browsers.

Mozilla 1.4.1 can help you

Why Do Users Prefer Mozilla 1.4.1?

While many people are loyal to the Mozilla brand, others choose it because of the product benefits. Mozilla 1.4.1 lets them do more online and exercise fine-grained control over their online experience. It also delivers greatly enhanced performance and stability:

To learn more about Mozilla 1.4.1, see http://www.mozilla.ort/releases.

Overview of the Customization and Distribution Process


Here's an overview of the ten main steps you'll follow to customize and distribute your own version of Mozilla 1.4.1:

  1. Set up your ISP. If you are setting up your ISP business, you must first do the necessary business and financial planning; set up your servers, Internet access, and other physical infrastructure; and plan for post-distribution customer support. For sources of information on these topics, see Appendix A "Resources for ISPs."

  2. Decide which customization strategy you want to pursue. You have three choices:

  3. Use the CCK tool to make the simplest customizations. Follow these steps:

    1. Download and install the Client Customization Kit
    2. Review the rest of this chapter and make sure your available hardware and software meets the system requirements.
    3. Follow the instructions in Chapter 2 "Customizing Mozilla in Ten Minutes" for making the simplest customizations. Even if you want to make some of the more complex customizations described in the rest of this document, this chapter can help you get acquainted with the CCK tool quickly.
    4. Based on the information in this chapter and Chapter 2, determine what customizations you want to make and which platforms you want to create installers for.
    5. If the customizations you want to make are limited to the simple ones described in Chapter 2, you can skip to Chapter 12 or Chapter 13 (see Step 9 below).
       
  4. Use the CCK Tool to make more advanced customizations. Follow these steps:

    1. If you need more information about any CCK tool screen or if you wish to use the CCK tool to make additional customizations that require some file preparation, read the relevant parts of Chapters 3 through 9.
    2. Prepare your customized files, if any. Use the checklists in this chapter to decide which custom files you need to create. Chapters 5 through 8 provide detailed instructions on specific file customizations.
    3. Note that some customizations don't require you to create a customized file first. For example, to change Navigator's default home page or include your company name in the CD autorun screen, you simply enter this information directly into the tool and let the tool do the rest. See Table 1-1 for a list of quick customizations that you can enter directly into the CCK tool.
       
    4. Start the CCK tool and create a new configuration for the installer you want to create first. Depending on how many installers you want to create and which platforms you want to support, you may have to run the CCK more than once and you may have to create more than one configuration.
    5. For more information about configurations and installers, see Chapter 3 "Using the Configuration Workspace for Customized Files" and Chapter 4 "Preparing Platform and Installer Information."
       
    6. Run the rest of the CCK tool.
    7. Click Next on each screen after providing the appropriate information.
       
       
  5. Build and test your installer.

    1. On the CCK tool's last screen, click Build Installer to create your Mozilla installer.
    2. Run your custom installer and verify that all your customizations made with the CCK tool have taken effect correctly. For detailed instructions, see Chapter 10 "Verifying Your CCK Tool Customizations." If you find any errors, fix the customized files involved (if necessary) and run the CCK tool again to regenerate the installer.
       
  6. Make additional manual customizations. These can include advanced customizations for the CD autorun screen, turning of Mozilla activation, and other tasks that require direct manipulation of the installation files. For detailed instructions, see Chapter 11 "Manually Customizing the CD Autorun Screen" and Chapter 12 "Advanced Mozilla Customizations."

  7. Test your manual customizations. Run your custom installer, verify that all your manual customizations to have taken effect correctly, and if necessary fix any customizations that have not taken effect.

  8. Important: If you make any manual customizations, do not run the CCK tool again for the same configuration, or it will overwrite all your manual customizations.
     
  9. Prepare for distribution. Follow these steps:

    1. If you want to distribute a customized Macintosh installer, follow the instructions in Chapter 13 "Preparing Macintosh Installers and Program Files."
    2. Assemble your CD layout or make your network installer available on your FTP site for download.
    3. If you're providing a CD-based installer, assemble a CD layout that consists of your Mozilla installer, related Mozilla installation files, and any other files you want to include on the CD.
       
      If you're providing a network-downloadable installer, copy the installer and its associated files to your network's FTP server and provide users with instructions on how to download and run the installer.
       
      Chapter 14 "Distributing Your Installers" describes how to prepare your customized installation files for CD and/or online distribution.
       
    4. If you've created a CD-based installer, prepare it for distribution to your customers.
       
  10. Distribute Mozilla and provide appropriate information to your customers regarding installation, initial account setup, and customer support. The steps a customer follows after receiving the a CD from an ISP typically go something like this:

    1. Installs software (including but not necessarily limited to Mozilla 1.4.1), either from a CD or over the network, according to instructions provided by the ISP.
    2. Configures system and browser software for the new account.
    3. Account setup can be done manually or automatically (with the aid of software provided by the ISP). Typically, it involves configuring dialer and modem software, TCP/IP settings, and Mozilla 1.4.1 settings such as email address according to information provided by the ISP.
       
    4. Connects with the ISP, logs in, and begins using the service.
       
    Details of end-user instructions for installation and account setup vary widely among ISPs. To get you started:
     

System Requirements


CCK Tool Requirements

To create a Windows installer with the CCK tool, you need a system that meets these requirements:

If you are creating a Linux installer, your Windows system must also meet these requirements:

If you are creating a Linux installer, you must download the standard Mozilla 1.4.1 Linux tar file from http://ftp.mozilla.org to some convenient location before you run the CCK tool. (The standard Linux installation files are not included in the CCK package and must therefore be downloaded separately—unlike the Windows installation files, which are included with CCK.)

Mozilla 1.4.1 Requirements

To test a Windows installer, you need a Windows system that meets these requirements:

To test a Linux installer, you need a Linux system that meets these requirements:

To create and test a Macintosh installer, you need a Macintosh system that meets these requirements:

Important: The CCK tool works for only one version of Mozilla. For example, in order to customize Mozilla 1.4, you must use CCK 1.4, CCK 1.5 allows you to customize Mozilla 1.5 only, and CCK 1.4.1 customizes only Mozilla 1.4.1 software. The CCK download package includes the appropriate version of the Mozilla software for Windows. If you wish to create Macintosh and/or Linux installers, you need to download the standard Mozilla 1.4.1 installation files for those platforms separately.

Platform Support


The CCK tool can produce installers that run on Windows, Linux, or Macintosh:

Installing the Client Customization Kit Tool


Before you install CCK, be sure to read the current Release Notes, which describe known problems and workarounds:

http://home.netscape.com/eng/mozilla/ns62/relnotes/cck.html

To install the Client Customization Kit after you've downloaded the setup file:

What Customizations Can I Make?


The CCK tool allows you to make any or all of the customizations listed in the following sections.

Mozilla Navigator Customizations

The Mozilla Navigator browser is generally the first screen users see when they start Mozilla. Customizing the browser allows you to

Using the CCK tool, you can make these browser customizations:

Mail and News Customizations

You can specify Mail and Newsgroup server settings to simplify account set up for your customers. For example, you can customize the options available on the New Account Setup wizard:


You can also specify domain names, servers, ports, and other details of the default settings the user will encounter while setting up mail and news accounts.

CD Autorun Screen Customizations

The CD autorun screen automatically appears when a user inserts a Mozilla CD into a CD-ROM drive. Using the CCK tool, you can make these customizations to the standard CD autorun screen:

This illustration shows some of the elements you can customize in the standard CD autorun screen:


Installer Customizations

CCK creates a Mozilla installer that is both CD- and network-ready. Navigator is part of every installer. You can select which of the following components you want your installer to include:

Some components are not available on all platforms. See Table 9-1 for details.

Customization Services Options

If you don't want to make the customizations yourself, Mozilla To Go makes it easy, efficient, and economical for you to distribute customized versions of Mozilla by providing these services:

For more information and convenient online ordering, go to

Which Customizations Can I Make Quickly?


Some customizations don't require you to create a customized file before you start using the CCK tool. If you just want to make some quick customizations, such as changing Navigator's default home page or including your company name in the CD autorun screen, you simply enter this information directly into the CCK tool.

Table 1-1 summarizes the quick customizations you can make.

Table 1-1    Quick Customizations Checklist


Component

What You Can Customize

CD autorun screen

Display your company name on the CD autorun screen that users see when they insert the Mozilla 6 CD.

Help menu

Add your own menu item and URL to Mozilla's Help menu. This URL can take users to your own online customer support page.

Navigator

Change Navigator's default home page.

Display your company name in the browser window's title bar.

Append your company identifier to Navigator's user agent string.

Program folder name

Append your company name to Mozilla's program folder name in the Windows Start menu.

Mail and News server settings

Set the default domain and server settings for Mozilla Mail and News.

Proxy Configurations

Set up the default proxy configurations for Mozilla.

Using the CCK Tool


To run the CCK tool, open the Start menu and choose Programs, then Mozilla 1.4.1 Client Customization Kit, CCKTool.

The CCK Tool uses a standard Wizard interface to guide you through the process of customizing Mozilla 1.4.1. When you finish entering the information for a given screen, you click Next to proceed to the next screen.

For a quick hands-on tour of the simplest customizations, see Chapter 2 "Customizing Mozilla in Ten Minutes."

Working with CCK Configurations

The first screen of the CCK tool includes a drop-down list that shows what configurations are available. You can work with configurations in the following ways:

For more information about CCK configurations, see Chapter 3 "Using the Configuration Workspace for Customized Files."

Saving Changes

Each time you click Next in a CCK screen, the information you entered or changed on that screen is automatically saved with your configuration.

You can exist the tool at any time and continue working with your configuration later.

To exit the CCK tool, click the Exit button on any screen. When you click Exit, the information you entered in previous screens (but not in the screen where you clicked Exit) is saved with your configuration.

You relaunch the tool at any time to continue entering information for that configuration.

Reviewing and Verifying Your Customizations

To review all the customizations you entered in the CCK tool before building your installer, click the Show Config Info button on the final Create the Installer screen. You can also go back to any screen and make additional changes before building your installer.

Your custom installer is created in

installation_directory\CCKTool\Configs\my_config\Output

where installation_directory is the directory where you installed the CCK tool and my_config is the name of the configuration you are customizing.

Run your custom installer and verify that all your customizations have taken effect correctly. If you find any errors, fix the customized files involved (if necessary) and run the CCK tool again to regenerate the installer before proceeding with any manual customizations.

For more information about verifying the customizations you make with the CCK tool, see Chapter 10 "Verifying Your CCK Tool Customizations."

Getting Help

To get help while using the CCK tool:



Previous      Contents      Next     

Copyright © 2003 Netscape Communications Corp. All rights reserved.


Last Updated July 30, 2003