• HashiCorp Developer

  • HashiCorp Cloud Platform
  • Terraform
  • Packer
  • Consul
  • Vault
  • Boundary
  • Nomad
  • Waypoint
  • Vagrant
Terraform
  • Install
  • Tutorials
    • About the Docs
    • Configuration Language
    • Terraform CLI
    • Terraform Cloud
    • Terraform Enterprise
    • CDK for Terraform
    • Provider Use
    • Plugin Development
    • Registry Publishing
    • Integration Program
  • Registry(opens in new tab)
  • Try Cloud(opens in new tab)
  • Sign up
Terraform Home

Terraform Enterprise

Skip to main content
  • Terraform Enterprise

  • Overview
  • Operational Modes
    • Overview
      • Automated Recovery
      • Upgrades
      • Log Forwarding
      • Monitoring
      • Backups and Restores
      • Admin CLI Commands
      • Terraform Cloud Agents on TFE
      • Alternative Worker to Agent Migration
      • Demo to Mounted Disk Migration
  • Migrating to Terraform Enterprise
  • Support

  • Terraform Cloud Agents

  • Resources

  • Tutorial Library
  • Certifications
  • Community Forum
    (opens in new tab)
  • Support
    (opens in new tab)
  • GitHub
    (opens in new tab)
  • Terraform Registry
    (opens in new tab)
  1. Developer
  2. Terraform
  3. Terraform Enterprise
  4. Administration
  5. Infrastructure
  6. Demo to Mounted Disk Migration
  • Terraform Enterprise
  • v202212-2
  • v202212-1
  • v202211-1
  • v202210-1
  • v202209-2
  • v202209-1
  • v202208-3
  • v202208-2
  • v202208-1
  • v202207-2
  • v202207-1
  • v202206-1

»Migrating from Demo Mode to Mounted Disk Mode

Terraform Enterprise removed the Demo operational mode in v202204-1. We strongly recommend upgrading your instance from Demo mode to Mounted Disk mode.

If you are currently running Demo mode and wish to upgrade to Terraform Enterprise v202204-1, you must migrate your application data from the Demo mode Docker volumes to the Mounted Disk directory.

Determining the Operational Mode

Connect to your Terraform Enterprise instance and run the following command.

replicatedctl app-config export --template '{{ .installation_type.Value }}'

If Terraform Enterprise returns the value poc, you are running Demo mode and must migrate your application data to the mounted disk directory.

Data Migration is Required

Terraform Enterprise will fail to start with the following error until you migrate your application data.

Unmet start requirement: Required setting "Mounted Disk Path" is not set.

If you run replicatedctl app status, you see output similar to the following:

[
    {
        "AppID": "f9486004126d40904381e029d76353d0",
        "Sequence": 609,
        "PatchSequence": 0,
        "State": "stopped",
        "DesiredState": "started",
        "Error": "Unmet start requirement: Required setting \"Mounted Disk Path\" is not set.",
        "IsCancellable": false,
        "IsTransitioning": false,
        "LastModifiedAt": "2022-04-11T21:02:18.613686589Z"
    }
]

The Replicated console also shows the error message saying Unmet start requirement: Required setting "Mounted Disk Path" is not set. As a result, you must migrating your application data from Demo Mode to Mounted Disk Mode.

Migrating Application Data From Demo Mode to Mounted Disk Mode

  1. Connect to your Terraform Enterprise instance.

  2. Create the mounted disk directory. You can choose any directory, but Terraform Enterprise expects that the directory is backed by persistent storage that can be mounted to the instance.

    mkdir -p /opt/terraform-enterprise
    
  3. Set the disk_path application setting to the mounted disk directory.

    replicatedctl app-config set disk_path --value '/opt/terraform-enterprise'
    
  4. Migrate the PostgreSQL data to the mounted disk directory.

    1. Create the postgres directory under the mounted disk directory.

      mkdir -p /opt/terraform-enterprise/postgres
      
    2. Retrieve the PostgreSQL data path from the Docker volume.

      demo_database="$(docker volume inspect postgres --format '{{ .Mountpoint }}')"
      
    3. Migrate the PostgreSQL data to the mounted disk directory.

      cp -r "${demo_database}"/* /opt/terraform-enterprise/postgres
      
    4. Mark the PostgreSQL data as migrated.

      touch /opt/terraform-enterprise/postgres/.poc-to-disk-migrated
      
  5. Migrate the object storage data to the mounted disk directory.

    1. Create the aux directory under the mounted disk directory.

      mkdir -p /opt/terraform-enterprise/aux
      
    2. Retrieve the object storage data path from the Docker volume.

      demo_object_storage="$(docker volume inspect aux --format '{{ .Mountpoint }}')"
      
    3. Migrate the object storage data to the mounted disk directory.

      cp -r "${demo_object_storage}"/* /opt/terraform-enterprise/aux
      
    4. Mark the object storage data as migrated.

      touch /opt/terraform-enterprise/aux/.poc-to-disk-migrated
      
  6. Restart Terraform Enterprise to apply the changes and start the application in Mounted Disk mode.

    1. Stop Terraform Enterprise.

      replicatedctl app stop
      
    2. Wait for Terraform Enterprise to stop. Terraform Enterprise is stopped once the State shows stopped.

      replicatedctl app status
      
    3. Start Terraform Enterprise.

      replicatedctl app start
      
Edit this page on GitHub

On this page

  1. Migrating from Demo Mode to Mounted Disk Mode
  2. Determining the Operational Mode
  3. Data Migration is Required
  4. Migrating Application Data From Demo Mode to Mounted Disk Mode
Give Feedback(opens in new tab)
  • Certifications
  • System Status
  • Terms of Use
  • Security
  • Privacy
  • Trademark Policy
  • Trade Controls
  • Give Feedback(opens in new tab)