How to Change vCenter Server Appliance (VCSA) IP via SSH/Console in vSphere 5.1


13 views

When your VCSA 5.1 appliance is deployed in a different network environment (like a hosted data center), you'll typically need to modify its IP configuration through direct console access. Here's how to proceed:

1. From the ESXi host, right-click the vCenter virtual machine
2. Select "Open Console"
3. Log in as root using your credentials

The VCSA 5.1 uses a modified version of SUSE Linux Enterprise Server. Network configuration is stored in several key files:

/etc/sysconfig/network/ifcfg-eth0
/etc/hosts
/etc/resolv.conf

Execute these commands sequentially after logging in:

# Bring down the network interface
ifdown eth0

# Edit the network configuration
vi /etc/sysconfig/network/ifcfg-eth0

Modify these parameters:

IPADDR='new_ip_address'
NETMASK='new_netmask'
GATEWAY='new_gateway'

Don't forget to update these critical files:

# Update hosts file
vi /etc/hosts
127.0.0.1   localhost
new_ip_address  vcsa-hostname.yourdomain.com vcsa-hostname

# Update DNS configuration if needed
vi /etc/resolv.conf
search yourdomain.com
nameserver dns_ip_address

After making changes, restart networking:

# For immediate effect
ifup eth0

# Alternatively restart the network service
service network restart

# Verify new configuration
ifconfig eth0
ping gateway_ip

Check these aspects to ensure proper functionality:

  • SSH access with new IP
  • vSphere Client connectivity
  • DNS resolution both directions
  • Service health through appliance management interface

When deploying VMware vCenter Server Appliance (VCSA) in production environments, IP address changes are sometimes necessary due to network migrations or hosting relocations. This becomes challenging when remote management interfaces are unavailable because the appliance is on a different subnet.

Before proceeding, ensure you have:

  • Root SSH/console access to the VCSA
  • New static IP information (address, netmask, gateway)
  • DNS server addresses if required
  • Network connectivity verification tools ready

Accessing the Command Line

Connect via:

ssh root@current_ip
# Or use the direct console if SSH is unavailable

Modifying Network Configuration

Edit the network interfaces file:

vi /etc/sysconfig/network-scripts/ifcfg-eth0

Update these key parameters:

DEVICE=eth0
BOOTPROTO=static
IPADDR=new_ip_address
NETMASK=new_netmask
GATEWAY=new_gateway
ONBOOT=yes

Updating Hosts File

Ensure consistency by modifying:

vi /etc/hosts

Replace old IP with new IP for all local entries.

Restarting Network Services

Apply changes with:

service network restart
# For newer versions:
systemctl restart network

Confirm the changes took effect:

ifconfig eth0
ping gateway_ip
nslookup your_vcenter_fqdn

After IP modification:

  • Update DNS records if using FQDN
  • Reconfigure connected ESXi hosts if needed
  • Verify vSphere Client connectivity
  • Check linked services (vSAN, HA, DRS)

If connectivity fails:

# Check routing:
route -n

# Verify DNS resolution:
dig @dns_server your_fqdn

# Test firewall rules:
iptables -L -n