Install from AWS Marketplace
This topic explains how you can install Portworx Backup on the Amazon Web Service (AWS) Marketplace in your AWS Cloud account. After installing, you can use the same AWS Cloud account to send metering data to AWS. Also, you can back up or restore Portworx Backup data and applications for any AWS Elastic Kubernetes Service (EKS) cluster.
Prerequisite
For Portworx Backup version 2.5.1 to support backup and restore of file share storage, you must install Stork version 23.7.2.
- Make sure latest supported version of Stork in installed. For more information on installing Stork, refer Stork installation.
Configure IAM permissions with EKS cluster
You must create a IAMServiceAccount
for Portworx Backup and configure it with permissions for EKS cluster to send metering data to AWS:
Enable the
IAM OIDC Provider
for your EKS cluster. Replace the<region>
and<clustername>
parameters to match your environment.eksctl utils associate-iam-oidc-provider --region=<region> --cluster=<clustername> --approve
Update the existing
IAMServiceAccount
or create a local service account for Portworx Backup, and link it to your EKS cluster. Change thenamespace
if you are not deploying the Portworx Backup instance, and replace the<clustername>
with your EKS cluster.eksctl create iamserviceaccount --name px-backup-account --namespace px-backup --cluster <clustername> --attach-policy-arn arn:aws:iam::aws:policy/AWSMarketplaceMeteringFullAccess \
--attach-policy-arn arn:aws:iam::aws:policy/AWSMarketplaceMeteringRegisterUsage --approve --override-existing-serviceaccounts
Add Stork environment variable to point to the AWS image repository
For each EKS application cluster that you add to Portworx Backup, you must include the
MARKET_PLACE=aws
environment variable to specify that Stork version 23.9.1 be deployed on the application cluster to use the AWS registry:- name: MARKET_PLACE
value: aws
Stork uses this environment variable to pick the appropriate Kopia executor image from the AWS Marketplace repository.
Install Portworx Backup on AWS
You can install Portworx Backup on AWS Marketplace using the px-central
Helm chart:
Add the Portworx AWS Helm chart:
helm repo add aws-portworx https://raw.githubusercontent.com/portworx/aws-helm/master/stable
Install Portworx Backup using the Helm chart. Replace
<release-name>
with the Portworx Backup version you want to install. Refer to the Portworx Backup Helm chart reference for more information about the configurable parameters.helm install <release-name> aws-portworx/px-central --namespace px-backup --set persistentStorage.enabled=true,persistentStorage.storageClassName=gp2,pxbackup.enabled=true --create-namespace
noteYou can override the default administrator password, and set a custom password to access the Portworx Backup user interface using the
oidc.centralOIDC.defaultPassword
option.
Access Portworx Backup UI using load balancer endpoint
In addition to accessing Portworx Backup from the CLI, you can access it on a Web browser using the load balancer endpoint:
Get the load balancer endpoint for Portworx Backup using one of the following commands:
kubectl get ingress --namespace {{ .Release.Namespace }} px-backup-ui -o jsonpath="{.status.load balancer.ingress[0].hostname}"`
kubectl get ingress --namespace {{ .Release.Namespace }} px-backup-ui -o jsonpath="{.status.load balancer.ingress[0].ip}"`
Access Portworx Backup and Keycloak using the endpoint:
http://<LB_endpoint>
http://<LB_endpoint>/auth
Uninstall Helm chart
Perform the following steps to uninstall px-central
Helm chart:
Uninstall the Helm chart:
helm delete px-central --namespace px-backup
Cleanup secrets and pvc created by Portworx Backup:
kubectl delete ns px-backup