Installation Guide

Gettinng started with Metamorph (Standalone)

Contents

• Installation Guide
• Prerequisites
• Requirements
• Optional
• Setting up Metmorph
• Troubleshooting

Prerequisites

Requirements

• Linux
• kustomize
• Go
• [Git]

Optional

• [jq]

Setting up Metmorph

1. Download the latest and applicable version of Metamorph from using the following command

   git clone https://github.com/bm-metamorph/MetaMorph.git

2. Build the Metamorph executable This should result in a metamorph executable build in the <Metamorph directory>

   cd <Metamorph directory> go build -o metamorph main.go

3. Ensure config.yaml is properly populated.

4. Export environment variable METAMORPH_CONFIGPATH to match the location of config.yaml

   export METAMORPH_CONFIGPATH="<Location of config.yaml>"

5. Run Metamorph controller using the following command

   ./metamorph controller

6. Check the logs to ensure controller has started and is working fine.

7. Open another seperate terminal and navigate to the <Metamorph directory>. Export the environmental variable METAMORPH_CONFIGPATH as specified above. Run the following command to start the Metamorph API server

   ./metamorph api

8. Check the logs to ensure API server has started and is working fine.

Troubleshooting

Please refer to the [troubleshooting guide][troubleshooting].