test

Sun Java System Application Server Platform Edition 9 Installation Guide

Installing the Software

After you have verified that your system meets the requirements specified in Hardware and Software Requirements in Sun Java System Application Server Platform Edition 9 Release Notes, use either of the following procedures to install the Application Server product.

Note –

If you are installing on a Solaris 10 system, Application Server can be installed either in the global zone or a non-global zone. For more information on zones, see the Solaris 10 documentation.

ProcedureTo Install on Solaris or Linux

Before You Begin

If you are installing as a non-root user, you must have read/write access to the following directories:

  1. Navigate to the directory where you downloaded the distribution file.

  2. Change the permission of the distribution file so that you have execute access:

    chmod +x distribution_filename

    The distribution file name changes depending upon the distribution, version, and platform, in the format sjas_pe-version-platform.bin or java_ee_sdk-version-platform.bin. For example, for the Linux Application Server distribution, the file is sjsas_pe-9_0-linux.bin. For the Linux Java EE SDK distribution, the file is java_ee_sdk-5-linux.bin or java_ee_sdk-5–soa_kit-preview-linux.bin.

  3. Run the installation program.

    • To run the installation program that uses a graphical interface, at the command prompt, type the name of the distribution file:

      ./distribution_filename

    • To run the installation program that uses the command-line interface, at the command prompt, type the name of the distribution file followed by the -console option:

      ./distribution_filename -console

  4. In the Administration Configuration page (or at the command line), enter the following:

    • Admin User Name – Name of the user who administers the server.

    • Password – Admin user’s password to access the Admin Server (8-character minimum).

    • Prompt or Don't Prompt for Administrator User Name – The user name can be stored in a preferences file so that you do not have to provide it to perform administrative tasks.

    • Admin Port – Administration port number for initial server instance.

    • HTTP Port – Port number to access the default server instance.

    • HTTPS Port – Secure port number to access the default server instance.

  5. Enter the directory where you want to install the software.

  6. In the Installation Options page, select the options that you want.

    If you select the Upgrade from Previous Version checkbox, the upgrade wizard begins after installation is completed. Upgrades from 8.0 Platform Edition, 8.1 Platform Edition, and 8.2 Platform Edition are supported. For information about upgrading, see Chapter 3, Upgrading an Application Server Installation, in Sun Java System Application Server Platform Edition 9 Upgrade and Migration Guide.

  7. In the Java EE SDK SOA Starter Kit Preview distribution, choose whether to install Project Open ESB Starter Kit as an add-on.

    Project Open ESB Starter Kit implements an enterprise service bus (ESB) runtime that incorporates the JSR 208 specification for Java Business Integration (JBI) and other open standards. Open ESB Starter Kit allows you to integrate web services and enterprise applications as loosely coupled composite applications within a service-oriented architecture (SOA).

    Open ESB Starter Kit includes a Business Process Execution Language (BPEL) service engine, a Java EE service engine, an HTTP SOAP binding component, and examples that demonstrate using the BPEL service engine. Additional components, tools, and documentation are available for download. Refer to http://java.sun.com/integration/openesb/starterkit.jsp for more information on the Open ESB Starter Kit and the additional components, tools, and documentation that are available.

  8. On the Ready to Install page click Install Now.

  9. After the installation completes, set the PATH environment variable to include the Application Server install-dir/bin directory.

  10. Verify the installation by following the instructions in the Sun Java System Application Server Platform Edition 9 Quick Start Guide, located in install-dir/docs/QuickStart.html or on docs.sun.com.

    If you have problems with your installation, or with starting the server, see the Sun Java System Application Server Platform Edition 9 Troubleshooting Guide.

ProcedureTo Install on Windows

  1. Navigate to the directory where you downloaded the .exe file.

  2. Double-click the .exe file to start the installation program.

    The executable file name changes depending upon the distribution and version, in the format sjas_pe-version-windows.exe or java_ee_sdk-version-windows.exe. For example, for the Application Server distribution, the file is sjsas_pe-9_0-windows.exe. For the Java EE SDK distribution, the file is java_ee_sdk-5-windows.exe or java_ee_sdk-5-soa_kit-preview-windows.exe.

  3. Follow the instructions on the wizard screens of the installation program.

  4. In the Admin Configuration page (or at the command line), enter the following:

    • Admin User Name – Name of the user who administers the server.

    • Password – Admin user’s password to access the Admin Server (8-character minimum).

    • Prompt or Don't Prompt for Administrator User Name – The user name can be stored in a preferences file so that you do not have to provide it to perform administrative tasks.

    • Admin Port – Administration port number for initial server instance.

    • HTTP Port – Port number to access the default server instance.

    • HTTPS Port – Secure port number to access the initial server instance.

  5. Enter the directory where you want to install Application Server.

  6. In the Installation Options page, select the options that you want.

    If you select the Upgrade from Previous Version checkbox, the upgrade wizard begins after installation is completed. Upgrades from 8.0 Platform Edition, 8.1 Platform Edition, and 8.2 Platform Edition are supported. For information about upgrading, see Chapter 3, Upgrading an Application Server Installation, in Sun Java System Application Server Platform Edition 9 Upgrade and Migration Guide.

    Note –

    To create a Windows service, the sc.exe utility must be available on the system. Windows 2000 users may need to install the Windows 2000 Resource Kit to get this utility. For other supported Windows versions, the utility is included in the operating system.

  7. In the Java EE SDK SOA Starter Kit Preview distribution, choose whether to install Project Open ESB Starter Kit as an add-on.

    Project Open ESB Starter Kit implements an enterprise service bus (ESB) runtime that incorporates the JSR 208 specification for Java Business Integration (JBI) and other open standards. Open ESB Starter Kit allows you to integrate web services and enterprise applications as loosely coupled composite applications within a service-oriented architecture (SOA).

    Open ESB Starter Kit includes a Business Process Execution Language (BPEL) service engine, a Java EE service engine, an HTTP SOAP binding component, and examples that demonstrate using the BPEL service engine. Additional components, tools, and documentation are available for download. Refer to http://java.sun.com/integration/openesb/starterkit.jsp for more information on the Open ESB Starter Kit and the additional components, tools, and documentation that are available.

  8. On the Ready to Install page choose Install Now.

  9. After the installation completes, if you did not select the corresponding option on the Installation Options screen, set the PATH environment variable to include the Application Server install-dir/bin directory.

  10. Verify the installation by following the instructions of the Sun Java System Application Server Platform Edition 9 Quick Start Guide, located in install-dir/docs/QuickStart.html or on docs.sun.com.

    If you have problems with your installation, or with starting the server, see Sun Java System Application Server Platform Edition 9 Troubleshooting Guide.