cc/td/doc/product/access/faststep
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Custom Software Installation

Custom Software Installation

This chapter describes the mechanics of creating a custom Cisco 800 Fast Step CD-ROM, modifying the application window help files, changing the splash screen bitmaps, and providing Belle System support.

Making a Custom Cisco 800 Fast Step CD-ROM

You can customize the wizard so that the end user builds the configuration you want, or you can provide a custom configuration file, placed in a country directory from which the end user can select the file.

The Cisco 800 Fast Step CD-ROM contains Cisco 800 Fast Step software. The Installshield installation wizard displays the default language of the Windows operating system. The first screen of the installation application asks the user which language to use for installation, and the corresponding language for Cisco 800 Fast Step is installed.

Customize the Wizard

When it is launched, the Setup wizard looks for the autoload.CFG file and display screens and builds a configuration based on the parameters the file allows. One advantage of this method is that you can reduce the number of options available to the end user, yet allow the end user to configure the router by using the wizard.

To build a CD with a customized wizard:


Step 1 Make a directory on your hard drive, and copy the contents of the Cisco 800 Fast Step CD into the directory. (Maintain the same directory structure.)

Step 2 Draft a Cisco 800 Fast Step filename.CFG file as described in the "CFG File Development" chapter. (TPL files do not work.)

Step 3 Rename the filename.CFG file autoload.CFG.

Step 4 Copy the autoload.CFG file to the root directory.

Step 5 Burn a new CD-ROM by using the files on your hard disk.


This new installation automatically starts with the settings you created. When the CD is placed into the drive, Windows looks in the autorun.inf file to determine which language to run.

Provide a Custom Configuration

You can provide the user with a selection of configuration files. When Cisco Fast Step starts, it verifies that the country of installation, as indicated by the country.DAT file, is present as a directory below the ServiceProvider directory. In addition, a configuration file must be present under the country name directory. Thus, it is only when the country is present as a directory in the ServiceProvider directory (below the Cisco 800 Fast Step installation directory) and it contains at least one configuration file that the Service Provider Selection feature is enabled.

You can develop multiple ISP configuration files. For example, you could develop four configuration files named ISPBOB.CFG, ISPCAROL.CFG, ISPTED.CFG, and ISPALICE.CFG.

Your procedure for this example is as follows:


Step 1 Use Setup to draft the base configuration.

Step 2 Save the generic CFG file by using the Save File As window.

Step 3 Open the CFG file in a text editor.

Step 4 Change the parameters to the custom configurations.

Step 5 Save the first file as ISPBOB.CFG, and repeat the process for the other files.

Step 6 Place the CFG files in the ServiceProvider\countryname directory.

Step 7 Burn a new CD-ROM by using the files on your hard disk.


The result is that end users cable their routers, run Setup, select the ISP file, and they are done.

Cisco 800 Fast Step Installation Directory Structure

The file and directory structure is the same for each language:

The installation program copies the files and subdirectories from the Third Party Software directory on the installation CD-ROM into the Third Party Software directory on the installation hard drive, below the Cisco 800 Fast Step installation directory. You can add any third-party software to the installation by placing the desired files in the Third Party Software directory of the CD-ROM.

Changing Bitmaps

The install bitmap is the first graphic the user sees when the applications are launched. It is named setup.bmp and is always in the disk1 directory. You can edit it, for example to add your own logo, by using any application that manipulates BMP files. You must keep the same filename and the same 256-color Windows bitmap format. If you want Cisco 800 Fast Step to fit onto floppy disks, the graphic must be the same size or smaller than the original.

Cisco insists that you keep the following:

Cisco recommends that you keep the following:

Customizing On-Screen Help Messages

When Cisco 800 Fast Step software is launched, it reloads the on-screen message help before showing the user the first (Welcome) window. You can change the help messages to suit your needs. Three types of help messages are used in Setup:

It is possible to localize Cisco 800 Fast Step into a language not currently available; however, this does require programming knowledge and some assistance from Cisco Systems. Please e-mail the following alias for more details: cs-faststep@cisco.com

RTF Text Blocks

The error messages, tool tips, and on-screen help are controlled by using an RTF file. (The Monitor does not control tool tips, on-screen help, or error messages using editable RTF files.) The file is named 1600All_RTF.RTF.

The tool tips, on-screen help text, and error messages are delimited into text blocks. The following are examples of on-screen blocks of help text:

RTFID_2210
Connection Type Window Allows Setup to change the network settings on your PC to match the setting on the router. Select Use the network to automatically change the settings. Select Console Cable to keep your current settings and manually change them if necessary. RTFID_2211
Use the Network Select Use the network to automatically change the network settings on your PC to allow the router to communicate with the PC through the LAN.

The help text-block format is as follows:

The tool tips and error messages are spread throughout the file and are identified by the syntax of the message. Help text associated with the windows are identified by the window name and typically end with the word "window" (or equivalent in the localized versions). The help text for each supported field within a window immediately follows the help text for the window in which the field appears.

RTF Text Edits

The help messages filename is 1600All_RTF.RTF, and you can edit the RTF file with Microsoft Word, a word processing application, or WordPad, a utility that comes with Microsoft Windows. Both applications edit the file as a native format.

You can use any character or formatting that Microsoft Word or WordPad support, including non-English characters and font changes. The default font and size is Ariel 9-point.


Note Microsoft Word 97 (with or without Service Pack 1) does not save RTF files in a backward-compatible format. If you edit the files by using Microsoft Word 97, you must reload the file into WordPad and save it before Cisco 800 Fast Step can read it.

Belle Systems Provisioning

The Belle System provisioning system allows a large number of routers to be installed by the users and managed by Belle Systems software from the central site, as follows:

    1. Setup configures the PC as a DHCP client, the router as a DHCP server with PAT, and uses IPCP to find the WAN address. This enables the router to connect to the registration server but nowhere else.

    2. Setup completes the configuration process and runs an installed Web browser that points to a local HTML page or the Belle System remote registration page.

    3. The users enter their Personal Identification Number (PIN) code, personal information, and, if the router supports basic telephone service (POTS), the phone numbers of the attached telephone or fax.

    4. The registration server validates the PIN code and personal information, checks the Cisco IOS software version (and, if necessary, downloads a new version), and the router configuration.

    5. The router is rebooted. Changing the router configuration might change the dynamic host configuration protocol (DHCP) pool addresses of the router, so the PC also must be rebooted to get new IP addresses from the router. The final page of the registration server information tells the user to reboot the PC.

    6. Setup waits for a PC reboot, and, when it is successful, runs the Web browser, pointing to a local HTML file placed in the Third Party Software directory or a URL that points to the registration completion page. The remote page performs some background processing and logs the registration information into the Belle Systems provisioning system.

For this entire process to be executed from a CD-ROM that includes the Cisco 800 Fast Step software, configuration, and Web pages requires that you do the following:

Cisco does not ask any license fees for making copies of Cisco 800 Fast Step, provided the standard Cisco Systems licensing agreements are abided by.

Enabling Belle Systems Support

Belle System support loads the configuration from a remote server. The flag syntax is as follows:

[Belle Systems]
SetBelleSystemSupport=
 

If the flag value is set to 0 or blank, Belle Systems support is disabled.

If the flag value is set to 1, Belle Systems support is enabled.

Web Site Support

The Cisco Fast Step_Reset.exe program launches a Web browser and points to the Registration and Welcome Web sites of the service provider.

Registration Web Site

The registration Web site launches a local Web page. The path is relative to the Cisco 800 Fast Step installation directory. A Web browser must be installed, and it is automatically launched as a separate program. The following is an example of the flag in the CFG file:

[Belle Systems]
ISPSetupURL=http://test.cisco.com  
 

Welcome Web Site

The Welcome Web site displays after the router has been registered and configured through Belle Systems IMS+. The path is relative to the Cisco 800 Fast Step installation directory. A Web browser must be installed, and it is automatically launched as a separate program. The following is an example of the flag in the CFG file:

[Belle Systems]
ISPLocalURL=http://www.cisco.com  
 

Service Provider Instructions to End Users

The procedures in this section describe loading a CFG file and a TPL file for the end user. Although it is likely that you will modify these instructions for individual use, they provide a starting point.

End-User Instructions for CFG Files

Complete the following procedure to load a router configuration by using a Cisco 800 Fast Step CFG file:


Step 1 Cable the router as described in the Cisco 800 Fast Step Quick Reference Guide.

Step 2 Locate the instruction sheet that lists the parameters you will need to configure the router.

Step 3 Install Cisco 800 Fast Step software on a PC attached to the router by a configuration cable or connected to the same Ethernet LAN.

Step 4 Launch Cisco 800 Fast Step Setup. The Welcome window displays.

Step 5 Click Next. The Service Selection window displays.

Step 6 Verify that your country is shown in the Country field. If your country is not shown in the field, do one of the following:

Step 7 Verify that the configuration file is shown in the Service Provider list. If the file is not shown in the field, do one of the following:

Step 8 Click Next to continue, and follow the on-screen instructions to complete the configuration.


End-User Instructions for TPL Files

Complete the following procedure to load a router configuration before using a Cisco 800 Fast Step IOS template (TPL) file:


Step 1 Cable the router as described in the Cisco 800 Fast Step Quick Reference Guide.

Step 2 Locate the instruction sheet that lists the parameters you will need to configure the router.

Step 3 Install Cisco 800 Fast Step software on a PC attached to the router by a configuration cable or connected to the same Ethernet LAN.

Step 4 Launch Cisco 800 Fast Step Setup. The Welcome window displays.

Step 5 Click Next. The Service Selection window displays.

Step 6 Verify that your country is shown in the Country field. If your country is not shown in the field:

Step 7 Verify that the TPL file is shown in the Service Provider list. If the file is not shown in the field:

Step 8 Click Next to continue. The Template File Field Entry window displays.

Step 9 Complete the configuration by entering the values as shown on the instruction sheet.

Step 10 Click Next, and follow the on-screen instructions to complete the configuration.



hometocprevnextglossaryfeedbacksearchhelp
Posted: Mon May 22 16:21:10 PDT 2000
Copyright 1989 - 2000©Cisco Systems Inc.