Configuring the Location of the Domains Folder

Runtime entities are created in the local file system in the BW_HOME/domains folder. Below are several different ways to change the folder location of a specific domain.

Admin CLI

Point to a new domain home for a specific domain by executing the -home command. For example, run the following command to create a domain home named testDomain: 

<BW_HOME>\ bin>bwadmin create -home /Users/testuser/domains domain testDomain

REST API

Use the home parameter in the REST request. For example, http://localhost:8079/bw/v1/domains/testDomain?home=/Users/testuser/domains

Domain Home Properties File

Update the domain home properties file to change the folder location of a specific domain.

Procedure

  1. Stop the bwagent if it is running.
  2. Open the BW_HOME/domains/DomainHomes.properties file in a text editor.
  3. Add a the <domainName>.domainHome property, where <domainName> is the intended domain, to this file to point to the new domain home for a specific domain. For example, by adding the testDomain.domainHome property to the DomainHomes file, you are specifying a custom domain folder for the domain testDomain.
  4. Save the file and restart the bwagent.
  5. From the Admin UI, create the domain using the domain name you specified in the domainHome property. For example, if you have added testDomain.domainHome to the DomainHomes file, go to the Admin UI and create a domain called testDomain.