JBuilder 2007 Installation Instructions

Abstract: Installation instructions for JBuilder 2007

     Introduction

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

Please read these instructions entirely before installing JBuilder 2007.

To use the ProjectAssist functionality, check the Include ProjectAssist installers and configuration tools box on the ProjectAssist dialog page during the JBuilder 2007 install. This option is only available when installing on the Windows XP and Windows 2003 through one of the JBuilder 2007 Enterprise editions.

Check the JBuilder product site at http://www.codegear.com/products/jbuilder for any additional JBuilder Installation items that may have occurred subsequent to this document.

For more product information, refer to the JBuilder 2007 Help online and the various links on the Welcome to CodeGear JBuilder 2007 menu item on the product Help menu. These resources describe the new features of JBuilder 2007. You can also find other plug-in specific help through the Eclipse Online Help links.

    System Requirements

The system requirements for each of the CodeGear JBuilder editions are listed below:

    CodeGear® JBuilder® 2007 Enterprise or JBuilder® 2007 Enterprise Borland ALM Edition

    PC:

    • 1 GB RAM recommended minimum
    • 1.5 GB RAM recommended
    • 700 MB to 1.2 GB hard disk space minimum (depending on the JBuilder 2007 edition), plus additional space during installation
    • Intel® Pentium® 4/2.4 MHz or higher (or compatible)
    • DVD-ROM drive
    • High-resolution monitor (1024x768 or higher, 256 colors)
    • Mouse or other pointing device

    Windows&reg Operating System (ProjectAssist Server Installation):

    • Microsoft® Windows® XP Professional (SP2)
    • Microsoft® Windows® 2003 Server

    Windows&reg Operating System (IDE or Assimilated TeamInsight Components):

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

    Red Hat Enterprise Linux (IDE or Assimilated TeamInsight Components)

    • P4 2.4 GHz processor, or greater
    • 1 GB RAM recommended
    • Red Hat Linux 4.0

    Macintosh® (IDE or Assimilated TeamInsight Components)

    • Intel Processor
    • 1 GB RAM recommended
    • OS X Tiger

    CodeGear® JBuilder®2007

PC:

  • 512 MB RAM minimum
  • 768 MB RAM recommended
  • 700 MB to 1.2 GB hard disk space minimum (depending on the JBuilder 2007 edition), plus additional space during installation
  • Intel® Pentium®4/2.4 MHz or higher (or compatible)
  • DVD-ROM drive
  • High-resolution monitor (1024x768 or higher, 256 colors)
  • Mouse or other pointing device

Windows&reg Operating System:

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

Red Hat Enterprise Linux(IDE or Assimilated TeamInsight Components)

  • P4 2.4 GHz processor, or greater
  • 1 GB RAM recommended
  • Red Hat Linux 4.0

Macintosh® (IDE or Assimilated TeamInsight Components)

  • Intel Processor
  • 1 GB RAM recommended
  • OS X Tiger

[ top of page ]

    Installing JBuilder 2007

        Installation Options

    The JBuilder 2007 product is available in four editions:

    Installation Installs the following components
    JBuilder 2007 Enterprise Borland ALM Edition Installs all features and components of JBuilder 2007 Enterprise, including ProjectAssist, TeamInsight, Web Services, EJB, Peer-to-Peer, Together UML, OptimizeIt, certified Eclipse bundle and more. In addition, it adds support for the ProjectAssist assimilation of an existing StarTeam installation. You can now select StarTeam as your change request, task and version control systems through the ProjectAssist/TeamInsight component stack. This product edition also includes a copy of JBuilder 2006 Enterprise edition.
    JBuilder 2007 Enterprise Installs all features and components of JBuilder 2007, including Web Services, EJB, Peer-to-Peer, Together UML, OptimizeIt, certified Eclipse bundle and more. Also provides team enhancing features and tools through the installation. It also includes a copy of JBuilder 2006 Enterprise edition.
    JBuilder 2007 Installs a subset of JBuilder 2007 Enterprise features. It provides a complete environment for developing and deploying Java applications. JBuilder 2007 provides accelerated development capabilities for Java and open-source programming plus a visual Web Services Designer, and an integrated Optimizeit 2007 for Eclipse that provides for debugging, memory and CPU Profiling.
    JBuilder 2007 Turbo Installs Eclipse in a simple, certified bundle. Popular plugins are delivered together as a turn-key installation, along with CodeGear-added JSE project import tools from previous versions of JBuilder and peer to peer messaging for team collaboration.

        Install JBuilder 2007 (Windows)

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

    To install JBuilder 2007 on Windows:

    1. Close all other running applications before installing JBuilder 2007.
    2. Disable any virus scanning software during the installation and setup.
    3. Turn off any firewalls during the installation and setup.
    4. If the installation launcher is not running, double-click on jbinstall.exe in the Windows\Disk1\InstData\VM\ to start the installation.
    5. A JBuilder 2007 splash screen appears.
    6. The Introduction screen appears.
    7. Read the information provided, then click Next.
    8. Accept the license agreement when prompted. Click Next.
    9. Accept the default or enter the directory where you want JBuilder 2007 installed. Click Next.
    10. Check the box on the ProjectAssist screen to include the ProjectAssist installer and configuration tools on this machine. Click Next.
    11. The Application Servers screen appears. This screen lists the runtime servers that are available for use in building web applications and web services. They are not related to your ProjectAssist server installation. Check any that you want to install. The default is to not install these servers. Click Next.
    12. You will be asked on the Choose Shortcut Folder screen for the locations of shortcut installs.
    13. Click Next to accept the default location or specify another option from the list.
    14. Review the installation options that you have selected. If the options are correct, click Install to begin the installation.
    15. 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 2007 Installation.

    • If you encounter errors when installing JBuilder 2007 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 will eventually close down successfully.


        Install JBuilder 2007 (Red Hat Enterprise Linux 4.0 Only)

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

    To install JBuilder 2007 on Red Hat Enterprise Linux 4.0:

    1. Close all other running applications before installing JBuilder 2007.
    2. Disable any virus scanning software during the installation and setup.
    3. Turn off any firewalls during the installation and setup.
    4. To start the installation launcher, navigate to the directory where install_linux.sh is located. From this directory, enter ./install_linux.sh on the command line or click on the file.
    5. A JBuilder 2007 splash screen appears.
    6. The Introduction screen appears.
    7. Read the information provided, then click Next.
    8. Accept the license agreement when prompted. Click Next.
    9. Accept the default or enter the directory where you want JBuilder 2007 installed. Click Next.
    10. 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.
    11. Review the installation options that you have selected. If the options are correct, click Install to begin the installation.
    12. Wait for the progress bar to indicate that the install is complete. Click Done.

        Install JBuilder 2007 (Macintosh)

    Note: You cannot install ProjectAssist on a Macintosh.

    To install JBuilder 2007 on the Macintosh:

    1. Close all other running applications before installing JBuilder 2007.
    2. Disable any virus scanning software during the installation and setup.
    3. Turn off any firewalls during the installation and setup.
    4. To start the installation launcher, navigate to the directory where install_mac_osx.sh is located. From this directory, enter ./install_mac_osx.sh on the command line or click on the icon.
    5. A JBuilder 2007 splash screen appears.
    6. The Introduction screen appears.
    7. Read the information provided, then click Next.
    8. Accept the license agreement when prompted. Click Next.
    9. Accept the default or enter the directory where you want JBuilder 2007 installed. Click Next.
    10. 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.
    11. Review the installation options that you have selected. If the options are correct, click Install to begin the installation.
    12. Wait for the progress bar to indicate that the install is complete. Click Done.

    [ top of page ]


    Troubleshooting Your JBuilder 2007 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 Disk1\InstData\VM\ directory.
    3. Double-click on the installation executable (jbinstall.exe on Windows, install_mac_osx.sh on the Macintosh, 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 call disk replacement to be issued new media by calling 831-461-9190.

    If the contents of the DVD still cannot be copied to the hard drive, an alternative is to simply download and install the appropriate trial version of JBuilder. The trial product will be converted to a full product by using your serial number during registration. Make sure that you choose the download that matches the license (that is, a serial number for Developer will NOT activate the Enterprise Trial). The Trial downloads may be accessed from the following location:

    http://www.codegear.com/downloads

    In this case, make sure to download and install any supplementary files on the same page as the main download (e.g documentation, samples, extras).


        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 2007 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 2007


    When you run JBuilder 2007 for the first time, you will need the serial number and key provided with your copy of the product. You can use JBuilder 2007 for 14 days after installation without registering. After 14 days, JBuilder 2007 will not run until it has been registered.

    (Note: There is no grace period for upgrade and trial versions, or for Optimizeit® products. These products must be registered before they can be used.)

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


    1. Start JBuilder 2007.
    2. When the Registration Wizard appears, select one of the following options, then click Next:

    [ top of page ]


        Registering with a Serial Number

    If you have the serial number and key from your JBuilder 2007 installation flyer:

    1. Enter your serial number and key, then click Next.

    2. Review and accept the licensing terms, then click Next.

    3. Select one of the following options:

      • Direct
        Select this option if you have an Internet connection and want to complete the registration process quickly.
      • Email
        Select this option if you have an email account and want to receive your activation file via email.
      • Web page
        Select this option if you want to complete the registration process using a web page and receive your activation file via email.
      • Telephone
        Select this option if you want to complete the registration process by telephone and receive your activation file by email or postal mail.


    4. Click Next.

     

    Completing direct registration

    If you are using direct registration:

    1. Enter your CodeGear customer account information.
    2. If you use a proxy to connect to the Internet, then enter your proxy settings when the Proxy Settings dialog appears. Otherwise, click Next. (If you don't know whether you use a proxy or your proxy settings, check with your System Administrator.)
    3. When the Information Summary dialog appears, verify that the information to be registered is correct. If the information is correct, click Next. Otherwise, click Back and correct the information before proceeding.
    4. Your registration information will now be transmitted and processed. When the message "Registration completed successfully!" is highlighted, click Next.
    5. Click Finish. The registration process is completed.

     

    Completing registration by email

    If you are completing your product registration by email:

    1. Enter your CodeGear customer account information.
    2. When the Information Summary dialog appears, verify that the information to be registered is correct. If the information is correct, click Next. Otherwise, click Back and correct the information before proceeding.
    3. When the Email Registration dialog appears, click Clipboard Copy to copy the information provided to your system clipboard. You will need to paste this into the body of an email message.
    4. Send an email to Email registration and paste the information from your system clipboard into the body of the message.
    5. Click Next.
    6. Click Finish.
    7. When you receive the email containing your activation file, you will need to repeat the registration process, this time choosing the Have Activation File option.

     

    Completing registration using the web

    If you are completing your product registration using the web page:

    1. Click Next.
    2. Record the Registration Key provided. You will need this to complete your registration.
    3. Click Finish.
    4. Using your web browser, go to Web Registration to complete the registration process.
    5. Click Finish.
    6. When you receive the email containing your activation file, you will need to repeat the registration process, this time choosing the Have Activation File option.

     

    Completing registration by telephone

    If you are completing your product registration by telephone:

    1. Enter your CodeGear customer account information.
    2. Select your location from the Telephone Number list.
    3. Call the Customer Service number for your location.
    4. Keep the Phone Registration displayed. You will need the information it contains to complete the registration process.
    5. Click Finish.
    6. When you receive your activation file, you will need to repeat the registration process, this time choosing the Have Activation File option.

     

    Using or creating a CodeGear Developer Network or Software Registration account

    Select one of the following options:

    • I have an account
      Select this option if you have a CodeGear Developer Network or Software Registration account from a previous CodeGear product registration.
      1. Click Next.
      2. Enter either your CodeGear Developer Network Member or Software Registration Account login name or your e-mail address.
      3. Enter your CodeGear Developer Network Member or Software Registration Account password.
      4. Click Next.


    • I don't have an account
      Select this option if you do not have a CodeGear Developer Network or Software Registration account from a previous CodeGear product registration.
      1. Click Next.
      2. When the User Information dialog appears, enter the following information:
        • Your First Name
        • Your Last or Family Name
        • The name of your company or organization (optional)
        • You can click Privacy Policy to view the privacy statement.
      3. Click Next.
      4. When the New Account Information dialog appears, enter the following information:
        • A login name for your Software Registration Account.
        • Your e-mail address.
        • A password for your Software Registration Account. (Note: The password must be at least 4 characters in length and must not contain any spaces.)
        • Verify the password for your Software Registration Account by entering it again.
        • You can click Privacy Policy to view the CodeGear privacy statement.
      5. Click Next.
      6. When the Additional Information dialog appear, complete the required fields:
        • Country
        • State/Province (if your selected Country was United States or Canada)
        • Zip Code
      7. Click Next.
      8. When Contact Preferences dialog appears, select your preferred contact methods.
      9. Click Next.


    [ top of page ]

        Registering with an Activation File

    To register using an activation file:

    1. Enter the path and filename of your activation file, or click the ellipsis (...) button to browse to the location of the file.
    2. Click Next.
    3. Click Finish. The registration process is completed.


    [ top of page ]


        Checking out a concurrent license

    When you're using a concurrent license for your CodeGear product, you might have occasions where you want to work offline, rather than connected to the License Server. The License Manager provides Check Out and Check In features that allow you to work offline. When you check out a license, you need to specify the duration of the check out. Once you've completed your offline work, you can check in the license to return it to the license pool. The client product has to be able to reach the License Server in order to check in the license.

    Concurrent licenses are listed on the server in a userlist-concurrent.txt file. The maximum checkout time is set by the server administrator for each user.

    Follow these simple steps to check out a license:

    1. Choose Tools|License Manager to open the License Manager.
    2. Right-click the Concurrent Network License node in the tree on the left and choose Check Out License.
    3. Enter the duration time in hours in the License Duration (hours) field. You can't exceed the maximum checkout time set by your server administrator. See your administrator for the maximum setting.
    4. Click OK to close the Checkout License dialog box. A Checkout Successful message displays. Click OK to close it. A red check mark displays next to the Concurrent Network License node to indicate that you're disconnected from the License Server and can use the product offline.
      Important: Notice that the remaining checkout time is displayed next to the Concurrent Network License node in parenthesis. For example, Concurrent Network License (1 hour left). To refresh the checkout time, right-click the Concurrent Network License node and choose Refresh Time Left.

        Checking in a concurrent license

    Once you've completed your offline work, you need to check the license in to return it to the license pool.

    Follow these simple steps to check in a license:

    1. Choose Tools|License Manager to open the License Manager.
    2. Right-click the Concurrent Network License node in the tree on the left and choose Check In License.
    3. Click Yes in the Confirm License Checkin dialog box to check the license in.


    [ top of page ]


    JBuilder 2007 Partner DVD

    Go to the CodeGear Developer Network (CDN) for information on the JBuilder 2007 Partner DVD.


    [ top of page ]

    Uninstalling JBuilder 2007

        Windows

    To uninstall JBuilder 2007 on Windows, do one of the following:

    • Run the following from the directory where you installed JBuilder 2007: UninstallerDataEnt\Uninstaller.exe.
    • Choose Start | All Programs | JBuilder 2007 | Uninstall JBuilder 2007 Enterprise.
    • Choose Settings | Control Panel | Add/Remove programs and select JBuilder 2007 from the list.

        Red Hat Enterprise Linux 4.0

    Run the following from the directory where you installed JBuilder 2007: user-install-dir/UninstallerDataEnt/Uninstaller.


        Macintosh

    Run the following from the directory where you installed JBuilder 2007: user-install-dir/UninstallerDataEnt/Uninstaller.


        Known problems

    Uninstalling JBuilder might leave some files on your system that will need to be manually removed.


    [ top of page ]