Deploying the Studio .ear file

To install Studio, you deploy the .ear file into the WebLogic domain. For a development environment, you can use the autodeploy function. In a production environment, you must use the WebLogic Administration Console.

To deploy the Studio .ear file:

  1. Extract the portal-ext.properties file from EID_2.4.x_Studio_portal_weblogic.zip, and place it in the Liferay Home directory.

    This version of the file is at the top level of the .zip file, and contains the complete set of Studio default settings.

  2. If you have changed the Liferay Home directory from the default, then you must add the liferay.home parameter to the top of the file.

    For example:

    liferay.home=/localdisk/liferay
  3. If you are using a non-root context, then you also need to update the portal.ctx property to use the same context root value you set in the META-INF/application.xml (See Configuring a non-root context for a WebLogic instance).

    The property is at the beginning of the file.

    When setting the portal.ctx value, do not include a trailing slash. For example, use this value:

    portal.ctx=/mycompany/portal

    Do not use this value:

    portal.ctx=/mycompany/portal/
  4. Create the /data/endeca-data-sources directory in the Liferay Home directory.

    If your data sources are connected to a secured Endeca Server, then this directory will contain the associated Java Keystore (JKS) files.

    For details on connecting data sources to a secured Endeca Server, see the Oracle Endeca Information Discovery Studio User's Guide.

  5. Create the deploy directory in the Liferay Home directory.
  6. Create the weblogic-deploy directory in the Liferay Home directory.
  7. If WebLogic isn't already started, then to start it, run the WebLogic startup script. For Linux, the script name is startWebLogic.sh.

    The startup script is in the bin subdirectory of the domain directory.

  8. Extract the .ear file from EID_2.4.x_Studio_portal_weblogic.zip, and then deploy the .ear file into the domain.

    For a development environment, you can use the autodeploy option to deploy the file. For example, for Linux:

    cp endeca-portal-weblogic-2.4.ear <DomainDirectory>/autodeploy

    Where <DomainDirectory> is the path to the domain directory.

    For a production environment, you need to use the WebLogic Administration Console to deploy the file:

    1. Go to the Administration Console at <hostname>:7001/console.
    2. Under Helpful Tools, click Configure applications.
    3. Click Install.
    4. Use the file browser to find the endeca-portal-weblogic-2.4.ear file, then click the radio button to the left of it.
    5. Click Next.
    6. Accept the default selection, then click Next.
    7. Accept the default selections, then click Finish.

    The deployment may take several minutes. Make sure you do not try to log in to Studio before the deployment is complete.

    Note that when you deploy the .ear file, you are deploying the complete set of standard Studio components. To remove components, or add custom components, you need to update the .ear file. For information on adding components to and removing components from the .ear file, see the Oracle Endeca Information Discovery Studio Developer's Guide.

  9. To verify that Studio has deployed successfully:
    1. Open a Web browser.
    2. In the browser, go to http://<hostName>:<portNumber>, where <hostName> is the name of the server, and <portNumber> is the number of the port used by WebLogic.

      By default, WebLogic uses port 7001.

    You should see the Studio welcome page.