N1 Grid Service Provisioning System User's Guide and Release Notes for the Sun Java System App Server Plug-In 1.0

ProcedureHow to Install the Sun Java Enterprise System Application Server Software

Steps
  1. Select the Sun Java Enterprise System Application Server icon under the Common Tasks section of the left control panel.

  2. Click the SJSAS 8.1 Install Management: Install or Uninstall link.

  3. Click the Run action next to default: install.

  4. In the Plan Parameters area, select the variable settings for the Install component that you plan to deploy.

    The Install component installs the Sun Java Enterprise System Application Server on a Remote Agent. After you have installed the Install component on a Remote Agent, you do not have to reinstall that component again.

    When you run the plan to install a new domain or server instance, the provisioning system checks to see if an Install component exists in the installPath directory. If the Install component is already installed, the provisioning system does not reinstall the Install component.

    • If the variable settings have been established for this component, select the appropriate settings from the menu.

    • If the settings are not available from the menu, click Select From List.

      The Select Variable Settings From List window displays.

      • To create a new set of variable settings, select Create Set.

        The following list provides commonly-updated variables for the Install component.

        variable set name

        Required. A name for the new variable set you create.

        installDirectory

        Required. The location where the Sun Java Enterprise System Application Server software will be installed.

        sourceImage

        Required. The location of the Sun Java Enterprise System Application Server package installer.

        Typically this is an NFS-mounted directory containing the extracted Sun Java Enterprise System Application Server installer. For example, if the value of sourceImage is /net/mymachine/nfs/sjsappserver8.1, you would do the following before installing the plug-in:


        % mkdir /net/mymachine/nfs/sjsappserver8.1
        % cd /net/mymachine/nfs/sjsappserver8.1
        % unzip .../sjsas_ee-8_1_01_2005Q1-solaris-sparc.bin
        installId

        Required. A unique ID that associates an Install component with installed Application Server domains and clusters.

        adminUserId

        The user name of the administrator of the domain or cluster.

        Typically this will be picked up from the session variables.

        adminPassword

        The password for the administrator login of the domain or cluster.

        Typically this will be picked up from the session variables.

        httpLoadBalancerPluginType

        If you are using a web server load balancer with the domain or cluster, enter the type of web server here. Valid entries are Sun ONE Web Server or Apache HTTP Server.

        The web server must already be installed on the target host.

        webserverInstallDirectory

        Location of the web server, used when installing the load balancer plug-in. For Sun ONE Web Server, enter the instance directory. For Apache HTTP Server, enter the install directory.

        webserverConfigDirectory

        The directory where the load balancer configuration file, loadbalancer.xml will be located.

        Only set this variable if the load balancing plug-in is already installed on the web server gateway host.

        adminPasswordEncryptedFlag

        If set to true, the administrator's password will be encrypted. The default is false.

        asadminPort

        The port on which the Application Server domain administration server listens. The default is 4849.

        adminWebPort

        The port on which deployed web applications run. The default is 8090.

        instanceHTTPSPort

        The port on which secure HTTP (HTTPS) applications are run. The default is 1043.

        createSamplesDomain

        If true, a domain containing Application Server sample applications will be installed on the instance. The default is false.

        storeAdminAuth

        If true, the administrator's password will be written to a file. The default is false.

        tempStateFile

        The location of temporary files used during installation.

        We recommend that you do not change this variable.

      • To use variable components from another component, click Import Set.

        For more information about importing variable sets, see How to Run a Plan in N1 Grid Service Provisioning System 5.0 Operation and Provisioning Guide.

  5. Select the target host.

    Install the Application Server software on the Remote Agent.

  6. Deselect the Target Host Set checkbox.

  7. If you want to run a detailed check (preflight) before installing, select Perform Detailed Preflight.

  8. Click Run Plan (includes preflight).