Copyright: Copyright © 1997-2004 PalmSource, Inc. or its subsidiaries. All rights reserved. Document number 5068-002.
Citation: Copyright © 1997-2004 PalmSource, Inc. or its subsidiaries. All rights reserved. Document number 5068-002.


Install Tool Overview

Your handheld comes with applications already installed, but with Install Tool you can add even more, like games, dictionaries, travel guides, and maps. You can also install other kinds of files, like photos, audio and video files, and documents. Applications and files are easy to install by adding them to Install Tool and then performing a HotSync® operation.

You can find applications that make the most of your Palm Powered™ handheld from the thousands available at www.palmsource.com/software.

With Install Tool, you can install applications or files on your handheld or on a Palm OS® compatible expansion card that plugs into your handheld. The files you can install depend on the file type as described below:

Standard Palm OS  file types	Examples are Palm OS applications (PRC) and databases (PDB, SDB, SSD).
File types registered by handheld applications	Applications on your handheld register for the desktop files types that they can read. For example, the Memo Pad application on Palm OS Cobalt handhelds registers for TXT files, so you can install a TXT file on the handheld using Install Tool and read it with Memo Pad. Other applications may register for other file types—for example, a photo viewer for JPG files, a media player for MP3 files, and so on. Note   If no handheld application is registered for a particular file type, then you cannot install files of that type. If the file failed to install on the handheld, an error message is written to your handheld’s HotSync log. If the file failed to install on an expansion card, then an error message is written to the HotSync log on your desktop computer.  On a Palm OS Garnet or earlier handheld, Install Tool can install only certain standard Palm OS file types. If your Palm OS Garnet or earlier handheld has an expansion slot, then you can install these same standard file types on a card; you can install additional file types on a card, but only if an application on your handheld is registered to handle them. Refer to the documentation that comes with the application to see what types of files on an expansion card that it enables you to use.
Applications or files that you install on your handheld are different from the applications that come pre-installed on your handheld. Applications, files, and information you store on your handheld reside in RAM (random access memory). If you hard-reset your handheld, the applications you have installed will be deleted. Applications or files that you install on an expansion card are stored there until you remove them; these files are not deleted if you hard-reset your handheld.

What do you want to do?

    Install an application or file on my handheld

    Find and download Palm OS applications from www.PalmSource.com

    Read Expert Guides about the kinds of applications that match my interests

    Troubleshoot problems using Install Tool

    Find the Palm OS version on my handheld


Installing Applications or Files

Use Install Tool to select applications or files to install during the next HotSync® operation.

Notes

•	Before installing applications or files on a Palm OS® compatible expansion card, you must register each card with HotSync Manager. To register an expansion card, connect the card to your handheld and perform a HotSync operation. Once each card is registered, you do not need to repeat this process prior to installing additional items.

•	If no handheld application is registered for a particular file type, then you cannot install files of that type.

To use Install Tool

Open the Install Tool dialog box using one of the following methods:

•	Click the Install button on the Palm OS Desktop application’s Launch Bar.

•	Click the Start button, highlight Programs, highlight Palm OS Desktop, and select Install Tool.

To select applications or files to install

1.	In the Install Tool dialog box, click the User selector and select the correct user from the list.

2.	Click Add.

3.	In the Open dialog box, select the item(s) to install.

4.	Click OK.

5.	When the Install Tool dialog box reappears, check the location in the Destination column.

6.	If necessary, change the destination by clicking Change Destination, indicating where you want to install the items in the Change Destination dialog box, and then clicking OK.

Tips:

•	Click the Install To selectors to choose the destination for the items in the list below that selector.

•	To move an item from one list to the other, click the item and then click the arrow pointing to the other list.

7.	Click Done.

To remove applications or files from the Install list

1.	Click the item(s) in the Install list.

2.	Click Remove.

3.	Click Done.


Removing Applications or Files Installed on a Handheld

You can remove applications or files that you have installed on your handheld, but you do not use Install Tool to do it. Instead you remove them using your handheld.

To remove an application that you installed on your handheld or on an expansion card

1.	Turn on your handheld and go to the Applications Launcher. (On most handhelds, tap the home icon.)

2.	Tap the Menu icon.

3.	From the App menu, choose Delete.

4.	If the application you want to remove is on an expansion card, tap next to Delete From and choose the name of the expansion card. If the application is on the handheld, leave Delete From set to Handheld.

5.	Tap the down arrow until you see the name of the application you want to remove. Then tap the application name.

6.	Tap the Delete button. When the handheld asks whether you want to delete the application, tap Yes.

Note   The application is removed from your handheld along with any information that you created using the application.

Tip   To delete files that you installed on your handheld or on an expansion card, you must use the application that uses files of that type.


Install Tool Dialog Box

Use the Install Tool dialog box to choose files to install on your handheld or on a Palm OS® compatible expansion card during the next HotSync® operation.

User	Click the User selector and select the user name associated with the handheld or expansion card where you want to install an application or file.
Pending install list	View a list of the applications or files that will be installed during the next HotSync operation. The Destination column indicates whether the item will be installed on your handheld or on an expansion card.
Change Destination	Click the Change Destination button to display the Change Destination dialog box where you can select whether items will be installed on your handheld or on an expansion card.
Add	Click the Add button to display the Open dialog box where you can select items to install.
Remove	Click an application or file in the Pending Install list, and then click the Remove button to remove the selected applications or files from the list of items to install.


Change Destination Dialog Box

Use the Change Destination dialog box to choose where you want to install applications or files during the next HotSync® operation.

Install To	Click the Install To selector and select the location where you want to install applications or files listed below the selector.  Note   If your handheld has only one expansion card, the Install To selectors are disabled. In this case items in the list on the left are installed on your handheld and items in the list on the right are installed on the expansion card.
Pending install list	View a list of the applications or files that will be installed during the next HotSync operation. The Install To selector indicates whether the items will be installed on your handheld or on an expansion card.
Arrows	Click the arrow buttons to move items between the two Install To lists.


Troubleshooting Install Tool Problems

Why do files remain in the Install list after a HotSync® operation?

Files that remain in the list after you perform a HotSync operation did not install on the handheld. HotSync Manager on your desktop computer adds a message to the HotSync log that explains the problem. If this happens, here are some likely reasons:

•	Your handheld ran out of memory. Review the HotSync log for more information.

•	The file type was not recognized by your handheld. This can happen when your handheld has an expansion slot and therefore can support applications that use file types other than Palm OS® application files. However, your handheld cannot recognize another file type until you start the application that uses such a file type at least once. On your handheld, start the application that uses the file type, and then repeat the steps to install the files.

Why are files removed from the Install list after a HotSync operation but are not installed on my handheld?

Files whose destination is set to Handheld cannot be installed on the handheld if no application is registered to accept files of that type. If this happens, a message is written to the HotSync log on your handheld that confirms which files could not be installed. To correct this problem, try the following:

•	Be sure that you have an application on your handheld that can read the type of file you want to install. See the documentation that came with your handheld or that came with the application you want to use.

•	Check that the type of the file is what you expect. The filename extension indicates the type of file, but it might not be exactly what a handheld application can accept. For example, if the handheld application that you want to use can read only JPG files, but your file is named photo.JPEG, then change the filename to photo.JPG. Try installing the renamed file.

Why do some files that I install on my handheld not get backed up?

Files of types other than the standard Palm OS file types do not get backed up during the same HotSync operation in which you install them on your handheld. After they are successfully installed, the data in them is backed up or synchronized during the next HotSync operation. Files that you install on an expansion card are not backed up.

What types of files can I install on my handheld?

On Palm OS Cobalt handhelds you can install these standard Palm OS file types:

•	PRC ¯ applications

•	PDB, SDB, SSD ¯ databases

Install Tool allows you to install files of other types on a Palm OS Cobalt handheld and on an expansion card, but only if an application on the handheld can read them. If there is no such application, then the file is not installed.

On Palm OS Garnet or earlier handhelds you can install these standard Palm OS file types:

•	PRC ¯ applications

•	PDB ¯ databases

•	PQA ¯ query applications (web clippings)

•	SCP ¯ network scripts

•	PNC ¯ network configuration

Install Tool does not allow you to install files of other types on a Palm OS Garnet or earlier handheld. However, you can install files of these and other types on an expansion card in such a handheld, but only if an application on the handheld can read them.

    Finding the Palm OS Version on Your Handheld


Copyright and Trademarks

Copyright © 1997-2004 PalmSource, Inc. All rights reserved. PalmSource, HotSync, the HotSync logo, Palm OS, and Palm Powered are trademarks of PalmSource, Inc. or its affiliates. All other product and brand names may be trademarks or registered trademarks of their respective owners.