View source for Howto:Install and Upgrade the App Platform using Helm

[[Category:Howto|{{PAGENAME}}]]
<!-- Howto: Install and Upgrade the innovaphone App Platform using Helm -->

== Purpose ==

This article describes how to prepare a Helm repository and install or update the innovaphone App Platform using Helm.

=== Features ===

* Add and manage the innovaphone Helm repository
* Install a specific App Platform version
* Install the latest available App Platform version
* Upgrade an existing App Platform installation

=== Limitations ===

* Helm must be installed and configured on the target system.
* Access to the innovaphone Helm repository is required.
* A Kubernetes cluster must already be available.

== Requirements ==

* Kubernetes cluster
* Helm installed
* Network access to the innovaphone Helm repository
* Appropriate permissions to create namespaces and install applications

== Things to know before you begin ==

* The URL of the innovaphone Helm repository:
  https://helm.innovaphone.com/repository/helm
* The repository name can be chosen freely and will be required in later Helm commands.
* In the examples below, the repository name ''innovaphone'' is used.

== Configuration ==

=== Prepare the Helm Repository ===

First, check whether the required Helm repository already exists.

<code>
helm repo list
</code>

If the repository with the URL ''https://helm.innovaphone.com/repository/helm'' is already present, update all repositories to load the latest available versions.

<code>
helm repo update
</code>

Make sure to remember the repository name because it will be used in subsequent Helm commands. In the following examples, the repository name ''innovaphone'' is used.

If the repository is not present, add it using the following command:

<code>
helm repo add innovaphone https://helm.innovaphone.com/repository/helm
</code>

The name ''innovaphone'' is only an example and can be replaced with any desired repository name.

==== Display Available Versions ====

To display all available App Platform versions, use the following command:

<code>
helm search repo innovaphone -l
</code>

Replace ''innovaphone'' with the repository name you configured previously.

=== Install the App Platform ===

==== Install a Specific Version ====

If a specific App Platform version should be installed, use the following syntax:

<code>
helm install --namespace test --version 0.0.1013 ap innovaphone/app-platform
</code>

Parameter description:

* ''test'' – freely selectable namespace
* ''0.0.1013'' – example version number
* ''ap'' – freely selectable App Platform release name
* ''innovaphone'' – Helm repository name

==== Install the Latest Version ====

To always install the latest available version, omit the version parameter:

<code>
helm install --namespace test ap innovaphone/app-platform
</code>

Parameter description:

* ''test'' – freely selectable namespace
* ''ap'' – freely selectable App Platform release name
* ''innovaphone'' – Helm repository name

=== Upgrade an Existing App Platform Installation ===

If the App Platform is already installed and should be upgraded, use the following command:

<code>
helm upgrade --install -n test ap innovaphone/app-platform
</code>

Parameter description:

* ''test'' – namespace where the App Platform is installed
* ''ap'' – existing App Platform release name
* ''innovaphone'' – Helm repository name

The parameter ''--install'' ensures that the App Platform is automatically installed if no existing installation is found.

== Verification ==

* Verify that the Helm repository is listed:

<code>
helm repo list
</code>

* Verify that the App Platform release is installed:

<code>
helm list -n test
</code>

* Verify that the deployed Kubernetes resources are running:

<code>
kubectl get pods -n test
</code>

== Known issues ==

* Installation may fail if the Helm repository is unreachable.
* Insufficient Kubernetes permissions may prevent namespace creation or deployment.
* The specified App Platform version must exist in the configured repository.

== Related Articles ==
[https://wiki.innovaphone.com/index.php?title=Reference16r1:Concept_innovaphone_App_Platform_Container Reference16r1:Concept innovaphone App Platform Container]