Copying an Satellite location

Learn how to copy your Satellite location to a new location by reviewing resource details and re-creating them in a new Satellite location, or to keep copies for archival purposes.

1. Get your location details and optionally save the details to a local file.

   ibmcloud sat location get --location LOCATION_ID [> mylocation.txt]
   

2. List the hosts in your location.

   ibmcloud sat host ls --location LOCATION_ID
   

3. Get the details of a host and optionally save the details to a local file. In particular, note the labels for CPU and memory so that you know your host configuration. Repeat this step for each host in your location.

   ibmcloud sat host get --location LOCATION_ID --host HOST_ID [> host1.txt]
   

4. List your Satellite Link endpoints. A certain set of endpoints are created by default, but note your other endpoints.

   ibmcloud sat endpoint ls --location LOCATION_ID
   

5. Get the details of an endpoint and optionally save the details to a local file. Repeat this step for each endpoint in your location.

   ibmcloud sat endpoint get --location LOCATION_ID --endpoint ENDPOINT_ID [> endpoint1.txt]
   

6. List the clusters that are created in your Satellite location.

   ibmcloud oc cluster ls --provider satellite
   

7. Re-create your location.

   • For options to create the location and hosts, see Deciding how to create your Satellite location.
   • To create Satellite Link endpoints, see cloud or location endpoint instructions.
   • For clusters, see Creating Red Hat OpenShift in Satellite. If you manually deployed Kubernetes configurations instead of using Satellite Config, also see Copying deployments to another cluster.

8. Redeploy your apps to your cluster. Because Satellite Config works across Satellite locations, you can add your new clusters to existing cluster groups that are already subscribed to the configurations that you want to deploy.

9. Similar to Satellite Config, if you used Satellite storage configurations, you can assign these configurations to your new clusters to install the storage drivers.

When you are done and your new location is healthy, you can remove the previous location.