New Application Setup - csap-platform/csap-core GitHub Wiki

Contents:

CSAP Distribution

Hosts are installed using the csap-host-xx.zip file:

  • the initial host in a given locale/site can be installed using docker (ref. Docker Images)
    • subsequent installs may utilize the initial host as a local installer (ref. Training)

Alternately - check out all of the CSAP git repositories - and perform builds using maven (optionally add jenkins jobs).

First host install

The Docker Images includes a fully encapsulated image csapplatform/demo. The image includes a fully enabled Host Portal complete with the ability to edit files, run scripts, etc. It can be used to perform the install of either:

  • a "generic" host that can be used for all future applications.
  • a single node "all in one" kubernetes host
  • a multi node kubernetes cluster
  • ANY configuration of ANY number of services/hosts can be done by creating/modifying the Csap Autoplay template

Install Steps

New csap application workflow:

  • Install your first host using a default application profile
  • Using CSAP editor: customize with application name, git location, etc. - check in to git.
  • Using CSAP editor: add clusters, and hosts incrementally - checking into git frequently
  • Optional: add CSAP Events Setup

Host Configuration

OS:

It is strongly recommended to install using a minimal profile to minimize conflicts with the dependency requirements of the application

Physical:

  • depending on application needs, general purpose: 16 cpu cores, 32gb memory

  • disk: /var (10g), /var/lib/docker(ext4 - 70g) , /var/lib/kubelet(ext4 - 30g), /opt(ext4 - 25g)

  • xfs usage note (kubernetes&docker)

Prerequisites

  • Recommended services
    • GIT repository: used to provide change management for application configuration
    • Use of hosted or private supported: https://bitbucket.org/sensusanalytics-dev/nm-devops.git
    • LDAP configuration:
      • url: ldap://ldap.davis.sensus.lab:389, directory-dn: search:uid={0}, search-user: ou=People,dc=flexnet,dc=net,search-groups: ou=Groups,dc=flexnet,dc=net
    • yum repos: docker and kuberetes default to using public internet repositories. Recommend: add local internal repostories.
  • Root install access:
    • while csap runs as non root, install access is required for docker, kubernetes, etc. Installation logs detail 100% of changes.
    • $(hostname --long) != $(hostname --short) : hostname should be configured to be a resolvable entry

Network Security

Typical configuration for management/operations team access:

  • csap agent: 8011; admin portal: 8021; webserver 80/8080;

Alternate host install

# Copy and paste at root 

# Install docker
yum --assumeyes install docker unzip wget

# cleaning up previous installs
cd $HOME; rm --recursive --force --verbose csap*.zip* *linux.zip installer ;

# gets the csap-host.zip
mkdir dist;
docker run \
	--rm \
	--name csap-installer \
	--volume=$(pwd)/dist:/transfer \
	csapplatform/installer 

cp dist/* . ; rm --recursive --force dist ;

# extract installer
unzip  -j csap-host-*.zip csap-platform/packages/csap-package-linux.zip &&  unzip -qq csap-package-linux.zip installer/*


# Get the installer from artifactory: NOTE: update url to the DC location
# snapshot="http://xxx.your-maven.com:8081/artifactory/csap-snapshots/org/csap/csap-host/2-SNAPSHOT/csap-host-2-SNAPSHOT.zip"
# release="http://xxx.your-maven.com:8081/artifactory/csap-release/org/csap/csap-host/2.1.5x/csap-host-2.1.5x.zip"

# wget $release;
⚠️ **GitHub.com Fallback** ⚠️