Changing the Studio home directory on WebLogic Server

For a Studio installation on WebLogic Server, the default location of the Studio home directory is <MiddlewareHomeDirectory>/user_projects/domains/<StudioDomain>/eid/studio, where <MiddlewareHomeDirectory> is the directory where you installed WebLogic Server, and <StudioDomain> is the domain you created for Studio. You can, if needed, use a different directory as the Studio home directory.

To provide a pointer to the new Studio home directory, you can either:
  • Add a JVM parameter to setDomainEnv.cmd or setDomainEnv.sh
  • Add a setting to a copy of portal-ext.properties in the default Studio home directory that redirects to your custom Studio home directory

To create and configure a different location for the Studio home directory:

  1. Create the directory you want to use as the Studio home directory.
  2. Place portal-ext.properties in the Studio home directory:
    1. Extract portal-ext.properties from the top level of the Studio for WebLogic Server download .zip file.
    2. Place portal-ext.properties in the Studio home directory you created.
    This is the version of portal-ext.properties you use to override default Studio configuration, for example when:
    • Changing the database used for Studio
    • Overriding Studio framework settings
    • Configuring a Studio cluster
    • Configuring a reverse proxy
  3. To use the setDomainEnv script file (setDomainEnv.cmd for Windows and setDomainEnv.sh for Linux) to point to the new Studio home directory:
    1. Open the file.

      The file is located in the bin subdirectory of the domain directory (<MiddlewareHomeDirectory>/user_projects/domains/endeca_studio_domain/bin/) .

    2. In the file, immediately before the WL_HOME setting, add the following setting:
      EXTRA_JAVA_PROPERTIES=-Deid.studio.home=<pathToCustomStudioHome>

      For example:

      EXTRA_JAVA_PROPERTIES=-Deid.studio.home=/localdisk/user_projects/domains/endeca_studio_domain/eid/myhome

      Remember that for Windows, you must escape the back slashes. For example:

      EXTRA_JAVA_PROPERTIES=-Deid.studio.home=C:\\Oracle\\Middleware\\user_projects\\domains\\endeca_studio_domain\\eid\\myhome
  4. To use portal-ext.properties to redirect from the default Studio home directory to the custom Studio home directory:
    1. Create a new empty text file.

      This file will only contain the parameters needed to redirect to your custom Studio home directory.

    2. Add eid.studio.home and include-and-override parameters to the file.

      Set the eid.studio.home parameter to the full path to your custom Studio home directory.

      Set the include-and-override parameter to the full path to the portal-ext.properties file in your custom Studio home directory.

      For example:

      eid.studio.home=/localdisk/user_projects/domains/endeca_studio_domain/eid/myhome
      include-and-override=/localdisk/user_projects/domains/endeca_studio_domain/eid/myhome/portal-ext.properties

      Remember that for Windows, you must escape the back slashes. For example:

      eid.studio.home=C:\\Oracle\\Middleware\\user_projects\\domains\\endeca_studio_domain\\eid\\myhome
      include-and-override=C:\\Oracle\\Middleware\\user_projects\\domains\\endeca_studio_domain\\eid\\myhome\\portal-ext.properties
    3. Save the file as portal-ext.properties in the default Studio home directory (<MiddlewareHomeDirectory>/user_projects/domains/<StudioDomain>/eid/studio).
  5. In your custom Studio home directory, create the following subdirectories:
    • /data/endeca-data-sources
    • deploy
    • weblogic-deploy
  6. You can then continue with step 2 of the Studio deployment process.