//Cloudogu EcoSystem Docs

Installing the exporter in a CES-MN instance

To transfer the data and configurations from a CES-MN instance to a new CES-MN instance, an exporter application (Exporter) must be installed and configured on the source instance. This exporter is controlled by the importer on the target instance. It collects and transfers the data and configurations of the source instance. Once the final migration is complete, the exporter puts the source instance into maintenance mode.

Check prerequisites

  • The source instance is a CES-MN instance.
  • An SSH key pair is required.

    • A public key is required for the exporter.
    • This key pair can be generated with ssh-keygen.
    • The SSH key pair must not require a passphrase.
  • An API key is also required.

    • The key can be generated individually with any characters.
    • The API key may have a length of 8 to 128 characters.
    • The API key is also required for the installation of the importer on the target instance.
  • The instance is accessible via the ports 443 and 7022.

Install exporter

  1. connect to your instance (command line) by setting the Kubernetes context accordingly.
  2. create a Kubernetes secret with the API key:

    kubectl -n ecosystem create secret generic ces-exporter-api --from-literal=apiKey=<my-api-key>
  3. install the ces-exporter by applying the following YAML in the cluster:

    apiVersion: k8s.cloudogu.com/v1
    kind: Component
    metadata:
    labels:
    app: ces
    name: ces-exporter
    namespace: ecosystem
    spec:
    name: ces-exporter
    namespace: k8s
    version: 1.0.0
    valuesYamlOverwrite: |
    env:
      exportCron: <The schedule to activate the export-mode for dogus in server time. E.g. every night at 02:00: "0 2 * * *">
    publicKey:
      data: |-
        <The public key as a string>
  4. check whether the component is ready:

    kubectl get component ces-exporter

Configuration

All values of the exporter can be configured with the valuesYamlOverwrite. A detailed description of the individual configuration values can be found under Reference: Configuration of the CES-MN exporter

After making changes to the configuration, you should restart the exporter so that the configuration is applied.