Installing IBM Edge Computing for Servers

Follow the steps in this topic to configure and enable the use of IBM Edge Computing for Servers.

Prerequisites

Before you begin with your installation, ensure that your environment meets the requirements for IBM Edge Computing for Servers and that you have correctly sized your cluster. For more information, see Preparing to install IBM Edge Computing for Servers.

To install IBM Edge Computing for Servers, you need to have IBM Cloud Private installed with IBM Multicloud Manager enabled at the hub cluster.

For more information about installing IBM Cloud Private, see Installing.
For more information about installing IBM Multicloud Manager, see Preparing for IBM Multicloud Manager installation.

With your hub cluster set up, install IBM Cloud Private and the IBM Multicloud Manager Klusterlet at each of your remote edge server locations.

When you are installing an instance of IBM Cloud Private at each of your edge server locations, you can choose any configuration of IBM Cloud Private to deploy. For instance, you can select to deploy a full IBM Cloud Private configuration or select a deployment that uses the IBM Cloud Private minimum required services for operating the edge server for a smaller resource footprint. You can use the edge computing profile to deploy IBM Cloud Private and the IBM Multicloud Manager Klusterlet with a smaller resource footprint.

The edge computing profile is designed specifically for IBM Edge Computing for Servers to place only the minimum required services that are needed for supporting edge server management and for supporting business-critical applications that you host on IBM Cloud Private. With this profile, you are still able to authenticate users, collect log and event data, and deploy workloads in a single node or a set of clustered worker nodes.

For more information about the available configurations of IBM Cloud Private, see Sizing your IBM Cloud Private cluster.

Complete the following steps to enable IBM Edge Computing for Servers:

Installation procedure

Follow the instructions to install IBM Cloud Private. For details, see Installing IBM Cloud Private Cloud Native, Enterprise, and Community editions.
Replace the default config.yaml file with the edge.config.yaml file. You must use the settings within the edge.config.yaml file to use the edge computing profile when you are deploying your cluster as an edge server.
1. Open a terminal on your edge server and run the following command to rename the default config.yaml file to be config.yaml.orig:
```
sudo mv /<installation_directory>/cluster/config.yaml  /<installation_directory>/cluster/config.yaml.orig
```
  Replace <installation_directory> with the path to your installation directory.
2. Run the following command to rename the edge.config.yaml file to config.yaml:
```
sudo cp /<installation_directory>/cluster/edge.config.yaml  /<installation_directory>/cluster/config.yaml
```
  Replace <installation_directory> with the path to your installation directory.
If you are installing on IBM Cloud Private Enterprise edition, you must set up an external Docker registry with authentication enabled and ready for use. Update the new config.yaml file to include your external Docker registry settings. For example:
```
 image_repo:  "__REGISTRY_SERVER__/__ORGANIZATION__"
 docker_username:  "__DOCKER_USER__"
 docker_password:  "__DOCKER_PASS__"
```
The installer process pushes all IBM Cloud Private images to this external registry for future use.
You can add the management services by setting them to enabled status in the management_services section of the config.yaml file. For more information about management services and adding or removing management services after installation, see Enabling and disabling IBM Cloud Private management services.