Configuring IBM Multicloud Manager-CE

You can either configure IBM Multicloud Manager-CE with the IBM Cloud Private management console after IBM® Cloud Private installation, or you can configure your config.yaml file during the installation process.

Note: You need the IBM Cloud Private monitoring service enabled. Additionally, if you configure by using the config.yaml, you cannot enable both the hub and the endpoint at the same time. You must enable each option in separate IBM® Cloud Private cluster installations.

Configuring IBM Multicloud Manager-CE with IBM Cloud Private management console

Configuration from IBM Cloud Private management console is the best-practice configuration.

1. After you install IBM Cloud Private with the monitoring service enabled, click Catalog from the IBM Cloud Private management console.

2. Find the following charts in All Categories > DevOps for optional configuration:

   • IBM Multicloud Manager controller chart, which is the hub-cluster: ibm-mcm-dev
   • IBM Multicloud Manager Klusterlet chart, which is the managed-cluster: ibm-mcmk-dev

Configuring IBM Multicloud Manager-CE with the config.yaml file:

For more information about the config.yaml file, see Customizing the cluster with the config.yaml file.

Follow the process to change your IBM Multicloud Manager-CE settings in your config.yaml file, which is located in the /<installation_directory>/cluster folder. Customize the parameters as required.

To configure your IBM Cloud Private cluster as the hub-cluster, you need to enable the multicluster-hub option.

To configure your IBM Cloud Private cluster as the managed-cluster, you need to enable multicluster-endpoint on a separate IBM Cloud Private cluster.

Note: You cannot enable both options in the same installation.

1. Find the settings for multicluster in the _managementservices section. See the following example:

   management_services:
    istio: disabled
    vulnerability-advisor: disabled
    storage-glusterfs: disabled
    storage-minio: disabled
    platform-security-netpols: disabled
    node-problem-detector-draino: disabled
    metering: disabled
    logging: disabled
    multicluster-hub: disabled
    multicluster-endpoint: disabled
   

2. Enable the multicluster-hub, as it is in the following example:

   multicluster-hub: enabled
   

3. Save and exit the file. Finish the installation procedure.

4. After you finish the installation procedure and view the IBM Cloud Private management console, you see
   Multicloud Manager in the navigation.

Continue with the procedure to install another cluster and enable the multicluster-endpoint on that cluster.

1. Install another IBM Cloud Private cluster, which becomes your managed-cluster after configuration and installation.

2. In your config.yaml file for the new IBM Cloud Private cluster, which is located in the /<installation_directory>/cluster folder, enable the multicluster-endpoint, as it is in the following example:

   multicluster-endpoint: enabled
   

3. Continue to create the stanza with the following settings for multicluster-endpoint:

   multicluster-endpoint: 
    klusterlet:
      apiserverConfig:
        server: <server endpoint> 
        token: <bootstrap token>
      clusterName: <cluster name>
      clusterNamespace: <cluster namespace>
   

   See the following values descriptions:

   • Hub Cluster Kubernetes API Server, or <server endpoint>: The Kubernetes API Server Endpoint for the hub-cluster.

   • Hub Cluster Kubernetes API server token, or <bootstrap token>: The Kubernetes API Server Token for the hub-cluster, which is used for the Klusterlet to communicate with the hub-cluster.

   • Cluster Name: <cluster_name> is the name for the clusters that are managed. The cluster is identified with kubectl get clusters --all-namespaces and as your managed-cluster .

   • Cluster Namespace: <cluster_namespace> is used to assign resources to the cluster within the namespace. This namespace is created automatically on both the hub-cluster and managed-cluster. This namespace is different from the Multicloud Manager Namespace in the ibm-mcm-controller chart.

   See the Prepare for installation section of Installing the IBM Multicloud Manager Klusterlet on an IBM Cloud Private for more information.

4. Save and exit the file. Finish the installation procedure.

5. Refresh the IBM Cloud Private management console. Navigate to Clusters. Click Clusters to find your <cluster name> and to verify that your cluster is a managed-cluster.