JBuilder 2008 Installation Notes

Abstract: This document contains the instructions for installing and registering your JBuilder 2008 product.

    Introduction

This document contains the instructions for installing and registering your JBuilder 2008 product.

Please read these instructions entirely before installing JBuilder 2008.

Check the JBuilder product site at http://jbuilder.codegear.com/ for any additional JBuilder Installation items that may have occurred subsequent to this document. For more product information, refer to the JBuilder 2008 Help online and the various links on the Welcome to CodeGear JBuilder 2008 menu item on the product Help menu. These resources describe the new features of JBuilder 2008. You can also find other plug-in specific help through the Eclipse Online Help links. NOTE: Your JBuilder 2008 product comes with a free copy of InterBase 2007 Developer Edition. Below are serial number and authorization key for InterBase 2007 Developer Edition:
  • InterBase Serial number: ?F?M-2MEYHG-TCGYZW-RZQS
  • InterBase Authorization key: 7MH-VUF

[ top of page ]

    Table of Contents


[ top of page ]

    System Requirements

The system requirements for CodeGear JBuilder (all editions) are listed below:

        PC (Windows® and Linux):

    • 1 GB RAM minimum (1.5 GB RAM recommended)
    • 700 MB to 1.2 GB hard disk space minimum, plus additional space during installation
    • Intel® Pentium®4/2.4 GHz or higher (or compatible)
    • High-resolution monitor
    • Mouse or other pointing device


    Windows™ Operating System:

    • Microsoft® Windows™ XP Professional (SP2)
    • Microsoft® Windows™ Vista 32-bit


      NOTE: ProjectAssist™ has a separate installer. ProjectAssist can only be installed on Microsoft® Windows® XP Professional (SP2) and Microsoft® Windows™ 2003 Server.

    Red Hat Enterprise Linux (IDE or Assimilated TeamInsight Components)

    • Red Hat Linux 4.0

        Macintosh® (IDE or Assimilated TeamInsight Components)

    • Intel Processor
    • 1 GB RAM minimum (1.5 GB RAM recommended)
    • Mac OS X Tiger (10.4)
    [ top of page ]

        Installing JBuilder 2008

        Installation Options

    The JBuilder 2008 product is available in three editions:

    • CodeGear™ JBuilder® 2008 Enterprise
    • CodeGear™ JBuilder® 2008 Professional
    • CodeGear™ JBuilder® Turbo 2008

        Install JBuilder 2008 (Windows)

    Note: You must have administrator rights in order to install the JBuilder 2008 ProjectAssist server.

    To install JBuilder 2008 on Windows:

    1. Close all other running applications before installing JBuilder 2008.
      The following two steps are for ProjectAssist:
      1. Disable any virus scanning software during the installation and setup.
      2. Turn off any firewalls during the installation and setup.
    2. Insert DVD; or download the ESD and extract it to [JBuilder2008RootDirectory]. The installation launcher opens. If the installation launcher does not open (or you are not installing from the DVD), open the DVD or navigate to [JBuilder2008RootDirectory], double-click install_windows.exe.
    3. To begin installation, click JBuilder 2008.
      The Introduction screen appears.
    4. Read the information provided. Click Next.
    5. Accept the license agreement when prompted. Click Next.
    6. Accept the default or enter the directory where you want JBuilder 2008 installed. Click Next.
    7. The Application Servers screen appears. This screen lists the runtime servers that are available for use in building web applications and web services. Check any that you want to install. The default is to not install these servers. Click Next.
    8. On the Choose Shortcut Folder screen you are asked for the locations of shortcut installs.
    9. Click Next to accept the default location or specify another option from the list.
    10. Review the installation options that you have selected. If the options are correct, click Install to begin the installation.
    11. Wait for the progress bar to indicate that the install is complete. Click Done.

    Installation Notes

    For additional troubleshooting tips on installing and running JBuilder, see Troubleshooting Your JBuilder 2008 Installation.

    • If you encounter errors when installing JBuilder 2008 using the main installation launcher, you can install each component separately.
    • Under some circumstances, it may take a long time for the installation program to exit and close after completion. Do not forcibly exit the program; it eventually closes down successfully.

        Install JBuilder 2008 (Red Hat Enterprise Linux 4.0 Only)

    Note: You cannot install ProjectAssist on Red Hat Enterprise Linux.

    To install JBuilder 2008 on Red Hat Enterprise Linux 4.0:

    1. Close all other running applications before installing JBuilder 2008.
    2. Insert the DVD; or download the ESD and extract it to [JBuilder2008RootDirectory].
    3. To start the installation launcher:
      • If using the DVD, open JBUILDER2008 icon on the GNOME desktop.

      • If the launcher doesn't open automatically, open the DVD and double-click install_linux.sh file to execute from Nautilus File Manager. Click Run.
      • If installing from the ESD, navigate to [JBuilder2008RootDirectory] and enter ./install_linux.sh on the command line.
    4. To begin installation click JBuilder 2008.
      The Introduction screen appears.
    5. Read the information provided. Click Next.
    6. Accept the license agreement when prompted. Click Next.
    7. Accept the default or enter the directory where you want JBuilder 2008 installed. Click Next.
    8. The Application Servers screen appears. This screen lists the runtime servers that are available for use in building web applications and web services. Check any that you want to install. The default is to not install these servers. Click Next.
    9. Review the installation options that you have selected. If the options are correct, click Install to begin the installation.
    10. Wait for the progress bar to indicate that the install is complete. Click Done.

        Install JBuilder 2008 (Mac OS X 10.4 Tiger)

    Note: You cannot install ProjectAssist on a Macintosh.

    To install JBuilder 2008 on the Macintosh:

    1. Close all other running applications before installing JBuilder2008.
    2. To start the installation launcher, insert DVD and open JBUILDER 2008 icon on the desktop, or
      download ESD and extract to [JBuilder2008Folder], open and double-click install_macrosx icon.
    3. The Introduction screen appears.
    4. Read the information provided. Click Next.
    5. Accept the license agreement when prompted. Click Next.
    6. Accept the default, or create a new folder where you want JBuilder 2008 installed by clicking Choose ... button on the screen. Click Next.
    7. The Application Servers screen appears. This screen lists the runtime servers that are available for use in building web applications and web services. Check any that you want to install. The default is to not install these servers. Click Next.
    8. Review the installation options that you have selected. If the options are correct, click Install to begin the installation.
    9. Wait for the progress bar to indicate that the install is complete. Click Done.
    [ top of page ]

        Troubleshooting Your JBuilder 2008 Installation

        General

    If the installation can be performed successfully on another machine (with the same OS platform), the resulting installation directory can be copied from one machine to another. This can be the easiest way to workaround installation problems, but is only useful when other machines on a network are available.

        Nothing happens after the installation program is started

    If the main installation program does not automatically launch when the DVD is inserted into the DVD drive:

    1. Navigate to the DVD drive.
    2. Navigate to the root directory.
    3. Double-click on the installation executable (install_windows.exe on Windows, install_mac_osx on the Mac OSX, or install_linux.sh for Red Hat Enterprise Linux 4.0).

        Error -1 when starting the installation program from a DVD

    This error occurs when the DVD driver is having trouble reading from the DVD. In this case, try copying the contents of the DVD into a temporary directory on your hard drive and then launch the installer from that location. If the files cannot be copied from the DVD to the hard drive because of read errors (for example, error -1, read errors, etc.), check the DVD for scratches. If the DVD is visibly damaged, please contact customer support.

    If the contents of the DVD still cannot be copied to the hard drive, an alternative is to simply download and install the appropriate ESD version of JBuilder:

    http://www.codegear.com/downloads

    NOTE: You may need to register.

        The main installation program does not launch when the DVD is inserted

    To eliminate possible conflicts with other third-party software, disable anti-virus software (e.g. stop the service), exit out of any other currently running software, and then retest the installation.

    In Windows XP, you can automatically do this using the msconfig.exe tool to restart your system in a diagnostic mode that prevents third-party services from starting up. To do this:

    1. Choose Start | Run.
    2. Enter msconfig and click OK.
    3. Under the General tab, select Diagnostic Startup and click OK.
    4. Restart your system and start the JBuilder 2008 installation program again.

    After successfully installing JBuilder, repeat these steps, changing Diagnostic Startup to your usual Startup mode.

        The installation programs seems to start, but then freezes at the splash screen

    To troubleshoot installation graphics driver issues, try the following:

    • First, visit the website of the manufacturer of the graphics card to download and install the latest driver.
    • Windows XP: If the issue is not resolved, try turning down the graphics card acceleration. To do this:
      1. Right-click on the desktop.
      2. Choose Properties | Settings | Advanced | Troubleshoot.
      3. Set the Hardware acceleration to None.
      4. Start the JBuilder installation program again.
    • The installation progress bar may stay near the end for a very long time, making it seem like the installation program has hung. Do not end the program; the installation will complete successfully after a period of time.
    [ top of page ]

        Registering JBuilder 2008

    When you run JBuilder 2008 for the first time, you will need the serial number or activation file provided with your copy of the product. You can use JBuilder 2008 for 14 days after installation without registering. After 14 days, JBuilder 2008 will not run until it has been registered.
    (Note: There is no grace period for trial versions.)

    Trial users: See the front label of your product DVD for the URL or visit http://cc.codegear.com/free/jbuilder to obtain your trial activation files.


    1. Start JBuilder 2008.
    2. When the Registration screen appears, complete one of the following options:
      • Enter your serial number:
        Select this option if you have the serial number.
      • Enter your activation file:
        Select this option if you are completing the registration process and have an activation file that you received via e-mail or is available to you from another location.
    3. Enter your CodeGear Developer Network account Login and Password.
      If you don't have an account or have lost your password, follow instructions by clicking the links provided.
    4. Click Register.
      The registration status appears in the dialog after connecting to the CodeGear registration server.
    5. When Regiestration has completed, restart JBuilder 2008 to complete the process.

    [ top of page ]

    v200803310827