KBEC-00390 - Using ecconfigure to change hostnames post install.

Article ID:360032824892
1 minute readKnowledge base


At a certain point, you may be required to make adjustments to the hostname of your machine, EF Servers or its components. To handle the post install changes to properties, you can use the GUI or use the ecconfigure, an CloudBees CD (CloudBees Flow) packaged tool.

ecconfigure allows you to make multiple adjustments on the command line. This will save you time from having to adjust multiple configuration files and guard against missing any necessary setting changes.

When adjusting the name of the machine hosting the Server or other CloudBees CD (CloudBees Flow) components, you may see a connection error such as:

Web Server could not connect the CloudBees CD (CloudBees Flow) Server at https://:8443

If you receive this error and the CloudBees CD (CloudBees Flow) Server is running, then the Webserver may be pointing to the wrong CloudBees CD (CloudBees Flow) server hostname.

To resolve this error or adjust the Hostname targets for the Server or Webserver, you can use the following ecconfigure command:

ecconfigure --webTargetHostName  --serverName

After inputting this command, you should see a response similar to the following:



Install Directory:

Data Directory:

Components: tools, agents, web, server, database, repository

Setting the commander agent's domain name if not set already

Restarting commanderAgent Service