blob: 58229de2d6dd5525cb475f3b8ade53729ded4da1 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>NetBeans Enterprise Pack 5.5 Installation Instructions</title>
<meta name="description" content="NetBeans Enterprise Pack 5.5 Installation Instructions">
<link rel="stylesheet" type="text/css" href="/netbeans.css" media="screen">
</head>
<body>
<!-- Begin Content Area -->
<a name="top"></a>
<h1>NetBeans Enterprise Pack 5.5 Installation Instructions</h1>
<p>The NetBeans Enterprise Pack 5.5 includes XML schema tools modules, BPEL modules, Secure Web Services modules, Sun Java System Application Server Platform Edition 9 Update 1, Project Open ESB Starter Kit, Sun Java System Access Manager 7.1, and Sun Java System Policy Agent 2.2 for Sun Web Services.</p>
<p><b>Note:</b> The UML functionality is no longer available in the final (FCS) release of the NetBeans Enterprise Pack 5.5 download. Instead, the UML functionality is offered separately on the Auto Update Center. See <a href="http://uml.netbeans.org">UML project page</a> for more information.</p>
<p><b>Contents</b></p>
<ul>
<li><a href="#prerequisites" title="Prerequisites">Prerequisites</a></li>
<li><a href="#configinfo" title="Configuration Information">Configuration Information</a></li>
<li><a href="#installation" title="Installing the Software">Installing the Software</a>
<div>
<ul>
<li><a href="#install_windows" title="Windows">Windows</a></li>
<li><a href="#install_sollinux" title="Solaris&trade; OS, Linux">Solaris&#8482; OS, Linux</a></li>
<li><a href="#install_macos" title="Macintosh OS X">Macintosh OS X</a></li>
</ul>
</div></li>
<li><a href="#uninstallation" title="Uninstalling the Software">Uninstalling the Software</a></li>
<li><a href="#troubleshoot" title="Troubleshooting">Troubleshooting</a></li>
</ul>
<blockquote>
<p><b>Note:</b> For information about system requirements for the software included in this bundle, see the <a href="entpack_relnotes.html">NetBeans Enterprise Pack 5.5 Release Notes</a>.</p>
</blockquote>
<!-- PREREQUISITES -->
<h2><a name="prerequisites"></a>Prerequisites</h2>
<p>This topic specifies the prerequisites that must be met before you start to install NetBeans Enterprise Pack 5.5.</p>
<blockquote>
<h3>Required Software</h3>
<p>The following software must be installed before you attempt to install NetBeans Enterprise Pack 5.5:</p>
<ul>
<li>NetBeans IDE 5.5 (hereinafter referred to as IDE) <br>
<br></li>
<li>JDK 5.0 Update 9 (version 1.5.0_09; hereinafter referred to as JDK) or higher must be installed on your system. If you do not have an installation of a JDK version 5.0 Update 9 or higher<span class="new"><!--update from A.Fomenko reflected --></span>, you cannot proceed with the installation. For details, see the <a href="entpack_relnotes.html#req_sw">Required&nbsp;Software</a> topic in the <a href="entpack_relnotes.html" title="Release Notes">Release&nbsp;Notes</a>.<br>
<br>
<b>Note:</b> For Mac OS X, at least JDK 5.0 release 3 is required.</li>
</ul>
<h3>Firewall Applications</h3>
<p>Enabled firewall applications can prevent some components from being configured correctly during the installation process. Disable any firewall applications before you start the installation.</p>
</blockquote>
<br>
<p align="center"><a href="#top">top</a></p>
<br>
<!-- CONFIG INFO -->
<h2><a name="configinfo"></a>Configuration Information</h2>
<p>This topic provides configuration information that you may need in order to configure the software.</p>
<blockquote>
<h3>Sun Java System Application Server</h3>
<p>The default username and password values for the default Application Server domain, <tt>domain1</tt>, are as follows: <br>
username: <tt>admin</tt><br>
password: <tt>adminadmin</tt></p>
<h3>Sun Java System Access Manager</h3>
<p>If you need to access the administration console for the Access Manager server, use the following values:<br>
username: <tt>amadmin</tt><br>
password: <tt>admin123</tt> </p>
</blockquote>
<br>
<p align="center"><a href="#top">top</a></p>
<br>
<!-- INSTALLATION -->
<h2><a name="installation"></a>Installing the Software</h2>
<p>This section contains instructions for installing NetBeans Enterprise Pack 5.5 on all supported platforms.</p>
<!-- INSTALLATION: WINDOWS -->
<blockquote>
<h3><a name="install_windows"></a>Windows</h3>
<p>Following are instructions for installing NetBeans Enterprise Pack 5.5 on the Microsoft Windows platform.</p>
<p><b>Before You Start</b></p>
<p>The following restrictions apply to installation on the Microsoft Windows platform:</p>
<ul>
<li>The installer first extracts the required files to the default temporary space directory defined by the <tt>TEMP</tt> environment variable. If the amount of disk space in the temporary directory is less than required, the installation might fail or proceed incorrectly.<br>
If you encounter this problem, you can increase the space allocated for the <tt>TEMP</tt> environment variable or specify a different temporary directory that has sufficient space. To specify a temporary directory for the installation, use the following commands from a command window:<br>
<br>
<tt>&gt;&nbsp;cd&nbsp;/d &nbsp;<i>location-of-installer</i></tt><br>
<tt>&gt;&nbsp;netbeans-ent_pack-5_5-windows.exe&nbsp;-is:tempdir&nbsp;<i>temporary-directory</i></tt><br>
</li>
</ul>
<p><b>To Install</b></p>
<ol>
<li>When you have downloaded the installer file, <tt>netbeans-ent_pack-5_5-windows.exe</tt><!--To verify the filename-->, double-click the installer's icon to launch the installer.<br>
<br></li>
<li>At the Welcome page of the installation wizard, click Next.<br><br></li>
<li>Respond to the license agreement and click Next.<br>
The NetBeans IDE 5.5 installation directory selection page of the wizard opens.<br>
<br></li>
<li>From the list of compatible installations choose the IDE on top of which the NetBeans Enterprise Pack will be installed, then click Next.<span class="new"><br>
</span>You can also type the path to another installed IDE or use the Browse button to navigate to and select another installation.<br>
<br></li>
<li>Select the NetBeans Enterprise Pack components you want to install, click Next.<br>
<b>Note:</b> Clear the BPEL and Secure Web Services checkboxes if you do not intend to use these modules. This enables the Skip Application Server configuration radio button in the following step and speeds up the installation process.<br>
<b>Note:</b> Make sure you observe the dependencies listed in the table below when selecting the components for your installation.<br>
<br>
<table width="600" border="1">
<tr>
<th scope="col">Required Component Name </th>
<th scope="col">Dependent Component Name </th>
</tr>
<tr>
<td>XML component of the NetBeans Enterprise Pack 5.5 </td>
<td>BPEL component of the NetBeans Enterprise Pack 5.5 </td>
</tr>
<tr>
<td>Sun Java System Application Server Platform Edition 9 </td>
<td>
<p>
The following of the NetBeans Enterprise Pack 5.5 components: <br>
</p>
<ul>
<li>BPEL</li>
<li>Secure Web Services<br><br></li>
</ul> </td>
</tr>
</table>
<br><br></li>
<li>Do one of the following:<br><br>
<ul>
<li>To install the bundled Application Server, follow the instructions in <a href="#continueinstallwithbundledas" title="To Continue the Installation With the Bundled Application Server">To Continue the Installation With the Bundled Application Server</a>.<br><br></li>
<li>If you have a preinstalled Sun Java System Application Server Platform Edition 9 or a preinstalled Application Server from Project Glassfish follow the instructions in <a href="#continueinstallwithpreinstalledas" title="To Continue the Installation With a Preinstalled Application Server">To Continue the Installation With a Preinstalled Application Server</a>.<br><br></li>
<!--<li>To continue the installation without the BPEL and Secure Web Services modules, follow the instructions in <a href="#continueinstallwithoutsoaidentity" title="To Continue the Installation Without the SOA and Identity Modules">To Continue the Installation Without the BPEL and Secure Web Services Modules </a>.<br><br></li>-->
</ul>
</li>
</ol>
<p><b><a name="continueinstallwithbundledas"></a>To Continue the Installation With the Bundled Application Server</b></p>
<ol>
<li>At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Install the bundled Application Server radio button, and click Next.<br>
<br>
</li>
<li>At the Application Server installation directory page of the installation wizard, accept the default Application Server installation directory, specify a different, empty installation directory, or use the Browse button to navigate to and select another installation directory, then click Next.
<br>
<br></li>
<li>From the list of compatible installations choose the JDK you want the Application Server to use, then click Next.<br>
You can also type the path to another installed JDK or use the Browse button to navigate to and select another installation.<span class="new"><br>
<br>
</span></li>
<li>Define the username and password for the default Application Server domain, <tt>domain1</tt>, or accept the defaults and click Next.<br>
The default username and password are <tt>admin</tt> and <tt>adminadmin</tt>.<br><br></li>
<li>Verify the port values (<tt>Admin</tt>, <tt>HTTP</tt>, and <tt>HTTPS</tt>) for the default Application Server domain and change them if necessary. Then click Next.<br>
<br></li>
<li>Verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.<br><br></li>
<li>Click Install to begin the installation. <br><br></li>
<li>When the installation is complete, click Finish to exit the wizard.</li>
</ol>
<p><b><a name="continueinstallwithpreinstalledas"></a>To Continue the Installation With a Preinstalled Application Server</b></p>
<ol>
<li>At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Use a Preinstalled Application Server radio button, and click Next.<br>
<br>
</li>
<li>At the Application Server installation directory page of the installation wizard, choose the Application Server you want to use from the list of compatible installations, or use the Browse button to navigate to and select another Application Server installation directory, then click Next.<br>
<br>
</li>
<li>If the default domain, <tt>domain1</tt>, exists in the selected Application Server, enter the username and password for the default domain and click Next.<br>
The installation wizard verifies the username and password information you entered.<br>
<b>Note:</b> The verification process may take some time.<br>
<br>
-or-<br><br>
If the default domain, <tt>domain1</tt>, does not exist in the selected Application Server, do the following:<br><br>
<ol type="a">
<li>Define the username and password for the default Application Server domain, <tt>domain1</tt>, or accept the defaults and click Next.<br>
The default username and password are <tt>admin</tt> and <tt>adminadmin</tt>.<br><br></li>
<li>Verify the port values (<tt>Admin</tt>, <tt>HTTP</tt>, and <tt>HTTPS</tt>) for the Application Server and change them if necessary. Then click Next.</li>
</ol>
<br><br></li>
<li>Verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.<br><br></li>
<li>Click Install to begin the installation. <br><br></li>
<li>When the installation is complete, click Finish to exit the wizard. <br><br></li>
</ol>
<!--<p>
<b><a name="continueinstallwithoutsoaidentity"></a>To Continue the Installation Without the BPEL and Secure Web Services Modules</b>
</p>
<ol>
<li>At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Skip Application Server configuration radio button, and click Next.<br>
<br>
</li>
<li>Verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.<br>
<br></li>
<li>Click Install to begin the installation.<br>
<br></li>
</ol>-->
<div class="greybox"> <b>Note: </b>If you encounter problems successfully completing the software installation, see <a href="#troubleshoot">Troubleshooting</a> for complete descriptions and suggested workarounds for unresolved issues that could affect the installation process. </div>
<br><br>
</blockquote>
<p align="center"><a href="#top">top</a></p>
<!-- INSTALLATION: SOLARIS OS and LINUX ---------------------------------->
<h3><a name="install_sollinux"></a>Solaris OS, Linux</h3>
<p>Following - are instructions for installing NetBeans Enterprise Pack 5.5 on the Solaris OS and Linux platforms.</p>
<p>In the instructions below, replace <tt><i>your_binary_executable</i></tt> with one of the following:</p>
<ul>
<li>Linux: <tt>netbeans-ent_pack-5_5-linux.sh</tt></li>
<li>Solaris OS, SPARC&#174;: <tt>netbeans-ent_pack-5_5-solaris-sparc.sh</tt></li>
<li>Solaris OS, x86/x64 Platform Edition: <tt>netbeans-ent_pack-5_5-solaris-x86.sh</tt></li>
</ul>
<blockquote>
<p><b>To Install</b></p>
<ol>
<li>When you have downloaded the installer file, <tt><i>your_binary_executable</i></tt>, navigate to the directory that contains that file. <br>
<br></li>
<li>If necessary, change the permissions on the installer file to make the binary executable by using the command shown below at a command prompt.<br>
<br>
<tt>&#36;&nbsp;chmod&nbsp;+x&nbsp;<i>your_binary_executable</i></tt><br>
<br>
</li>
<li>Launch the installer by using the command shown below at a command prompt.<br>
<br>
<tt>&#36;&nbsp;./<i>your_binary_executable</i></tt><br>
<br>
</li>
<li>At the Welcome page of the installation wizard, click Next.<br><br></li>
<li>Respond to the license agreement and click Next.<br>
The NetBeans IDE 5.5 installation directory selection page of the wizard opens.<br>
<br></li>
<li>From the list of compatible installations choose the IDE on top of which the NetBeans Enterprise Pack will be installed, then click Next.<br>
You can also type the path to another installed IDE or use the Browse button to navigate to and select another installation.<br>
<br></li>
<li>Select the NetBeans Enterprise Pack components you want to install, and click Next. <br>
<b>Note:</b> Clear the BPEL and Secure Web Services checkboxes if you do not intend to use these modules. This enables the Skip Application Server configuration radio button in the following step and speeds up the installation process.<br>
<b>Note:</b> Make sure you observe the dependencies listed in the table below when selecting the components for your installation.<br>
<br>
<table width="600" border="1">
<tr>
<th scope="col">Required Component Name </th>
<th scope="col">Dependent Component Name </th>
</tr>
<tr>
<td>XML component of the NetBeans Enterprise Pack 5.5 </td>
<td>BPEL component of the NetBeans Enterprise Pack 5.5 </td>
</tr>
<tr>
<td>Sun Java System Application Server Platform Edition 9 </td>
<td>
<p>
The following of the Netbeans Enterprise Pack 5.5 components: <br>
</p>
<ul>
<li>BPEL</li>
<li>Secure Web Services<br><br></li>
</ul> </td>
</tr>
</table>
<br><br></li>
<li>Do one of the following:<br><br>
<ul>
<li>To install the bundled Application Server, follow the instructions in <a href="#unix_continueinstallwithbundledas" title="To Continue the Installation With the Bundled Application Server">To Continue the Installation With the Bundled Application Server</a>.<br><br></li>
<li>If you have a preinstalled Sun Java System Application Server Platform Edition 9 or a preinstalled Application Server from Project Glassfish, follow the instructions in <a href="#unix_continueinstallwithpreinstalledas" title="To Continue the Installation With a Preinstalled Application Server">To Continue the Installation With a Preinstalled Application Server</a>.<br>
<br></li>
<!--<li>To continue the installation without the BPEL and Secure Web Services modules, follow the instructions in <a href="#unix_continueinstallwithoutsoaidentity" title="To Continue the Installation Without the SOA and Identity Modules">To Continue the Installation Without the BPEL and Secure Web Services Modules </a>.<br><br></li>-->
</ul>
</li>
</ol>
<p><b><a name="unix_continueinstallwithbundledas"></a>To Continue the Installation With the Bundled Application Server</b></p>
<ol>
<li>At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Install the bundled Application Server radio button, and click Next.<br>
<br>
</li>
<li>At the Application Server installation directory page of the installation wizard, accept the default Application Server installation directory, specify a different, empty installation directory, or use the Browse button to navigate to and select another installation directory. Then click Next.
<br>
<br></li>
<li>From the list of compatible installations choose the JDK you want the Application Server to use, then click Next.<br>
You can also type the path to another installed JDK or use the Browse button to navigate to and select another installation.<br>
<br>
</li>
<li>Define the username and password for the default Application Server domain, <tt>domain1</tt>, or accept the defaults and click Next.<br>
The default username and password are <tt>admin</tt> and <tt>adminadmin</tt>.<br><br></li>
<li>Verify the port values (<tt>Admin</tt>, <tt>HTTP</tt>, and <tt>HTTPS</tt>) for the Application Server and change them if necessary. Then click Next.<br><br></li>
<li>Verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.<br>
<br></li>
<li>Click Install to begin the installation. <br><br></li>
<li>When the installation is complete, click Finish to exit the wizard.<br><br></li>
</ol>
<p><b><a name="unix_continueinstallwithpreinstalledas"></a>To Continue the Installation With a Preinstalled Application Server</b></p>
<ol>
<li>At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Use a Preinstalled Application Server radio button, and click Next.<br>
<br>
</li>
<li>At the Application Server installation directory page of the installation wizard, choose the Application Server you want to use from the list of compatible installations, or use the Browse button to navigate to and select another Application Server installation directory. Then click Next.<br>
<span class="new"> <br>
</span></li>
<li>If the default domain, <tt>domain1</tt>, exists in the selected Application Server, enter the username and password for the default domain and click Next.<br>
The installation wizard verifies the username and password information you entered.<br>
<b>Note:</b> The verification process may take some time.<br>
<br>
-or-<br><br>
If the default domain, <tt>domain1</tt>, does not exist in the selected Application Server, do the following:<br><br>
<div>
<ol type="a">
<li>Define the username and password for the default Application Server domain, <tt>domain1</tt>, or accept the defaults and click Next.<br>
The default username and password are <tt>admin</tt> and <tt>adminadmin</tt>.<br><br></li>
<li>Verify the port values (<tt>Admin</tt>, <tt>HTTP</tt>, and <tt>HTTPS</tt>) for the Application Server and change them if necessary. Then click Next.</li>
</ol>
</div><br><br>
</li>
<li>Verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.<br>
<br></li>
<li>Click Install to begin the installation. <br><br></li>
<li>When the installation is complete, click Finish to exit the wizard.<br><br></li>
</ol>
<!--<p>
<b><a name="unix_continueinstallwithoutsoaidentity"></a>To Continue the Installation Without the BPEL and Secure Web Services Modules</a></b>
</p>
<ol>
<li>At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Skip Application Server configuration radio button, and click Next.<br>
<br></li>
<li>Verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.<br>
<br></li>
<li>Click Install to begin the installation.<br>
<br></li>
</ol>
-->
<div class="greybox"> <b>Note: </b>If you encounter problems successfully completing the software installation, see <a href="#troubleshoot">Troubleshooting</a> for complete descriptions and suggested workarounds for unresolved issues that could affect the installation process. </div>
<br><br>
</blockquote>
<p align="center"><a href="#top">top</a></p>
<!-- Installation: Mac OS -->
<h3><a name="install_macos"></a>Macintosh OS X</h3>
<p>Following - are instructions for installing NetBeans Enterprise Pack 5.5 on the Solaris OS and Linux platforms.</p>
<blockquote>
<p><b>Before You Start</b></p>
<p>The following restrictions apply to the installation on the Mac OS X platform:</p>
<ul>
<li>To ensure correct operation of the installer and uninstaller, you must configure Java to use JDK 5.0:
<ol type="a">
<li>In the Finder window, go to Applications | Utilities | Java | J2SE5.0 and open the Java Preferences utility.</li>
<li>In the Java Application Runtime Settings section, move J2SE5.0 to the top of the list.<br><br></li>
</ol>
</li>
<li>To allow the operating system to correctly recognize the NetBeans 5.5 bundle components, the installation directory must end with the string <tt>.app</tt>.</li>
</ul>
<p><b>To Install</b></p>
<ol>
<li>When you have downloaded the installer file, <tt>netbeans-ent_pack-5_5-macosx.jar</tt>, navigate to the directory that contains the file and double-click the installer's icon to launch the installer.<br>
<b>Note:</b> If the default java version on your system is 1.4, you will not be able to double-click the <tt>.jar</tt> file to start the installation. In this case, run the <tt>.jar</tt> file manually from the command line using java 1.5.<br><br></li>
<li>At the Welcome page of the installation wizard, click Next.<br><br></li>
<li>Respond to the license agreement and click Next. <br>
The NetBeans IDE 5.5 installation directory selection page of the wizard opens.<br>
<br></li>
<li>From the list of compatible installations choose the IDE on top of which the NetBeans Enterprise Pack will be installed, then click Next.<br>
You can also type the path to another installed IDE or use the Browse button to navigate to and select another installation.<br>
<br></li>
<li>Select the NetBeans Enterprise Pack components you want to install, and click Next. <br>
<b>Note:</b> Clear the BPEL and Secure Web Services checkboxes if you do not intend to use these modules. This enables the Skip Application Server configuration radio button in the following step and speeds up the installation process.<br>
<b>Note:</b> Make sure you observe the dependencies listed in the table below when selecting the components for your installation.<br>
<br>
<table width="600" border="1">
<tr>
<th scope="col">Required Component Name </th>
<th scope="col">Dependent Component Name </th>
</tr>
<tr>
<td>XML component of the NetBeans Enterprise Pack 5.5 </td>
<td>BPEL component of the NetBeans Enterprise Pack 5.5 </td>
</tr>
<tr>
<td>Sun Java System Application Server Platform Edition 9 </td>
<td>
<p>
The following of the Netbeans Enterprise Pack 5.5 components: <br>
</p>
<ul>
<li>BPEL</li>
<li>Secure Web Services<br><br></li>
</ul> </td>
</tr>
</table>
<br><br></li>
<li>Do one of the following:<br><br>
<ul>
<li>To install the bundled Application Server, follow the instructions in <a href="#mac_continueinstallwithbundledas" title="To Continue the Installation With the Bundled Application Server">To Continue the Installation With the Bundled Application Server</a>.<br><br></li>
<li>If you have a preinstalled Sun Java System Application Server Platform Edition 9 or a preinstalled Application Server from Project Glassfish, follow the instructions in <a href="#mac_continueinstallwithpreinstalledas" title="To Continue the Installation With a Preinstalled Application Server">To Continue the Installation With a Preinstalled Application Server</a>.<br>
<br></li>
<!--<li>To continue the installation without the BPEL and Secure Web Services modules, follow the instructions in <a href="#mac_continueinstallwithoutsoaidentity" title="To Continue the Installation Without the SOA and Identity Modules">To Continue the Installation Without the BPEL and Secure Web Services Modules</a>.<br>
<br></li>-->
</ul>
</li>
</ol>
<p><b><a name="mac_continueinstallwithbundledas"></a>To Continue the Installation With the Bundled Application Server</b></p>
<ol>
<li>At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Install the bundled Application Server radio button, and click Next.<br>
<br>
</li>
<li>At the Application Server installation directory page of the installation wizard, accept the default Application Server installation directory, specify a different, empty installation directory, or use the Browse button to navigate to and select another installation directory. Then click Next.
<br>
<br></li>
<li>Choose the JDK you want the Application Server to use from the list of compatible installations, then click Next.<br>
You can also type the path to another installed JDK or use the Browse button to navigate to and select another installation.<span class="new"><br>
<br>
</span></li>
<li>Define the username and password for the default Application Server domain, <tt>domain1</tt>, or accept the defaults and click Next.<br>
The default username and password are <tt>admin</tt> and <tt>adminadmin</tt>.<br><br></li>
<li>Verify the port values (<tt>Admin</tt>, <tt>HTTP</tt>, and <tt>HTTPS</tt>) for the Application Server and change them if necessary. Then click Next.<br><br></li>
<li>Verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.<br><br></li>
<li>Click Install to begin the installation. <br><br></li>
<li>When the installation is complete, click Finish to exit the wizard.<br><br></li>
</ol>
<p><b><a name="mac_continueinstallwithpreinstalledas"></a>To Continue the Installation With a Preinstalled Application Server</b></p>
<ol>
<li>At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Use a Preinstalled Application Server radio button, and click Next.<br>
<br>
</li>
<li>At the Application Server installation directory page of the installation wizard, choose the Application Server you want to use from the list of compatible installations found or use the Browse button to navigate to and select another Application Server installation directory. Then click Next.<span class="new"><br>
<br>
</span></li>
<li>If the default domain, <tt>domain1</tt>, exists in the selected Application Server, enter the username and password for the default domain and click Next.<br>
The installation wizard verifies the username and password information you entered.<br>
<b>Note:</b> The verification process may take some time.<span class="new"><br>
</span><br>
-or-<br><br>
If the default domain, <tt>domain1</tt>, does not exist in the selected Application Server, do the following:<br><br>
<ol type="a">
<li>Define the username and password for the default Application Server domain, <tt>domain1</tt>, or accept the defaults and click Next.<br>
The default username and password are <tt>admin</tt> and <tt>adminadmin</tt>.<br><br></li>
<li>Verify the port values (<tt>Admin</tt>, <tt>HTTP</tt>, and <tt>HTTPS</tt>) for the Application Server and change them if necessary. Then click Next.</li>
</ol>
<br><br></li>
<li>Verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.<br><br></li>
<li>Click Install to begin the installation. <br><br></li>
<li>When the installation is complete, click Finish to exit the wizard.<br><br></li>
</ol>
<!--<p>
<b><a name="mac_continueinstallwithoutsoaidentity"></a>To Continue the Installation Without the BPEL and Secure Web Services Modules</b>
</p>
<ol>
<li>At the NetBeans Enterprise Pack installation options page of the installation wizard select the Skip Application Server configuration radio button, and click Next.<br>
<br></li>
<li>Verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.<br><br></li>
<li>Click Install to begin the installation.<br>
<br></li>
</ol>
-->
</blockquote>
<div class="greybox"> <b>Note: </b>If you encounter problems successfully completing the software installation, see <a href="#troubleshoot">Troubleshooting</a> for complete descriptions and suggested workarounds for unresolved issues that could affect the installation process. </div>
<br><br>
<p align="center"><a href="#top">top</a></p>
<br>
<!-- Uninstallation -->
<h2><a name="uninstallation">Uninstalling the Software</a></h2>
<p>If you installed the bundled Application Server, the uninstallation removes NetBeans Enterprise Pack 5.5, Sun Java System Application Server Platform Edition 9, Project Open ESB Starter Kit, and Sun Java System Access Manager from your system. If you chose to use a preinstalled Application Server, the uninstallation removes NetBeans Enterprise Pack 5.5 from your system. In this case, to remove the Project Open ESB Starter Kit, you must uninstall the preinstalled Application Server.</p>
<!-- Deinstallation: Windows -->
<h3><a name="uninstall_windows">Microsoft Windows</a></h3>
<blockquote>
<p><b>To Uninstall the Software</b></p>
<ol>
<li>Shut down the IDE.<br><br></li>
<li>From the Control Panel, select Add or Remove Programs, then select NetBeans Enterprise Pack 5.5 and click Change/Remove.<br>
<br></li>
<li>Follow the instructions in the uninstaller.<br><br></li>
</ol>
</blockquote>
<!-- Uninstallation: Solaris and Linux -->
<h3><a name="uninstall_sollinux">Solaris OS, Linux</a></h3>
<blockquote>
<p><b>To Uninstall the Software</b></p>
<ol>
<li>Shut down the IDE.<br><br></li>
<li>Navigate to the <tt>bin/_uninst_entpack</tt> subdirectory of your NetBeans Enterprise Pack 5.5 installation directory.<br>
<br></li>
<li>Execute the <tt>uninstall.sh</tt> script.<br><br></li>
</ol>
</blockquote>
<!-- UNINSTALLATION: MAC OS ---------------------------------------------->
<h3><a name="uninstall_macos">Mac OS X</a></h3>
<blockquote>
<p><b>To Uninstall the Software</b></p>
<ol>
<li>Shut down the IDE.<br><br></li>
<li>Navigate to the <tt>bin/_uninst_entpack</tt> subdirectory of your NetBeans 5.5 installation directory.<br>
<br></li>
<li>Execute the <tt>uninstall.jar</tt> executable file.<br>
<b>Note:</b> If the default java version on your system is 1.4, you will not be able to double-click the <tt>.jar</tt> file to start the uninstallation. In this case, run the <tt>.jar</tt> file manually from the command line using java 1.5.<br><br></li>
</ol>
</blockquote>
<p align="center"><a href="#top">top</a></p>
<br>
<h2><a name="troubleshoot">Troubleshooting</a></h2>
<p>If you experience problems installing or running the software, see the list of issues below for workarounds. For a complete list of known issues, system requirements and other useful information, see the <a href="entpack_relnotes.html">NetBeans&nbsp;Enterprise&nbsp;Pack&nbsp;5.5&nbsp;Release&nbsp;Notes</a>. </p>
<p>Following are the unresolved issues for this release that could affect or disrupt the installation process: </p>
<ul>
<!-- Bug Id: 6348694 http://bt2ws.central.sun.com/CrPrint?id=6348694 - checked for TPR3 -->
<!-- Bug Id: 6381305 http://bt2ws.central.sun.com/CrPrint?id=6381305 - checked for TPR3 -->
<li><b><span style="color: #045491;">Installer fails to start correctly with little or no free disk space in the <tt>temp</tt> directory.</span></b>
<blockquote>
<p><strong>Description: </strong> On Microsoft Windows, if your system is set up to use a temporary directory on your <tt>C</tt> drive, and that temporary directory does not have enough space for the temporary files needed by the installer, the installer will report that there is not enough disk space on the <tt>C</tt> drive, even if you chose to install to a different drive. The installer is in fact reporting that it needs additional temporary space. <br>
The issue exists in the InstallShield framework.</p>
<p><strong>Workaround: </strong> Start the installer with the <tt>-is:tempdir <i>custom-temp-dir</i></tt> command line parameter. The <tt><i>custom-temp-dir</i></tt> should contain at least 130 MB of free disk space.</p>
</blockquote>
</li>
<!-- Bug Id: 6420381 http://bt2ws.central.sun.com/CrPrint?id=6420381-->
<li><b><span style="color: #045491;"><tt>NoClassDefFoundError: cannot access amserver</tt> occurs during installation.</span></b>
<blockquote>
<p><strong>Description: </strong> If you try to install the software a second time without cleaning up the Access Manager directory, the configuration of Access Manager may fail during installation.</p>
<p><strong>Workaround: </strong></p>
<ul>
<li>On Microsoft Windows:<br>
Delete the directory specified in: <tt><i>%SystemDrive%</i>\Documents&nbsp;and&nbsp;Settings\<i>user-name</i>\AMConfig_server_amserver_</tt> and then remove the file <tt><i>%SystemDrive%</i>\Documents and Settings\<i>user-name</i>\AMConfig_server_amserver_</tt>.<br>
<br></li>
<li>On UNIX/Mac:<br>
Delete the directory specified in: <tt><i>&#36;HOME</i>/AMConfig_server_amserver_</tt> and then remove the file <tt><i>&#36;HOME</i>/AMConfig_server_amserver_</tt>.</li>
</ul>
</blockquote>
</li>
<!-- Bug Id: 6383530 http://bt2ws.central.sun.com/CrPrint?id=6383530 - checked for TPR3 -->
<li><span style="color: #045491;"><b>Installer fails when using the <tt>-console</tt> and <tt>-silent</tt> options.</b></span>
<blockquote>
<p><strong>Description: </strong> On UNIX platforms, if the installer cannot run the installation process without the graphics mode, the installer suggests that you run the installer with the <tt>-console</tt> and <tt>-silent</tt> options. If you try this, the installer fails.</p>
<p><strong>Workaround: </strong> Ignore the message from the installer and set up the GUI environment as described below to proceed with the installation.<br>
The most common cause for this issue is that you are connecting to the target system via telnet/ssh/rlogin, which means you must redirect the GUI to the originating system. To do this successfully, the following two requirements must be met:</p>
<ol>
<li>An X server should be set up and running on the system from which you are connecting.<br><br></li>
<li>The DISPLAY environment variable should be set to the correct value on the target system. Assuming a bash shell, the correct value and command for the variable are:<br>
<tt>export DISPLAY=<i>machine-name</i>:<i>display-number</i></tt><br>
Where <tt><i>machine-name</i></tt> is the IP address of the system from where you are connecting, and <tt><i>display-number</i></tt> is the number of the display, usually <tt>0.0</tt>. </li>
</ol>
</blockquote>
</li>
<!-- Bug Id: 6383504 http://bt2ws.central.sun.com/CrPrint?id=6383504 - checked for TPR3 -->
<li><span style="color: #045491;"><b>Installation fails after manual uninstallation.</b></span>
<blockquote>
<p><strong>Description: </strong> If you try to install the product after performing a manual uninstallation by deleting files, the installation will fail because the data in InstallShield's VPD registry is not cleaned up.</p>
<p><strong>Workaround:</strong> Before starting a new installation, remove the InstallShield VPD registry. This registry resides in <tt>%SystemDrive%\Program&nbsp;Files\Common&nbsp;Files\InstallShield\Universal</tt> or in <tt>~/InstallShield</tt>.</p>
</blockquote>
</li>
<!-- Bug Id: 6383294 http://bt2ws.central.sun.com/CrPrint?id=6383294 - checked for TPR3 -->
<li><span style="color: #045491;"><b>On Mac OS X, cannot launch installation by double-clicking <tt>.jar</tt> file.</b></span>
<blockquote>
<p><strong>Description: </strong> If the default java version on your system is 1.4, you will not be able to double-click the <tt>.jar</tt> file to start the installation.</p>
<p><strong>Workaround:</strong> In this case, run the <tt>.jar</tt> file manually from the command line using java 1.5.</p>
</blockquote>
</li>
<!--Bug Id: 6379579 http://bt2ws.central.sun.com/CrPrint?id=6379579 - checked for TPR3 -->
<li><span style="color: #045491;"><b>Installer exceptions when running on JRE 1.4.</b></span>
<blockquote>
<p><strong>Description: </strong> On Microsoft Windows, if there is no preinstalled compatible JDK on the target machine, the InstallShield Windows launcher allows you to select a custom <tt>java.exe</tt>. After you select a custom <tt>java.exe</tt> the installer does not perform a validation for compatibility. This means that if you select a <tt>java.exe</tt> from a 1.4 JRE, which is not compatible with the installer, you will encounter a number of exceptions. The issue exists in the InstallShield framework.</p>
<p><strong>Workaround: </strong> Select a <tt>java.exe</tt> from a 1.5 JRE. See <a href="entpack_relnotes.html#req_sw" title="Required Software">Required&nbsp;Software</a> for information about downloading and installing a compatible JDK.</p>
</blockquote>
</li>
<!-- Bug Id: 6375086 http://bt2ws.central.sun.com/CrPrint?id=6375086 - checked for TPR3 -->
<li><span style="color: #045491;"><b>Installer fails to start correctly on UNIX.</b></span>
<blockquote>
<p><strong>Description: </strong>The installer fails to start correctly on UNIX when is there is little or no disk space in the root directory of the filesystem. The problem exists in the InstallShield framework. This issue was observed on machines with less than 2.5 MB free in the root of the filesystem.</p>
<p><strong>Workaround: </strong> Free up enough disk space in the root of the filesystem and restart the installer.<br><br></p>
</blockquote>
</li>
</ul>
<div class="feedback-box"><a href="https://netbeans.org/about/contact_form.html?to=5&amp;subject=Feedback:%20NetBeans%20Enterprise%20Pack%205.5%20Installation%20Instructions">Send Us Your Feedback</a></div>
<br style="clear:both;">
<p align="center"><a href="#top">top</a></p>
<br>
<!-- End Content Area -->
<b class="dkgrey">See Also</b>:
<ul>
<li><a href="entpack_relnotes.html">NetBeans Enterprise Pack 5.5 Release Notes</a></li>
</ul>
</body>
</html>