The PPmac reaches devices by IP address but fails when a hostname is used, or it reaches the local subnet but cannot communicate through a router. Configure the nameserver from a Telnet session and configure the gateway through the PowerPMAC IDE. Treat these as separate settings: DNS translates hostnames into IP addresses, while the gateway routes traffic beyond the controller's local subnet.
Symptom and Configuration Path
Before anything else, confirm which communication function has failed. Testing the wrong layer can make a correct gateway look like a DNS fault or a correct nameserver look like a routing fault.
| Observed behavior | Setting to inspect | Configuration path | Confirmation |
|---|---|---|---|
| An IP address works, but the corresponding hostname does not | Nameserver entry | Telnet and /.readonly/etc/resolv.conf
|
The file contains a valid nameserver line, followed by a reboot and a successful hostname test |
| Local-subnet devices respond, but off-subnet devices do not | Default gateway | PowerPMAC IDE: Tools > Options > PowerPMAC > IP Address Change Setup
|
The configured gateway matches the network design and an off-subnet IP test succeeds |
| Neither local IP addresses nor hostnames respond | Local address, subnet, link, or physical network | Network diagnostics before changing DNS or gateway | Link and local-subnet IP communication work before proceeding |
Use a direct IP-address test first. If the target IP is reachable but its hostname is not, repair the nameserver configuration. If a local IP is reachable but a remote IP is not, inspect the gateway. If local IP communication also fails, stop and correct the local interface or network connection first.
DNS and Gateway Mechanisms
A nameserver does not carry application traffic. It answers a lookup request by returning an IP address for a hostname. The PPmac then opens the actual connection to that returned address. A missing or incorrect nameserver line therefore breaks hostname-based connections while direct IP connections may continue to work.
The default gateway performs a different job. The controller compares a destination address with its own subnet. It sends local destinations directly on the local network; it sends destinations outside that subnet to the configured gateway. An incorrect gateway can leave local communication fully operational while blocking remote networks.
DNS may depend on the gateway when the nameserver itself is outside the local subnet. In that case, an accurate nameserver entry still fails until routing to that server works. Diagnose in this order: local IP communication, off-subnet IP communication when required, and hostname resolution last.
Nameserver Configuration by Telnet
Changing the nameserver requires a Telnet session, a temporary read-write remount of the root filesystem, an edit to resolv.conf, restoration of read-only mode, and a PPmac reboot. Have the approved nameserver IP address available before opening the session.
-
Connect to the PPmac through Telnet and change to the configuration directory:
cd /.readonly/etcConfirm that the working directory is
/.readonly/etc. Do not move on until the path is correct; editing a similarly named file elsewhere will not apply the intended persistent setting. -
Remount the root filesystem read-write:
mount -o remount,rw /Confirm that the command completes without an error before attempting the edit.
-
Create or edit
resolv.confwith the editor available on the controller. Add a line in this form:nameserver {ip}Replace
{ip}with the actual nameserver address; do not type the braces. The supplied configuration example is:nameserver 10.10.98.7Read the saved file back and confirm the keyword is spelled
nameserver, the address is correct, and the entry is not commented out. -
Return the root filesystem to read-only mode:
mount -o remount,ro /Do not move on until the remount completes without an error. Leaving the filesystem writable increases exposure to unintended configuration changes.
Reboot the PPmac. The reboot is part of the configuration procedure, so plan for the resulting controller and communications interruption.
Gateway Configuration in the PowerPMAC IDE
Use the IDE for the gateway rather than editing unrelated network files through Telnet. Obtain the gateway address from the approved network design and confirm that it belongs to the controller's intended local network.
Connect the PowerPMAC IDE to the intended controller. Confirm the controller identity and current IP configuration before changing any network value.
Open
Tools > Options.Select
PowerPMAC > IP Address Change Setup. Confirm that the displayed settings belong to the same PPmac reached in the first step.Enter the required gateway in the gateway field. Recheck every address octet before applying the change; a typing error can preserve local access while removing access from routed engineering networks.
Apply the configuration using the IDE controls. If the IDE requests a restart or reconnection, complete it and reconnect using the active controller address.
Changing the gateway does not repair a wrong nameserver entry. Likewise, editing resolv.conf does not create a route to remote subnets. Configure both only when the network design requires both services.
Commissioning Checks and Recurring Pitfalls
Test a known device on the PPmac local subnet by IP address. Do not continue until local addressing and the physical link work.
If routed communication is required, test a known off-subnet destination by IP address. Success confirms that the gateway path works independently of DNS.
Test the same required service by hostname. Success confirms that name resolution and the subsequent routed connection both work.
After rebooting, reconnect and read
/.readonly/etc/resolv.conf. Confirm that the intendednameserverline remains present.Repeat the off-subnet IP and hostname tests after the reboot. This distinguishes a saved configuration from a change that worked only during the initial session.
| Pitfall | Result | Correction |
|---|---|---|
Typing {ip} literally |
The resolver has no usable server address | Replace the placeholder with the approved numeric address |
Editing before mount -o remount,rw /
|
The file edit may fail because the filesystem is read-only | Remount read-write, edit, verify, then restore read-only mode |
Skipping mount -o remount,ro /
|
The root filesystem remains writable | Restore read-only mode before rebooting |
| Testing only by hostname | Routing and DNS failures remain indistinguishable | Test local IP, remote IP, and hostname in that order |
| Changing the gateway to correct local-subnet failure | The actual link, address, or subnet fault remains | Restore local IP communication before changing routing |
Frequently Asked Questions
What happens if the PPmac nameserver is wrong?
Hostname lookups fail even though direct connections to valid IP addresses may still work. Correct the nameserver line in /.readonly/etc/resolv.conf, restore read-only mode, and reboot.
What happens if the PPmac gateway is wrong?
Local-subnet communication may work while destinations reached through a router fail. Set the approved gateway under Tools > Options > PowerPMAC > IP Address Change Setup.
What happens if I edit resolv.conf without remounting read-write?
The edit may fail because the root filesystem is read-only. Run mount -o remount,rw / before editing and mount -o remount,ro / afterward.
What happens if the nameserver is on another subnet?
The PPmac also needs a working gateway route to reach that server. Verify an off-subnet IP connection before treating the remaining failure as DNS-only.
How do I verify PPmac DNS and gateway settings after reboot?
Confirm the saved nameserver line, test a known off-subnet destination by IP, and then test the required destination by hostname. Do not release the controller until all required tests pass after the reboot.