gecko-dev/cck/CCKDocs/info_cck.htm
leaf%mozilla.org 2832eb9405 adding doc templates, some images, whacking NPL license to MPL. Will
update with tri-license addition at a later date.
2003-07-31 19:54:39 +00:00

844 lines
34 KiB
HTML

<html>
<!--This html file is XHTML complaint, as set forth in the
w3c recommendations except for the following:
Lists work as they do in older versions on HTML and not as
directed in XHTML.
The <a name=" "> tags have targets that use spaces. -->
<head>
<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
<title> Guide to Customizing and Distributing Mozilla 1.4.1: Chapter&#32;4Preparing Platform and Installer Information</title>
<!--The following is a javascript which determines whether the client
is on a Windows machine, or is on another type of operating system. Once
the operating system is determined, either a windows or other operating
system cascading style sheet is used. -->
<script type="text/JavaScript">
<!-- Start hiding
window.onerror=null;
var client=navigator.userAgent.toLowerCase();
var WinStyle = "<STYLE NAME=WINDOWS>\n" +
"body,p {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; } \n" +
"th,tr,td,br,li,dl,dd,ul,ol,li {font-family: helvetica,arial,sans-serif; font-size:10pt; } \n" +
".bartext {font-family: helvetica,arial,sans-serif; font-weight: bold; color: #666666; margin-bottom: 0; margin-top: 0; font-size:14pt;} \n" +
".callout {font-family: helvetica,arial,sans-serif; font-size: 8pt;} \n" +
".calloutlarge {font-family: helvetica,arial,sans-serif; font-size: 9pt;} \n" +
".calloutlargebold {font-family: helvetica,arial,sans-serif; font-size: 9pt; font-weight: bold;} \n" +
".calloutsmall {font-family: helvetica,arial,sans-serif; font-size: 7pt; font-weight: normal;} \n" +
".caption {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 5; margin-top: 0; font-size: 11pt;} \n" +
".caution {font-family: helvetica,arial,sans-serif; font-size:10pt; font-weight: bold; margin-bottom: 0; margin-top: 0; } \n" +
"code {font-family: courier,couriernew,monospaced; font-size: 10pt; margin-bottom: 0; margin-bottom:0; margin-top: 0;} \n" +
".copy {align: center; font-family: helvetica,arial,sans-serif; font-size:8pt; margin-bottom: 0; margin-top: 0;} \n" +
".footnote {font-family: helvetica,arial,sans-serif; font-size:10pt; } \n" +
".gloss {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; } \n" +
".grouptitleix {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 10; margin-top: 20pt; font-size: 14pt;} \n" +
".h1 {font-family: helvetica,arial,sans-serif; font-weight: normal; color: black; margin-bottom: 0; margin-top: 30pt; font-size: 18pt;} \n" +
".h2 {font-family: helvetica,arial,sans-serif; font-weight: normal; color: black; margin-bottom: 10; margin-top: 30pt; font-size: 16pt;} \n" +
".h3 {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 10; margin-top: 20pt; font-size: 14pt;} \n" +
".h4 {font-family: helvetica,arial,sans-serif; font-style: italic; font-color: black;margin-bottom: 0; margin-top: 16pt; font-size: 11pt;} \n" +
".h5 {font-family: helvetica,arial,sans-serif; font-weight: normal; color: black; margin-bottom: 0; margin-top: 0; font-size: 8pt;} \n" +
".navigation {font-family: helvetica,arial,sans-serif; font-weight: bold; color: #993300; margin-bottom: 0; margin-top: 0; font-size:10pt;} \n" +
".note {font-family: helvetica,arial,sans-serif; font-size:10pt; font-weight: bold; margin-bottom: 0; margin-top: 0; } \n" +
".list1 {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; margin-left: 12pt; list-style-position: outside; } \n" +
".list2 {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; text-indent: 12pt; margin-left: 18pt; } \n" +
".list3 {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; text-indent: 18pt; margin-left: 24pt; } \n" +
".para1 {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; margin-left: 12pt; } \n" +
".para2 {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; margin-left: 18pt; } \n" +
".para3 {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; margin-left: 24pt; } \n" +
"pre {font-family: courier,couriernew,monospaced; font-size: 10pt; margin-bottom: 0; } \n" +
".refh1 {font-family: palatino,times,timesnewroman,serif; font-weight: normal; color: black;margin-bottom: 10; margin-top: 30pt; font-size: 18pt;} \n" +
".refh2 {font-family: palatino,times,timesnewroman,serif; font-weight: normal; color: black; margin-bottom: 10; margin-top: 30pt; font-size: 16pt;} \n" +
".refhead {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 4; margin-top: 15pt; font-size: 11pt;} \n" +
".tabletext {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; } \n" +
".tablehead {text-align: left;font-family: helvetica,arial,sans-serif; font-weight: bold; font-size:10pt; margin-bottom: 4; margin-top: 0; } \n" +
".text {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; } \n" +
".tip {font-family: helvetica,arial,sans-serif; font-size:10pt; font-weight: bold; margin-bottom: 0; margin-top: 0; } \n" +
".title {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black;margin-bottom: 30pt; margin-top: 16pt; font-size: 16pt;} \n" +
".toc1 {font-family: helvetica,arial,sans-serif; font-size: 11pt; font-weight: bold; margin-bottom: 0; margin-top: 30; text-indent: 20;} \n" +
".tocc {font-family: helvetica,arial,sans-serif; font-size: 11pt; font-weight: bold; margin-bottom: 0; margin-top: 7; text-indent: 20;} \n" +
".tochead1 {font-family: helvetica,arial,sans-serif; font-size: 10pt; font-weight: normal; margin-bottom: 0; margin-top: 2; text-indent: 20;} \n" +
".tochead2 {font-family: helvetica,arial,sans-serif; font-size: 10pt; font-weight: normal; margin-bottom: 0; margin-top: 2; text-indent: 40;} \n" +
".tochead3 {font-family: helvetica,arial,sans-serif; font-size: 10pt; font-weight: normal; margin-bottom: 0; margin-top: 2; text-indent: 60;} \n" +
".tocnontoc {font-family: helvetica,arial,sans-serif; font-size: 10pt; font-weight: normal; text-indent: 0;} \n" +
".tocpart {font-family: helvetica,arial,sans-serif; font-size:13pt; font-weight: bold; margin-bottom: 0; margin-top: 20;} \n" +
".update {text-align: right; font-family: helvetica,arial,sans-serif; font-size:8pt; margin-bottom: 0; margin-top: 0;} \n" +
"</style>";
var OtherStyle = "<style name=NOTWINDOWS>\n" +
"body,p {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; } \n" +
"th,tr,td,br,li,dl,dd,ul,ol,li {font-family: helvetica,arial,sans-serif; font-size:12pt; } \n" +
".bartext {font-family: helvetica,arial,sans-serif; font-weight: bold; color: #666666; margin-bottom: 0; margin-top: 0; font-size:17pt;} \n" +
".callout {font-family: helvetica,arial,sans-serif; font-size: 10pt;} \n" +
".calloutlarge {font-family: helvetica,arial,sans-serif; font-size: 11pt;} \n" +
".calloutlargebold {font-family: helvetica,arial,sans-serif; font-size: 11pt; font-weight: bold;} \n" +
".calloutsmall {font-family: helvetica,arial,sans-serif; font-size: 8pt; font-weight: normal;} \n" +
".caption {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 5; margin-top: 0; font-size: 13pt;} \n" +
".caution {font-family: helvetica,arial,sans-serif; font-size:12pt; font-weight: bold; margin-bottom: 0; margin-top: 0; } \n" +
"code {font-family: courier,couriernew,monospaced; font-size: 12pt; margin-bottom: 0; margin-bottom:0; margin-top: 0;} \n" +
".copy {align: center; font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 0; margin-top: 0;} \n" +
".footnote {font-family: helvetica,arial,sans-serif; font-size:12pt; } \n" +
".gloss {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; } \n" +
".grouptitleix {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 10; margin-top: 20pt; font-size: 17pt;} \n" +
".h1 {font-family: helvetica,arial,sans-serif; font-weight: normal; color: black; margin-bottom: 0; margin-top: 30pt; font-size: 22pt;} \n" +
".h2 {font-family: helvetica,arial,sans-serif; font-weight: normal; color: black; margin-bottom: 10; margin-top: 30pt; font-size: 19pt;} \n" +
".h3 {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 10; margin-top: 20pt; font-size: 17pt;} \n" +
".h4 {font-family: helvetica,arial,sans-serif; font-style: italic; font-color: black;margin-bottom: 0; margin-top: 16pt; font-size: 14pt;} \n" +
".h5 {font-family: helvetica,arial,sans-serif; font-weight: normal; color: black; margin-bottom: 0; margin-top: 0; font-size: 10pt;} \n" +
".navigation {font-family: helvetica,arial,sans-serif; font-weight: bold; color: #993300; margin-bottom: 0; margin-top: 0; font-size:12pt;} \n" +
".note {font-family: helvetica,arial,sans-serif; font-size:12pt; font-weight: bold; margin-bottom: 0; margin-top: 0; } \n" +
".list1 {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; margin-left: 12pt; list-style-position: outside; } \n" +
".list2 {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; text-indent: 12pt; margin-left: 18pt; } \n" +
".list3 {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; text-indent: 18pt; margin-left: 24pt; } \n" +
".para1 {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; margin-left: 12pt; } \n" +
".para2 {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; margin-left: 18pt; } \n" +
".para3 {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; margin-left: 24pt; } \n" +
"pre {font-family: courier,couriernew,monospaced; font-size: 12pt; margin-bottom: 0; } \n" +
".refh1 {font-family: palatino,times,timesnewroman,serif; font-weight: normal; color: black;margin-bottom: 10; margin-top: 30pt; font-size: 22pt;} \n" +
".refh2 {font-family: palatino,times,timesnewroman,serif; font-weight: normal; color: black; margin-bottom: 10; margin-top: 30pt; font-size: 19pt;} \n" +
".refhead {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 4; margin-top: 15pt; font-size: 13pt;} \n" +
".tabletext {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; } \n" +
".tablehead {text-align: left;font-family: helvetica,arial,sans-serif; font-weight: bold; font-size:12pt; margin-bottom: 4; margin-top: 0; } \n" +
".text {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; } \n" +
".tip {font-family: helvetica,arial,sans-serif; font-size:12pt; font-weight: bold; margin-bottom: 0; margin-top: 0; } \n" +
".title {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black;margin-bottom: 30pt; margin-top: 16pt; font-size: 19pt;} \n" +
".toc1 {font-family: helvetica,arial,sans-serif; font-size: 13pt; font-weight: bold; margin-bottom: 0; margin-top: 30; text-indent: 20;} \n" +
".tocc {font-family: helvetica,arial,sans-serif; font-size: 13pt; font-weight: bold; margin-bottom: 0; margin-top: 7; text-indent: 20;} \n" +
".tochead1 {font-family: helvetica,arial,sans-serif; font-size: 12pt; font-weight: normal; margin-bottom: 0; margin-top: 2; text-indent: 20;} \n" +
".tochead2 {font-family: helvetica,arial,sans-serif; font-size: 12pt; font-weight: normal; margin-bottom: 0; margin-top: 2; text-indent: 40;} \n" +
".tochead3 {font-family: helvetica,arial,sans-serif; font-size: 12pt; font-weight: normal; margin-bottom: 0; margin-top: 2; text-indent: 60;} \n" +
".tocnontoc {font-family: helvetica,arial,sans-serif; font-size: 12pt; font-weight: normal; text-indent: 0;} \n" +
".tocpart {font-family: helvetica,arial,sans-serif; font-size:15pt; font-weight: bold; margin-bottom: 0; margin-top: 20;} \n" +
".update {text-align: right; font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 0; margin-top: 0;} \n" +
"</style>";
if ( client.indexOf("win") != -1 ){
document.write( WinStyle );
}else{
document.write( OtherStyle );
}
// End hiding -->
</script>
</head>
<body text="#000000" link="#666699" vlink="#666699" alink="#333366" bgcolor="#FFFFFF">
<!--maincontent defines everything between the body tags -->
<!--start maincontent-->
<!--navigationcontent defines the top row of links and the banner -->
<!--start navigationcontent-->
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td><table border="0" cellspacing="0" cellpadding="0">
<tr>
<td valign="bottom" width="67">
<img src="netscape48.gif" height="48" width="48" border="0" alt="Netscape logo" />
</td>
<td valign="middle">
<span class="bartext"> <br />Guide to Customizing and Distributing Mozilla 1.4.1
</span>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<hr size="4" noshade="noshade" />
<span class="navigation">
<a style="text-decoration: none" href="config_cck.htm">
Previous
</a>
</span>
&nbsp;&nbsp;&nbsp;&nbsp;
<span class="navigation">
<a style="text-decoration: none" href="guide.html">
Contents
</a>
</span>
&nbsp;&nbsp;&nbsp;&nbsp;
<span class="navigation">
<a style="text-decoration: none" href="browser_cck.htm">
Next
</a>
</span>
&nbsp;&nbsp;&nbsp;&nbsp;
</td>
</tr>
</table>
<!--end navigationcontent-->
<!--bookcontent defines the actual content of the file, sans headers and footers -->
<!--start bookcontent-->
<blockquote>
<br />
<p class="title">
<a name="14432"> </a>
<a name=""> </a>
<font color="#666666">
Chapter&#32;4
&nbsp;
</font>
<a name="14434"> </a>
<a name="Preparing Platform and Installer Information"> </a>
Preparing Platform and Installer Information
</p><p class="text">
<a name="14300"> </a>
The second and third screens presented by the CCK tool allow you to choose a platform and specify other basic information about your installer.
</p>
<p class="text">
<a name="14476"> </a>
This chapter describes the information you need to prepare for these initial screens. It contains these sections:
</p>
<p class="text">
<a name="14301"> </a>
<a href="info_cck.htm#14302" >Deciding What Kinds of Installers to Create</a><br /><a href="info_cck.htm#14312" >Choosing a Company Identifier</a><br /><a href="info_cck.htm#15268" >Checklist for Platform and Installer Screens</a>
</p>
<p class="h1">
<a name="15473"> </a>
<a name="Specifying a Platform"> </a>
Specifying a Platform
<hr size="2" noshade="noshade" />
</p>
<p class="text">
<a name="15474"> </a>
The CCK tool can generate an installer for use on Windows or Linux. It's also possible to create a Macintosh installer by replacing some of the standard Macintosh installation files with the equivalent installation files produced for a Windows installer.
</p>
<p class="h2">
<a name="15564"> </a>
<a name="Windows"> </a>
Windows
</p>
<p class="text">
<a name="15559"> </a>
No special preparation is required to create a Windows installer. You simply select Windows from the drop-down list on the second screen of the CCK tool, called Specify Platform Information, and proceed through the other screens.
</p>
<p class="text">
<a name="15847"> </a>
The Windows installation files produced by the CCK tool will run on the following Windows platforms:
</p>
<ul>
<li>
Windows NT
<a name="15848"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Windows 95
<a name="15853"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Windows 98
<a name="15854"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Windows 2000
<a name="15855"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Windows ME
<a name="15856"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Windows XP
<a name="15857"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ul>
<p class="h2">
<a name="15573"> </a>
<a name="Linux"> </a>
Linux
</p>
<p class="text">
<a name="15506"> </a>
To prepare a Linux installer, you should first download a Mozilla 1.4.1 Linux tar file to some convenient location. The tar file you should download is named <code>mozilla-i686-pc-linux-gnu-sea.tar.gz</code>.
</p>
<p class="text">
<a name="16147"> </a>
After you choose Linux as the platform for the current configuration on the second screen of the CCK tool, called Specify Platform Information, you can specify that location in the field provided.
</p>
<p class="text">
<a name="15595"> </a>
You need to specify the location of the Linux tar file only once. After you do so, the CCK tool creates a directory <code>CCKTool\nscpxpiLinux\</code> and stores the decompressed standard Linux installation files there.
</p>
<p class="text">
<a name="15905"> </a>
If you decide later that you want the CCK tool to start fresh with a Linux tar file, you must delete the directory <code>CCKTool\nscpxpiLinux\</code> and its contents. The next time you run the CCK tool, you will again be able to specify the location of the Linux tar file.
</p>
<p class="text">
<a name="15511"> </a>
In addition to downloading a Mozilla 1.4.1 Linux tar file, you must have GNU Tools for Microsoft Windows (the Cygnus toolkit) installed on the system before running the CCK tool. You can obtain the Cygnus toolkit from <a href="http://www.cygwin.com/"><code>http://www.cygwin.com/</code></a>. You must also make sure that the path to the binaries for the Cygwin Unix programs is included in the Windows environment variable called PATH. To check the PATH variable, open the System control panel and click the Environment tab.
</p>
<p class="text">
<a name="15608"> </a>
After you click the Build Installer button on the last screen of the CCK tool, the tool provides the customized Linux build as a tar file in
</p>
<dl><dl><p>
<code>
<a name="15727"></a>
CCKTool\Configs\<em>my_config</em>\Output
</code>
</p></dl></dl><p class="text">
<a name="15729"> </a>
You can then transfer this tar file to a Linux system and then extract the contents for testing.
</p>
<p class="text">
<a name="15710"> </a>
After you extract the contents of the tar file, you must also change the permission of the file <code>mozilla-installer-bin</code> to include executable permission. You can then run the install script by typing <code>./mozilla-installer</code>.
</p>
<p class="h2">
<a name="15509"> </a>
<a name="Macintosh"> </a>
Macintosh
</p>
<p class="text">
<a name="15613"> </a>
To prepare Macintosh installers, you first use the CCK tool to create a Windows installer, then follow the instructions in <a href="mac_linux_cck.htm#13833" >Chapter&#32;13 "Preparing Macintosh Installers and Program Files</a>."
</p>
<p class="h1">
<a name="14302"> </a>
<a name="Deciding What Kinds of Installers to Create"> </a>
Deciding What Kinds of Installers to Create
<hr size="2" noshade="noshade" />
</p>
<p class="text">
<a name="14321"> </a>
The CCK tool lets you create two types of installers:
</p>
<ul>
<li>
CD-based installers, for distributing Mozilla to your users on a CD
<a name="14489"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Network-downloadable installers that users can download from your network, and then install Mozilla on their hard disks.
<a name="14497"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ul>
<p class="text">
<a name="14665"> </a>
The advantages and disadvantages of each type of installer are described in the sections that follow.
</p>
<p class="h2">
<a name="14666"> </a>
<a name="Providing a CD-Based Installer"> </a>
Providing a CD-Based Installer
</p>
<p class="text">
<a name="14667"> </a>
Distributing your Mozilla installer on a CD has these advantages:
</p>
<ul>
<li>
It's the best way to distribute Mozilla to users who don't have Internet access or who are new to the web.
<a name="14538"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
It's convenient; all the software users need to get started is included on the CD.
<a name="14542"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
When a user inserts the CD in a CD-ROM drive, the CD autorun screen automatically appears, simplifying installation.
<a name="14539"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
You can customize the CD autorun screen to make it easy for users to install any other software you want to include on the CD along with Mozilla.
<a name="14557"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
You can customize the CD autorun screen to promote your company's products, services, and brand identity.
<a name="14567"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ul>
<p class="text">
<a name="14335"> </a>
The main disadvantage of distributing Mozilla on a CD is you may need to update and re-distribute the CD as newer versions become available.
</p>
<p class="h3">
<a name="14337"> </a>
<a name="User Experience of CD-Based Installation"> </a>
User Experience of CD-Based Installation
</p>
<p class="text">
<a name="14339"> </a>
If you've chosen to include the CD autorun screen with your CD-ready installer, it automatically launches when the user inserts the CD. The user can then follow the instructions on the CD autorun screen to install your customized version of Mozilla.
</p>
<p class="text">
<a name="14712"> </a>
If you've customized the CD autorun screen, either by using the CCK tool or by making manual customizations (as described in Manually Customizing the CD Autorun Screen), users will see your customized CD autorun screen instead of the standard one.
</p>
<p class="text">
<a name="14344"> </a>
If for some reason the CD autorun screen is included with the installer but doesn't automatically appear when the user inserts the CD, the user must double-click the <code>setup.exe file</code> (Windows) or Mozilla Installer file (Macintosh) located at the CD root to launch the CD autorun screen.
</p>
<p class="text">
<a name="14656"> </a>
If you've chosen not to include the CD autorun screen, the user must double-click the <code>setup.exe</code> file (Windows) or the Mozilla Installer file (Mac OS 9) located at the CD root to launch the Mozilla installer.
</p>
<p class="text">
<a name="16049"> </a>
For Mac OS X, the customized files do not require installation: the user simply copies them to a convenient location and double-clicks the Mozilla application icon to launch Mozilla.
</p>
<p class="text">
<a name="15006"> </a>
To run the Linux installer, the user must run the install script by typing the command <code>./mozilla-installer</code>.
</p>
<p class="h2">
<a name="14350"> </a>
<a name="Providing a Network-Downloadable Installer"> </a>
Providing a Network-Downloadable Installer
</p>
<p class="text">
<a name="14352"> </a>
If you distribute your Mozilla installer over a network, you don't have to pay for postage, packaging, and CD duplication. Also, as new versions of Mozilla become available, you can readily provide them on your web site.
</p>
<p class="text">
<a name="14354"> </a>
Since users must already have Internet access, distributing Mozilla over a network is primarily useful for upgraders or users who want to switch to Mozilla from another web browser. Also, users must have a modem capable of transferring data at a rate of 56 Kbps or faster to keep the download time within acceptable limits.
</p>
<p class="text">
<a name="14785"> </a>
<a href="info_cck.htm#14733" >Table&nbsp;4-1</a> lists approximate download times for an installation that includes Navigator and Mail only (approximately 11 MB). Actual download times may vary.<br />
<p class="caption">
<a name="14733"> </a>
<a name=""> </a>
Table 4-1 &nbsp;&nbsp;
</p>
<br/>
<table width="90%" border="1" cellspacing="0" cellpadding="4">
<tr bgcolor="#CCCCCC" align="left" valign="top">
<th valign="top" align="left">
<p class="tablehead">
<a name="14812"> </a>
Transfer speed (in Kbits/second)
</p>
</th>
<th valign="top" align="left">
<p class="tablehead">
<a name="14814"> </a>
Transfer rate
</p>
</th>
<th valign="top" align="left">
<p class="tablehead">
<a name="14743"> </a>
Download time (in minutes)
</p>
</th>
</tr>
<tr>
<td valign="top">
<p class="tabletext">
<a name="14745"> </a>
28.8 Kbps
</p></td>
<td valign="top">
<p class="tabletext">
<a name="14747"> </a>
4.86 minutes/MB
</p></td>
<td valign="top">
<p class="tabletext">
<a name="14749"> </a>
53.4 minutes
</p></td>
</tr>
<tr>
<td valign="top">
<p class="tabletext">
<a name="14751"> </a>
36.6 Kbps
</p></td>
<td valign="top">
<p class="tabletext">
<a name="14753"> </a>
3.82 minutes/MB
</p></td>
<td valign="top">
<p class="tabletext">
<a name="14755"> </a>
42.01 minutes
</p></td>
</tr>
<tr>
<td valign="top">
<p class="tabletext">
<a name="14757"> </a>
56 Kbps
</p></td>
<td valign="top">
<p class="tabletext">
<a name="14759"> </a>
2.47 minutes/MB
</p></td>
<td valign="top">
<p class="tabletext">
<a name="14888"> </a>
27.1 minutes
</p></td>
</tr>
<tr>
<td valign="top">
<p class="tabletext">
<a name="14763"> </a>
64 Kbps ISDN
</p></td>
<td valign="top">
<p class="tabletext">
<a name="14765"> </a>
2.2 minutes/MB
</p></td>
<td valign="top">
<p class="tabletext">
<a name="14767"> </a>
24.2 minutes
</p></td>
</tr>
<tr>
<td valign="top">
<p class="tabletext">
<a name="14769"> </a>
128 Kbps ISDN
</p></td>
<td valign="top">
<p class="tabletext">
<a name="14771"> </a>
1.09 minutes/MB
</p></td>
<td valign="top">
<p class="tabletext">
<a name="14773"> </a>
11.9 minutes
</p></td>
</tr>
<tr>
<td valign="top">
<p class="tabletext">
<a name="14775"> </a>
144 Kbps DSL/Cable modem
</p></td>
<td valign="top">
<p class="tabletext">
<a name="14777"> </a>
.97 minutes/MB
</p></td>
<td valign="top">
<p class="tabletext">
<a name="14779"> </a>
10.6 minutes
</p></td>
</tr>
</table>
</p>
<p class="text">
<a name="14368"> </a>
To distribute a network-downloadable installer, you'll need to set up an FTP (File Transfer Protocol) site so users can download the Mozilla installer from your site. You'll also need to tell users where to find the installer and provide them with instructions for downloading it.
</p>
<p class="h3">
<a name="14370"> </a>
<a name="User Experience of Network-Downloadable Installer (Windows)"> </a>
User Experience of Network-Downloadable Installer (Windows)
</p>
<p class="text">
<a name="14372"> </a>
To install Mozilla on Windows, a user
</p>
<ol type="1">
<li value="1">
Launches another browser or FTP program and downloads a small (300 Kbytes) installer program (<code>Setup.exe</code>) from your FTP site to the user's hard disk.
<a name="14374"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="2">
Double-clicks the <code>Setup.exe</code> program to begin the installation process. The <code>Setup.exe</code> program displays a series of screens that guide the user through the entire installation process.
<a name="15027"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="3">
During the installation process, the installer downloads the necessary Mozilla component files from your FTP site and installs them on the user's machine. While downloading is in progress, the user can pause the download process and resume the download later.
<a name="15066"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="4">
When the installation is complete, Mozilla launches.
<a name="14380"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ol>
<p class="h3">
<a name="15951"> </a>
<a name="User Experience of Network Downloadable Installer (Linux)"> </a>
User Experience of Network Downloadable Installer (Linux)
</p>
<p class="text">
<a name="16040"> </a>
To install Mozilla on Linux, a user
</p>
<ol type="1">
<li value="1">
Launches another browser or FTP program and downloads a small (300 Kbytes) installer program (<code>mozilla-installer-bin</code>) from your FTP site to the user's hard disk.
<a name="15960"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="2">
Runs the install script by typing the command <code>./mozilla-installer</code>.
<a name="15961"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="3">
During the installation process, the installer downloads the necessary Mozilla component files from your FTP site and installs them on the user's machine. While downloading is in progress, the user can pause the download process and resume the download later.
<a name="15962"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="4">
When the installation is complete, Mozilla launches.
<a name="15963"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ol>
<p class="h3">
<a name="15230"> </a>
<a name="User Experience of Network Downloadable Installer (Macintosh)"> </a>
User Experience of Network Downloadable Installer (Macintosh)
</p>
<p class="text">
<a name="14385"> </a>
To install Mozilla on Mac OS, a user
</p>
<ol type="1">
<li value="1">
Launches another browser or FTP program and downloads a single self-extracting archive that contains all the installation files.
<a name="14388"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="2">
Double-clicks the downloaded file called Mozilla 1.4.1 Installer to begin the installation process. The installer program displays a series of screens that guides the user through the entire installation process.
<a name="14390"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="3">
When installation is complete, users must double-click the Mozilla application icon (or its alias) to launch Mozilla.
<a name="14392"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ol>
<p class="h1">
<a name="14312"> </a>
<a name="Choosing a Company Identifier"> </a>
Choosing a Company Identifier
<hr size="2" noshade="noshade" />
</p>
<p class="text">
<a name="15313"> </a>
The only required item on the Gathering Information screen is your company identifier for the user agent string. The user agent string helps identify the browser type whenever the browser accesses your web site or any other web site. Your identifier in the user agent string allows your company (or others) to track the number of times Internet web sites are accessed by web browsers that you've customized.
</p>
<p class="text">
<a name="15314"> </a>
The identifier you supply can be up to 10 characters in length.
</p>
<p class="text">
<a name="16021"> </a>
For example, if you enter <code>MyISP</code> in the Company Identifier field, the resulting user agent string would look like this:
</p>
<dl><dl><p>
<code>
<a name="16027"></a>
Mozilla/5.0 (Windows; U; WinNT4.0; en-US; rv:0.9.4)
Gecko/20010913 (CK-MyISP)
</code>
</p></dl></dl><p class="text">
<a name="16023"> </a>
If you are preparing several different customized versions of Mozilla, you may want to supply a different user agent string for each one.
</p>
<p class="h1">
<a name="15268"> </a>
<a name="Checklist for Platform and Installer Screens"> </a>
Checklist for Platform and Installer Screens
<hr size="2" noshade="noshade" />
</p>
<p class="text">
<a name="15640"> </a>
The Specify Platform Information Screen specifies:
</p>
<ul>
<li>
Whether you want the CCK tool to generate a Windows or a Linux installer.
<a name="15641"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
The location of the standard Linux tar file for Mozilla 1.4.1 (if you select Linux as the platform).
<a name="15642"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ul>
<p class="text">
<a name="15269"> </a>
The Gathering Information screen specifies:
</p>
<ul>
<li>
Whether you want a CD autorun screen.
<a name="15279"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
The FTP URL for an network-ready installer (if any).
<a name="15280"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
The company identifier to be included in the user agent string for your customized Mozilla (recommended).
<a name="15281"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ul>
<p class="text">
<a name="15275"> </a>
Make sure you have this information available when you run the CCK tool.
</p>
</blockquote>
<!--end bookcontent-->
<!--footercontent defines the bottom navigation and the copyright. It also includes
the revision date-->
<!--start footercontent-->
<blockquote>
<br />
<br />
<span class="navigation">
<a style="text-decoration: none" href="config_cck.htm">
Previous
</a>
</span>
&nbsp;&nbsp;&nbsp;&nbsp;
<span class="navigation">
<a style="text-decoration: none" href="guide.html">
Contents
</a>
</span>
&nbsp;&nbsp;&nbsp;&nbsp;
<span class="navigation">
<a style="text-decoration: none" href="browser_cck.htm">
Next
</a>
</span>
&nbsp;&nbsp;&nbsp;&nbsp;
<hr noshade="noshade" size="1" />
<p class="copy">Copyright &#169; 2003 Netscape Communications Corp. All rights reserved.</p>
<br />
<p class="update">Last Updated <b>July 30, 2003</b></p>
</blockquote>
<!--end footercontent-->
<!--end maincontent-->
</body>
</html>