Installing orcharhino Server (Cloud-Init)

This guide describes how to install orcharhino Server using Cloud-Init on a virtualization platform such as AWS or Proxmox VE.

This is an advanced installation method for orcharhino. Ensure to secure your orcharhino Server. Depending on the virtualization platform and configuration, it might be accessible over the Internet. For more information, see Securing orcharhino. ATIX AG recommends to inspect all involved scripts before installing orcharhino Server.

Installing orcharhino Server on AWS

You can use Terraform code to deploy your orcharhino Server in AWS. It will create a Virtual Private Cloud (VPC), Security Group, and an EC2 instance with user data from the previous step utilizing Terraform AWS modules.

Prerequisites
  • You have installed a recent version of Terraform CLI (v1.5 and higher) on your local machine.

  • You have AWS credentials with AmazonEC2FullAccess and NetworkAdministrator permissions.

  • You have access to your orcharhino Subscription Key file matching the operating system of your Amazon Machine Image (AMI).

Procedure
  1. Clone the orcharhino-cloud-init repository:

    $ git clone https://github.com/ATIX-AG/orcharhino-cloud-init.git
    $ cd ./orcharhino-cloud-init
  2. Generate your user-data file:

    $ ./build-seed -o ~/alma8.osk -a ./answers-default-aws.yaml
  3. Customize variables in terraform.tfvars according to your needs:

    $ cd ./terraform-aws
    $ cp ./terraform.tfvars.skel terraform.tfvars
  4. Set AWS environment variables:

    $ export AWS_ACCESS_KEY_ID=My_AWS_Access_Key
    $ export AWS_SECRET_ACCESS_KEY=My_AWS_Secret_Access_Key
    $ export AWS_SESSION_TOKEN=My_AWS_Session_Token
  5. Start deployment using Terraform:

    $ terraform init
    $ terraform plan
    $ terraform apply
  6. Access the instance using the tux user and check the installation progress:

    $ ssh tux@My_orcharhino_Server
    [tux@My_orcharhino_Server ~]$ journalctl -f

You can destroy your deployed infrastructure and clean up resources using Terraform:

$ terraform destroy
Next steps
  • Configure Amazon Route53 as DNS provider. For more information, see Configuring dns_route53 in Configuring External Services.

Installing orcharhino Server on Proxmox VE

You can use Terraform code to deploy your orcharhino Server in Proxmox VE utilizing Terraform Provider Proxmox.

Prerequisites
  • You have installed a recent version of Terraform CLI (v1.5 and higher) on your local machine.

  • You have access to a Proxmox VE server.

  • You have a VM template. For more information, see Preparing Cloud-Init Templates.

  • You have access to your orcharhino Subscription Key file matching the operating system of the VM template.

Procedure
  1. Clone the orcharhino-cloud-init repository:

    $ git clone https://github.com/ATIX-AG/orcharhino-cloud-init.git
    $ cd ./orcharhino-cloud-init
  2. Generate your user-data and`meta-data` files:

    $ ./build-seed -o ~/alma8.osk -a ./answers-default.yaml
  3. Customize variables in terraform.tfvars according to your needs:

    $ cd ./terraform-proxmox
    $ cp ./terraform.tfvars.skel terraform.tfvars
  4. Start deployment using Terraform:

    $ terraform init
    $ terraform plan
    $ terraform apply
  5. Access the instance using the tux user and check the installation progress:

    $ ssh tux@My_orcharhino_Server
    [tux@My_orcharhino_Server ~]$ journalctl -f

You can destroy your deployed infrastructure and clean up resources using Terraform:

$ terraform destroy