loading table of contents...

3.5.6. Developing Against a Remote Environment

Although the workspace is configured to use localhost everywhere, it is easy to develop against a remote environment. Either by changing localhost globally with the property installation.host in the project’s root POM file or by customizing some or all of the values listed in the table below. The property installation.host itself is just a convenience and should only be used within these specialized properties.

PropertyHost of component

cms.host

Content Management Server
mls.hostMaster Live Server
rls.hostReplication Live Server
solr.hostSolr search engine
caefeeder-preview.hostCAE Feeder (preview)
caefeeder-live.hostCAE Feeder (live)
studio.hostStudio
mongo.db.hostMongo database
database.hostSQL database

Table 3.7. Environment properties


If you want to manage multiple environments, you can manage them in your settings.xml file:

<profile>
  <id>dev</id>
  <properties>
    <cms.host>cms.dev.host.com</cms.host>
    <mls.host>cms.dev.host.com</mls.host>
    <solr.host>cms.dev.host.com</solr.host>
    <database.host>db.dev.host.com</database.host>
    <mongo.db.host>mdb.dev.host.com</mongo.db.host>
  </properties>
</profile>
<profile>
  <id>retest</id>
  <properties>
    <cms.host>cms.retest.host.com</cms.host>
    <mls.host>cms.retest.host.com</mls.host>
    <solr.host>cms.retest.host.com</solr.host>
    <database.host>db.retest.host.com</database.host>
    <mongo.db.host>mdb.retest.host.com</mongo.db.host>
  </properties>
</profile>
<profile>
  <id>vagrant</id>
  <properties>
    <cms.host>blueprint</cms.host>
    <mls.host>blueprint</mls.host>
    <solr.host>blueprint</solr.host>
    <database.host>blueprint</database.host>
    <mongo.db.host>blueprint</mongo.db.host>
  </properties>
</profile>
      

Example 3.6. Adding Environments in settings.xml


You can choose now to connect to different environments by either manually adding a profile to your Maven call (such as -Pdev) or by setting the profile permanently in your settings.xml file.

<activeProfile>dev</activeProfile>
          

Example 3.7. Activating Environment in settings.xml


[Note]Note

By default, a vagrant profile is provided for you, to develop against the virtualized Vagrant box.