Handling network changes
After your system is deployed, its network infrastructure and configuration should not change. Specifically:
- All instance IP addresses should not change. It's best to use static IP addresses.
- All services should continue to use the same ports.
- All services and instances should continue to use the same network types.
If any of these values change, you will need to reinstall the system.
Safely changing an instance IP address
For each instance whose IP address you need to change:
Procedure
Move all services off of the instance. Distribute those services among all the other instances.
On the instance from step 1, stop the script
For example, with systemd, run: systemctl stop hcpcs.servicerun
using whatever tool or process you used to run it.Remove the instance from the system.
Delete the installation folder from the instance.
Add the instance back to the system.
After a network change
If a network infrastructure or configuration change occurs that prevents your system from functioning with its current network settings, you need to reinstall all instances in the system.
Procedure
If the Admin App is accessible, back up your system components by exporting a package.
On each instance in the system:
Navigate to the installation folder.
Stop the run script using whatever tool or process you used to run it. For example, with systemd, run:
systemctl stop <service-name>
Run
bin/stop
Run the setup script, including the list of master instances:
sudo bin/setup -i <ip-address-for-this-instance> -m <comma-separated-list-of-master-instance-IP-addresses>
Run the run script using whatever methods you usually use to run scripts.
Log into Admin App and use the wizard to set up the system.
After the system has been set up, upload your package.