The installation procedure that follows assumes you are installing from the PocketBuilder CD. If you are a system administrator and your site has multiple licenses, you might want to allow users to install PocketBuilder from a network drive instead. To do this, copy the files from the CD into a directory on a network drive. Users can then install PocketBuilder by running the setup program from the network.
You must have administrative privileges to fully install this product. If you are installing PocketBuilder for other users, make sure those users have write permission for the PocketBuilder 2.5 directory and the Windows registry.
The installation procedure allows you to install PocketBuilder directly to a device. To do this, you must have Microsoft ActiveSync, or WMDC for Windows Vista, installed and running on the desktop computer and on the device or emulator. The device or emulator must be connected (cradled). The setup program can also create desktop Start Menu links for deploying PocketBuilder to a device or emulator at a later time, but you must have ActiveSync or the WMDC installed for this to happen.
If you want to install PocketBuilder to a device or emulator at a later time without using the Start Menu links, you can manually copy CAB files generated by the setup program. For more information, see “Copying files to a device or emulator”.
Smartphone device and emulator considerations
For a Smartphone device with a limited amount of available
space, you might need to copy the PocketBuilder VMs manually rather
than using the Start Menu links or manually copying the CAB file.
Even if you install PocketBuilder to a mounted storage card, unpacking
the CAB file requires temporary space in the main storage area.
If you do not have a file management program on your Smartphone device or emulator, you can copy the CAB file to the \Storage\Windows\Start Menu\Accessories folder. You can then display the CAB file by selecting Accessories from the Start menu and unpack the CAB file by pressing (on the Smartphone device) or clicking (on the Smartphone emulator) the Action button.
To
install PocketBuilder:
Exit any programs that are running.
If you do not, the setup program might not be able to copy some files to the appropriate directories.
Insert the CD into your CD-ROM drive and double-click the setup.exe program from the root directory if the Sybase PocketBuilder Install wizard does not start automatically.
If you get a security warning message box on Windows 2003 or Windows Vista, click Run.
On the License Agreement page, select your country or region, read the license, select the radio button to agree to the terms of the license, and click Next.
On the Setup Type page, select Complete or Custom, accept the default folder location or browse to the folder where you want to install PocketBuilder, and click Next.
If you selected Complete for the setup type, skip to step 6. All components will be installed, and the SQL Anywhere setup program will start after PocketBuilder files are installed.
If you selected Custom, the Select Components page displays.
(Custom setup type only) Clear the check box on the Select Components page for any component that you do not want to install and click Next.
If you select a SQL Anywhere Developer Edition component in a Custom install, the setup program automatically starts the installation program for SQL Anywhere after installing PocketBuilder files.
On the Start Copying Files page, review your settings, then click Next to install the PocketBuilder files (or click Back to change your selections).
On the Deploy to the Device page, select one of the three deployment options and click Next.
The three deployment options are:
Deploy to a Pocket PC device
Deploy to a Smartphone device
Don’t deploy anything right now
If you select the option to deploy PocketBuilder to a Pocket PC or Smartphone device, the setup program copies the required files to the device or emulator, then displays the Application Downloading Complete dialog box.
If there is no device or emulator connected, the setup program installs a Windows CE setup program in the PocketBuilder 2.5\WinCE directory. This setup program is launched automatically the next time the device or emulator is connected.
If you leave the default option not to deploy to a device, and you selected the Complete setup type in step 4, or if you selected the Custom setup type in step 4 and the SQL Anywhere Developer Edition component in step 5, the SQL Anywhere 10 setup program starts. In this case, follow the directions in “Installing SQL Anywhere”.
If you leave the default option and did not select the SQL Anywhere Developer Edition component in step 5, the setup program terminates and Readme files for locating the most recent Release Bulletin and describing the PocketBuilder sample applications open on the desktop.
(Deploying to a device) Click OK at the prompt to install PocketBuilder to the default directory on the Pocket PC or Smartphone.
If a message box displays telling you there are additional actions to take on the device or emulator, click OK.
On the device or emulator, tap OK (Pocket PC) or press the Action button (Smartphone) to complete the installation.
If you selected the Custom setup type in step 4 and the SQL Anywhere Developer Edition component in step 5, the SQL Anywhere 10 setup program starts. In this case, follow the directions in “Installing SQL Anywhere”.
Otherwise, the installation is complete and ReadMe files for locating the most recent Release Bulletin and describing the PocketBuilder sample applications open on the desktop.
After the installation is complete, remove the CD from the CD-ROM drive.
You might need to restart your computer if you installed SQL Anywhere from the setup program.
If you use UltraLite 10 in the design time environment, you must copy UltraLite DLLs from the SQL Anywhere Ultralite\Win32\386\lib\vs7 directory to the main PocketBuilder directory.