Awhile back Apple published an article on switching the network interface used in Xsan for Metadata networks
. The article provides the following steps:
- Use Xsan Admin to stop the volumes (see below).
- In Xsan Admin select Overview.
- In the lower right corner, click the gear icon and choose “Edit SAN properties”.
- Select the Metadata Network that you want to use.
- Click Save.
- Restart the volumes.
Note: If all controllers and clients are not on the same subnet on each network, the Save button will be dimmed. Adjust the clients and controllers so they are on the same subnets.
This typically works great; except the fact that the article has been retired and in Xsan 3 the Save button never actually gets undimmed. Therefore, while I hate changing network interfaces in Xsan I do find that in 10.8 and higher, I end up needing to do so by editing the config files. To get started, first shut down your backup metadata controller, so in case everything goes haywire you have a back out plan. Then open config.plist from /Library/Preferences/Xsan in your favorite text editor and locate the metadataNetwork key as follows:
In this case we’re going to switch from our 10.0.0.0 network to our 192.168.0.0 network (note that this is a .0 with a CIDR and not the actual IP address):
Once you’ve made your change, edit fsnameservers. The file will initially have data that looks like the following (provided our Metadata Controllers are 10.0.0.1 and 10.0.0.2):
Assuming the systems have the same final octet the resulting changes would be as follows (note that these have no XML structure and are just a list of numbers separated by carriage returns):
Save the files and reboot the host. Provided that everything works on both network interfaces, the volume should automatically start upon reboot. If the volume starts and you can mount it then repeat the same process on the backup. The metadata controller will initially indicate that it cannot stat the volume settings on the backup when the backup is restarted. Don’t worry about that, just make the changes and reboot the backup. Once rebooted, check cvadmin and verify that all volumes are activated on both hosts. If they are, then you’re good on the controllers (unless you have a third controller and need to do this process on it as well).
Clients sometimes need to get removed from the SAN and readded. If this is the case, then force remove them from Xsan Admin (unless of course, it allows you to do so gracefully), Disable Xsan from the Xsan System Preference pane and then rm the contents of /Library/Preferences/Xsan. Provided everything removes properly restart (or launchctl unload com.apple.xsan and launchctl start com.apple.xsan.plist) and then readd the client from Xsan Admin. The clients should be the easy part of this whole process.
Overall, it’s a pretty painless process. If you can get the Save button in the Settings screen for the SAN per Apple’s instructions then that’s preferred as it’s less work; however, I have only seen that Save button selectable in Xsan 2 and below.