# Migrate from `vector-aggregator` guide

By default, the chart will deploy Vector as a `StatefulSet` and the default `role` option should remain "Aggregator".

There have been a number of changes to the default configuration:

- Vector's API is enabled
- A `datadog_agent` source is now included
- A `fluent` source is now included
- A `logstash` source is now included
- A `splunk_hec` source is now included
- A `statsd` source is now included
- A `syslog` source is now included
- A `console` sink is now included
- The default `prometheus_exporter` sink was renamed from "prometheus_sink" to "prom_exporter"

To keep the original defaults, use the following `customConfig`:

```yaml
customConfig:
  data_dir: /vector-data-dir
  api:
    enabled: false
  sources:
    vector:
      address: 0.0.0.0:9000
      type: vector
      version: "2"
    internal_metrics:
      type: internal_metrics
  sinks:
    prometheus_sink:
      type: prometheus_exporter
      inputs: [internal_metrics]
      address: 0.0.0.0:9090
```

## Upgrading

Once you have determined the changes you need to make to your `values.yaml` the upgrade is as simple as:

```bash
helm upgrade -f values.yaml <ORIGINAL_RELEASE_NAME> vector/vector -n <ORIGINAL_NAMESPACE>
```

## Vector values

| Old parameter                                          | New parameter                  | Comment                                                                                                     |
|--------------------------------------------------------|--------------------------------|-------------------------------------------------------------------------------------------------------------|
| `existingConfigMap` and `extraConfigDirSources`        | `existingConfigMaps`           | All ConfigMaps in the `existingConfigMaps` list are projected into Vector's configuration directory         |
| `extraContainersPorts`                                 | `containerPorts`               | Ports will be automatically generated from `customConfig` but can be manually set with `containerPorts`     |
| `global.clusterDomain` and `global.kubeDNSAddress`     | ∅                              | The paramters are set by default or by `haproxy.customConfig` or `haproxy.existingConfigMap`                |
| `globalOptions.*`                                      | ∅                              | Deprecated                                                                                                  |
| `internalMetricsSource.*`                              | ∅                              | Deprecated                                                                                                  |
| `image.version`, `image.base`                          | ∅                              | Only `image.tag` is now used to set the Vector tag                                                          |
| `imagePullSecrets`                                     | `image.pullSecrets`            |                                                                                                             |
| `logSchema.*`                                          | ∅                              | Deprecated                                                                                                  |
| `podMonitor.additionalLabels`                          | ∅                              |                                                                                                             |
| `podMonitor.extraRelabelings`                          | `podMonitor.relabelings`       | The chart adds no default relabelings                                                                       |
| `podRollmeAnnotation` and`podValuesChecksumAnnotation` | ∅                              | Replaced by `rollWorkload`, enabled by default                                                              |
| `prometheusSink.*`                                     | ∅                              | Deprecated                                                                                                  |
| `psp.enabled`                                          | `psp.create`                   |                                                                                                             |
| `rbac.enabled`                                         | `rbac.create`                  |                                                                                                             |
| `secrets.generic`                                      | ⚠️                             | `secrets.generic` now takes raw values rather than base64 encoded values                                    |
| `sinks.*`                                              | ∅                              | Deprecated                                                                                                  |
| `sources.*`                                            | ∅                              | Deprecated                                                                                                  |
| `storage.mode`                                         | ∅                              | If `persistence.enabled` a PersistentVolumeClaim will be created, unless `persistence.existingClaim` is set |
| `storage.hostPath`                                     | ∅                              | Vector running as an Aggregator no longer supports `hostPath` based storage                                 |
| `storage.managedPersistentVolumeClaim.size`            | `persistence.size`             |                                                                                                             |
| `storage.managedPersistentVolumeClaim.storageClass`    | `persistence.storageClassName` |                                                                                                             |
| `storage.existingPersistentVolumeClaim`                | `persistence.existingClaim`    |                                                                                                             |
| `transforms.*`                                         | ∅                              | Deprecated                                                                                                  |
| `vectorApi.*`                                          | ∅                              | Deprecated                                                                                                  |

## HAProxy values

| Old parameter                      | New parameter  | Comment                                                       |
|------------------------------------|----------------|---------------------------------------------------------------|
| `config`                           | `customConfig` | Default HAProxy config can be overwritten with `customConfig` |
| `mountedSecrets`                   | ∅              |                                                               |
| `podSecurityContext.*`             | ⚠️             | `podSecurityContext` now takes an object                      |
| `replicaCount`                     | `replicas`     |                                                               |
| `service.clusterIP`                | ∅              |                                                               |
| `service.loadBalancerIP`           | ∅              |                                                               |
| `service.loadBalancerSourceRanges` | ∅              |                                                               |