KBEC-00078 - Changing the Commander Server hostname

Article ID:360033194471
1 minute readKnowledge base

Description

During the ElectricCommander install, you can use "localhost" or a fully qualified domain name for the name of the Commander host.

If localhost was used during install, the machine hostname can be changed without requiring Commander configuration changes.

If a fully qualified domain name was used during install, the following operations will require Commander configuration changes.

System names are moved from network to network, and often the Commander Server hostname changes. Use this procedure to get Commander running under the new name. Note: During installation, if the hostname was "localhost", these steps are not necessary.

Solution

On a Commander web server:

  1. Open the file apache/conf/httpd.conf

  2. Find "ServerName" and change the name to the new hostname.

  3. Generate a new Apache certificate - see the ElectricCommander Installation and Configuration Guide Chapter 2 for more information.

  4. Restart Apache

On the Commander server:

  1. Open the file /apache/htdocs/commander/config.php

  2. Find $config[ec:"serverHost"] and change the name to the new hostname.

  3. Restart Commander

  4. If the IP number of the host changed, use the Commander GUI to check the Administration > Server > Settings IpAddress property value and change it if necessary.

This article is part of our Knowledge Base and is provided for guidance-based purposes only. The solutions or workarounds described here are not officially supported by CloudBees and may not be applicable in all environments. Use at your own discretion, and test changes in a safe environment before applying them to production systems.