Copyright: Visual J++ Setup Help
Citation: Copyright 1992-1996 Microsoft Corporation


Welcome

This Setup program helps you install Visual J++ and the Microsoft Developer Studio on your computer. You can use Setup to install from scratch or to upgrade an existing installation. If you are upgrading an installation, Setup copies only files that are new or updated, so upgrading is faster than installing from scratch. Setup also lets you tailor the installation to your needs with a variety of custom installation options. Once you have installed Visual J++, you may run Setup again at any time to install any components that you didn’t install earlier.

Getting Help

Help is available for most of the dialog boxes displayed during installation. Press F1 or the Help button (if one is displayed).

Continuing Setup

To continue running Setup, select Next, Yes, or OK, as appropriate. To review or change information you have entered during installation, use the Back button to move backward in the dialog boxes.

Cancelling Setup

You may cancel setup at any time by selecting Cancel or by pressing ESC. (The exception to this rule is the Change Directory dialog box, which uses Exit to stop Setup.) Setup displays a message box to verify that you want to stop the Setup program, and no files are copied to your hard drive.


Registration

Use this dialog box to enter your:

•	Name - up to 52 alphanumeric characters

•	Organization (or company) name - up to 52 alphanumeric characters

•	Product ID number - a 10 digit number (printed on a sticker fastened to the jewel case that contained your Visual J++ CD-ROM)

This information will appear in the “About” dialog box (under the Help menu) once Visual J++ is installed.

After you complete the fields in the Registration dialog box, pressing Next displays the Registration Confirmation dialog box.

Note   The User Name and Product ID number are required entries. The Organization name is optional.

Registration Confirmation

The Registration Confirmation dialog box lets you review and confirm the information you entered in the Registration dialog box. If this information is correct, press Yes to continue Setup. To make changes or corrections, press No; Setup returns you to the Registration dialog box.

Note   Once you have successfully run Setup, the registration information is added to your Windows registry. The only way to change this information is to  uninstall Visual J++ and reinstall.


Installation Options

Use this dialog box to choose the type of installation you want. This dialog box also has a Directory button in the lower left-hand corner that lets you access the dialog box for changing the directory to which you want the files installed.

The type of installation you choose depends on a number of factors, including the amount of space available on your computer’s hard drive, desired speed of access to Visual J++ components, and whether you are running Setup for a first-time installation or to add components not previously installed. The name of and the space available in the installation root drive and directory are displayed beneath the installation choices.

Tip   For a detailed summary of what the different setup options install on your hard drive and the space required, check the Visual J++ footprint table.

Once you have indicated the directory for installation and selected the installation type, click the Next button. Setup displays a message box to verify you are ready to begin the installation. (Unless you have selected Custom, in which case Setup displays the Custom Options dialog box to allow you to customize your installation.) Click Next again to begin copying files to your hard drive.

You can install Visual J++ in one of four ways:

•	Typical

•	Minimum

•	CD-ROM

•	Custom

Typical Installation

Select Typical to install all the tools and libraries needed to develop Java applets and applications. These include:

•	Microsoft Developer Studio

•	Internet Explorer 3.0

•	Java class libraries

•	Tools

•	All documentation files

Tip   If you want to see exactly what Typical installs, select the Custom installation option. A Custom installation begins as a Typical installation, so all of the items checked are what is installed when you select Typical.

Minimum Installation

Select Minimum to install only the development environment, Java class libraries (minus .java source files), compiler, debugger files, tools, and the Product Support Services help file (PSS.HLP).

CD-ROM Installation

Select CD-ROM to install only the development environment, Internet Explorer 3.0, and Java class libraries (minus .java source files).

Custom Installation

Select Custom to open the Custom Options dialog box and specify the components you want to install. (The items shown as already selected are the items a Typical installation would install.) You should also use this option if you are running Setup to add components to your current installation. The disk space required for this installation depends on the components selected.

Change Directory Button

Select this button to change the installation directory for Visual J++.


Change Directory

Use this dialog box to change the installation directory for Visual J++  from the default of C:\Program Files\Devstudio to a directory that you designate. Once you have made any desired changes, choose OK to save them and return to the Installation Options dialog box. Choose Cancel if you do not want to save changes made in this dialog box; choose Exit to stop the Setup program. If you choose Exit, a message box is displayed that allows you to stop Setup; no files are copied to your hard drive.

Install Directory

Use this text box to change the root directory of your installation of  Visual J++. If the directory does not already exist, Setup will create it for you.

System Files

This field displays the directory where Setup will install system files, such as DLLs.

Note   You cannot change the entries in this field.

Disk Browser

The Disk Browser displays the disk space information for the drive displayed in the Drive box. This feature allows you to quickly scan all available drives for disk space. It does not change your installation drive. You must change the drive by changing the entry in the Install Directory text box.


Custom Options

Selecting Custom in the Installation Options dialog box and clicking Next displays the Custom Options dialog box, which lists a group of options you may choose to install. A description of each option is displayed as it is selected. If an option has no suboptions, the Details button displayed beneath its description is greyed. The Microsoft Developer Studio option, for example, has no other associated options.

However, if a selected option has options of its own, the Details button will become active. Clicking the Details button or double-clicking the option will display additional dialog boxes with lists of options and their accompanying descriptions.

Note   The check boxes in the Custom Options dialog box can exhibit one of three states:

•	All (black check mark) - indicates that the option (and all suboptions) are selected for installation.

•	Some (greyed check box and check mark) - indicates that not all of the option’s suboptions are selected for installation.

•	None (no check mark) - indicates the option (and any suboptions) are not selected for installation.

For example, if you look at Java Class Libraries in the Options list, you will see that its check box and check mark are greyed. If you select Java Class Libraries, the Details button becomes active. Clicking Details brings up the next dialog box, which lists two choices, Java Class Files and Java Class File Source Code. Use the check box by each choice to select or deselect it.

To dismiss this dialog box after selecting or deselecting choices, click OK. Once you have reached the main Custom Options dialog box, click Next to continue the installation.

Resetting a Custom Installation

If, for any reason you want to reset the custom options to the default Typical settings, use the Back button to return to the Installation Options dialog box and select Typical.


Using Setup Ccommand-Line Switches
Using Setup Command-Line Switches

The Setup program includes a number of command-line switches that you may use if you run Setup either from the DOS prompt or from Run in Windows 95 or File/Run in Windows NT File Manager. These provide the following options:

/F	does not copy files to the hard drive, but creates a program group and sets up directories and registry entries. There are two reasons you might want to use this option:

•	Setup ended abnormally after all the files were copied, but before configuration changes were made to your system. You can rerun Setup /F to update the configuration.

•	For NT users who have multiple accounts or machines used by multiple users, Setup can be rerun with /F to customize configuration information and program groups for each account or user.

/L	creates a log file of the files Setup copies to your hard drive. This file is created as \Program Files\Devstudio\Msvc-stp.log, and contains a list of the files Setup proposed to copy, then a list of the files that were actually copied. It does not list any files that may be copied by the setup for components such as RDO.

/O	copies files without changing the current system configurations.

/P	copies a typical installation but does not update the program manager icons or group.


Uninstalling Visual J++

Visual J++ can be uninstalled using either the Control Panel Add/Remove Programs application or using an Uninstall icon in the Microsoft Visual J++ program manager group.

Here is what the Uninstall program does. It:

•	Removes all Visual J++ installed files that are not located in the Windows system directory except those project files created by users (for example, new projects you have created in \Program Files\Devstudio.)

Note   Microsoft Developer Studio (\Program Files\Devstudio) may also contain files that are shared by other products using this common shell. Uninstall will remove these files as outlined below.

•	For files located in the Windows system directory that may be shared by other applications, Uninstall gives you three prompted options:

•	Yes - remove file.

•	Yes to all - removes all files, including those shared by other applications. If you select “Yes to all” you will not see any further prompts. Use this selection with caution.

•	No - do not remove the file.

•	No to all - do not remove any shared files. If you select “No to all” you will not see any further prompts relating to shared files and no shared files will be deleted.

•	Deletes the "Developer" registry if no other products using common elements of Microsoft Developer Studio remain.

•	Deletes the "Microsoft Visual J++" program manager group.

Note   If you have created Visual J++ project files that are not uninstalled, Uninstall will remove the Developer registry entry and the program manager group. However, it will not remove the user-created files, or their respective subdirectories and root directory.

To uninstall Visual J++:

1	Locate Microsoft Visual J++ in the "Add/Remove Programs" control panel application.

2	Click the "Add/Remove" button.


Troubleshooting Your Installation

If Visual J++ does not install or run as expected, consult the Troubleshooting section of the Product Support Services help file (PSS.HLP), which can be found on the Visual J++ CD-ROM under \Devstudio\SharedIDE\Help or accessed from the Microsoft Developer Studio Help menu. If you cannot determine the cause of the problems yourself and want help from Microsoft Product Support Services, PSS.HLP also lists the phone numbers for product support.


Visual J++ Footprint Table

Table 1   Visual J++ Footprint

Type of install	Install size \Devstudio	Install size \System	What you get on your hard drive	What’s not on your hard drive
Minimal	12.4 MB	21.9 MB	Microsoft Developer, Internet Explorer 3.0, class file library (precompiled class files)	Tools, .class source (.java) files, documentation, RDO/DAO/ODBC, samples
Typical	20.8 MB	23.6 MB	Minimal installation plus tools, documentation	.class source (java) files, RDO/DAO/ODBC, samples
Complete	21.1 MB	32.9 MB	Typical installation plus .class source (java) files, RDO/DAO/ODBC	Samples
CD-ROM	10.9 MB	22.1 MB	Microsoft Developer, Internet Explorer 3.0, class file library (precompiled class files)	Tools, .class source (.java) files, documentation, RDO/DAO/ODBC, samples
Note   All disk space usage figures are approximate and may vary slightly depending on your installation. Installations on systems with Internet Explorer 3.0 may require less disk space.