Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Installing AppFormix for a Kubernetes Cluster

    Getting Started with Kubernetes

    AppFormix provides resource control and visibility for hosts, pods, containers, services, and more in a Kubernetes cluster.

    This topic explains how to install AppFormix for a Kubernetes cluster. See the AppFormix General Requirements before reading this section.

    Requirements

    • Supported Kubernetes versions: 1.2

    Workflow in Two Steps

    Installation consists of the following steps:

    1. Install AppFormix.
    2. Configure AppFormix.

    Installing AppFormix

    Ansible is used to deploy the software to the compute node(s) and the controller host.

    An Ansible inventory file describes groups of hosts in your cluster. AppFormix requires two groups compute and appformix_controller. For example:

        [appformix_controller]
        appformix01
    
        [compute]
        compute01
        compute02
        compute03
    

    Additional options can be specified to configure how to log in to a host. See the Ansible inventory documentation.

    The following commands can be executed on the controller host, or any host that has Ansible and can access the compute node(s) and the controller host through SSH.

    1. Unpack the tarball, and change to the created directory.
      tar xzf appformix-<version>.tar.gz
      cd appformix-<version>
    2. Install components on the controller host and the compute nodes.
      ansible-playbook -i <inventory_file> appformix_kubernetes.yml

    Configuring AppFormix

    Initial configuration of AppFormix is performed using a simple, graphical installation wizard. Point your browser to the following URL, and click Install AppFormix.

    http://<Controller_Host>:9000/

    AppFormix must be configured to communicate with the OpenStack cluster. In the first window of the installation wizard, input the following settings:

    kube-apiservier URL to the Kubernetes API server

    After clicking Next, the next page requests information about where the AppFormix components are running. For single node AppFormix deployments, the fields are pre-populated with the IP address of the controller host on which the dashboard is running.

    Configuration settings for Kubernetes and AppFormix components can be changed after initial configuration by selecting Settings from the User icon drop-down list when logged in as an administrator.

    Uninstalling AppFormix from a Kubernetes Cluster

    To uninstall AppFormix:

    1. Uninstall AppFormix Agent from compute node(s):
      ansible-playbook -i <inventory_file> compute_uninstall.yml
    2. Uninstall components from the controller host:
      ansible-playbook -i <inventory_file> -e 'appformix_state=absent' appformix_kubernetes.yml

    Modified: 2017-08-27