Sun GlassFish Web Space Server 10.0 Installation Guide

ProcedureTo Install Web Space Server Add-Ons On a WebLogic Server

This procedure explains how to install Web Space Server Add-Ons (OpenSSO, Sharepoint, SWA, among others) when Web Space Server is running on a WebLogic server. This procedure is not meant to provide exhaustive Add-On instructions, but rather only highlights the primary steps you need to take when running on a WebLogic server. For detailed instructions for you particular Web Space Server Add-On, refer to the Sun GlassFish Web Space Server 10.0 Add-On Document Collection.

Before You Begin

WebLogic and Web Space Server must be up and running before proceeding with the instructions in this section. See Installing Oracle WebLogic Server Software and To Install Web Space Server Software Into an Existing Oracle WebLogic Server Configuration for more instructions.

  1. Stop and undeploy the webspace.war application file.

    This step is only necessary if the Web Space Server Add-On you are installing causes the webspace.war to be rebuilt. For example, installing the OpenSSO Add-On involves rebuilding the webspace.war file.

    The webspace.war file can be undeployed using the GUI-based WebLogic administration console or the WebLogic command line.

    • To undeploy the webspace.war file using the GUI-based WebLogic administration console

      1. Use a Web browser to log in to the WebLogic administration console; for example:


        http://localhost:7001/console
      2. Click Deployments, select the webspace.war file, and undeploy it.

    • To undeploy webspace.war using the WebLogic command line

      1. Open a root command shell for your operating environment on the server on which WebLogic is running.

      2. Undeploy the webspace.war file.


        java weblogic.Deployer -adminurl t3://localhost:7001 -user \
        weblogic -password weblogic -name webspace.war -undeploy -graceful
        

        Note that the above command should be entered on a single line.

      3. (Optional) Verify that the webspace.war file is undeployed.


        java weblogic.Deployer -adminurl t3://localhost:7001 -user \
        weblogic -password weblogic -listapps
        
  2. Follow the installation instructions for the particular Web Space Server Add-On you want to install.

  3. If the Add-On you installed caused the webspace.war file to be rebuilt, manually deploy webpspace.war again.


    Note –

    Any portlets that rely on webspace.war also need to be redeployed and started after webspace.war is redeployed.


    As with undeployment, the webspace.war file can be deployed using the GUI-based WebLogic administration console or the WebLogic command line.

    • To deploy webspace.war using the GUI-based WebLogic administration console

      1. Use a Web browser to log in to the WebLogic administration console; for example:


        http://localhost:7001/console
      2. Click Deployments, and manually deploy the webspace.war file.

        The webspace.war file is located in the ws-install-dir/var/webspace/war-workspace/finals/ directory.


        Tip –

        When running WebLogic in Production mode, you must explicitly click the Start button in the WebLogic administration console for each WAR file you deploy.


    • To deploy the webspace.war file using the WebLogic command line

      1. Open a root command shell for your operating environment on the server on which WebLogic is running.

      2. Deploy the webspace.war file.


        java weblogic.Deployer -adminurl t3://localhost:7001 -user \
        weblogic -password weblogic -deploy webspace.war
        

        Note that the above command should be entered on a single line. To start the application, invoke the above command with the -start option.

      3. (Optional) Verify that the webspace.war file is deployed.


        java weblogic.Deployer -adminurl t3://localhost:7001 -user \
        weblogic -password weblogic -listapps