ibm xcat #4

Description

xCAT enables you to easily manage large number of servers for any type of technical computing workload.
xCAT is known for exceptional scaling, wide variety of supported hardware and operating systems,
virtualization platforms, and complete .day0. setup capabilities.

Charm for IBM xCAT v2.1.1

Overview

xCAT is Extreme Cluster/Cloud Administration Toolkit, xCAT offers complete management for HPC clusters, RenderFarms, Grids, WebFarms, Online Gaming Infrastructure, Clouds, Datacenters, and whatever tomorrow's buzzwords may be. It is agile, extensible, and based on years of system administration best practices and experience. It enables you to:

  • Provision Operating Systems on physical or virtual machines: RHEL, CentOS, Fedora, SLES, Ubuntu, AIX, Windows, VMWare, KVM, PowerVM, PowerKVM, zVM.
  • Provision using scripted install, stateless, statellite, iSCSI, or cloning
  • Remotely manage systems: lights-out management, remote console, and distributed shell support
  • Quickly configure and control management node services: DNS, HTTP, DHCP, TFTP, NFS

Ensure to run this charm on release that has xCAT support. The minimum release expected is trusty.

For More information on xCAT visit here

Usage

This charm installs the basic IBM xCAT application on either Ubuntu x86 or Power machines which can be used as a KVM machine to manage VM's.

Note: Managing docker container feature of xCAT is not avilable, will be available in the upcoming releases and hence it is not available in this charm also.

Deploy

The user can deploy IBM xCAT as shown below:

juju deploy ibm-xcat

The user should browse the Quick Start guide for customization steps in the link

Post Installation of IBM-xCAT user can create stateless node by running the below action command. Here the term stateless or diskless node is a node where the operating system is installed into memory.

The state of the machine is held in memory (RAM) and will not persist on subsequent reboots of the node. The state will return to what has been set in the master image.

juju run-action ibm-xcat/0 create-vm-stateless \
kvm-host="<IP Address of the KVM host where the VM's will be created>" \
kvm-root-password="<root password of kvm-host machine>" \
kvm-bridge="<Name of the bridge interface of kvm>" \
vm-name="<Name of the VM to be created>" \
vm-ip="<IP of the VM. It should be one of the unused IP from kvm-bridge network>" \
vm-cpu="<Number of CPU's for the VM>" \
vm-mem="<2048>" \
vm-image="<ISO of the osimage from which stateless compute node will be started the VM>" \
vm-pkgdir="Operating system's iso image repository for creating stateless image"

In the above command kvm-host, kvm-root-password, and vm-ip has to be passed while running the action command. And rest of the parameter values could make use of default values if it is not set.

Verify xCAT installation

Post deployment, Access to the container is achieved as in the example below.

juju ssh ibm-xcat/0

Login to the container as a root user then run the below commands to verify xCAT installation.

  • Add xCAT commands into your path

    source /etc/profile.d/xcat.sh
    
  • To display the installed version of xcat

    lsxcatd -a
    
  • To view the site table contents

    tabdump site
    

IBM xCAT Information

(1) General Information

General Information on IBM xCAT available here

(2) Contact Information

For issues with this charm, please contact IBM Juju Support Team jujusupp@us.ibm.com

(3) Known Limitations

This charm makes use of Juju features that are only available in version 2.0 or greater.

Configuration

license_accepted
(boolean) Some IBM charms require acceptance of a license before installation can proceed. If required, setting this option to True indicates that you have read and accepted the IBM terms and conditions found in the license file referenced by the charm.
curl_url
(string) Location of the IBM product installation file(s). This should be a URL that curl can use to download files. Multiple URLs should be separated by a space. NOTE: cryptographic verification is required and must be specified as part of the URL query string with the key a valid hash algorithms md5, sha256, or sha512, and the the checksum value itself (http://<url>?[md5|sha256|sha512]=<checksum>). For example: 'http://example.com/file.tgz?sha256=<sum>' 'sftp://example.com/file1.tgz?md5=<sum> ftp://example.com/file2.tgz?md5=<sum>'
package_status
(string) The status of service-affecting packages will be set to this value in the dpkg database. Valid values are "install" and "hold".
install
extra_packages
(string) Space separated list of extra deb packages to install.
curl_opts
(string) The options passed to the 'curl' command when fetching files from curl_url. For example: '-u <user:password>'
install_keys
(string) List of signing keys for install_sources package sources, per charmhelpers standard format (a yaml list of strings encoded as a string). The keys should be the full ASCII armoured GPG public keys. While GPG key ids are also supported and looked up on a keyserver, operators should be aware that this mechanism is insecure. null can be used if a standard package signing key is used that will already be installed on the machine, and for PPA sources where the package signing key is securely retrieved from Launchpad.
- | -----BEGIN PGP PUBLIC KEY BLOCK----- Version: GnuPG v2.0.9 (GNU/Linux) mQGiBFSszWwRBADNkKKBDJT0HuAsga06rauS35lw1XMYdkh3eYWMzafs/r0hQgqx +6nNWWiRMCFXKoNBB7TrxnH2f1eV869HsDYBO6IXkhrFurFYfgZL3MEocUI/YQ8R 0l/sexExVGUQNdPMHmadguSXgotUwcv1z9tXW/w4xYk4Yy6Cwu26iBlq2wCgj0kT UZmu7JsD2Qii7sL0UYoGDOUD/0XEYRxDVDm9kWJbnIYlIrs6HJnzp6uFuhhA2yPF cmk1aBb1hcZMlbA6HxsXDHBZiC6pGSomVsPxCJyuWYHhCOAqkKZdPGsa+HLjfIqN uEh/CoK3TSAmPYa+aJA/ofcO2CgUwnAOVNb7r3tSuygV7nIi9vpwFEEmxT+E2ShY PzumBACnuZpdI1bczp6kmQI+Dgn2e8o/bjrJ8ToZkA7ZTkK35bxtxNhvhgUpo5AQ hsKvGb0gQ1CZOJFRev9iP3s/Tua6xPt0nAetJZbxK1E3hNcg+FuSomRHjerMg/yY uoGHIwVZgFjdIJ7D7Y8a4xV3ujUdPWP9sw4VeTI1OUgDQtply7QjeENBVCBTZWN1 cml0eSBLZXkgPHhjYXRAY24uaWJtLmNvbT6IYAQTEQIAIAUCVKzNbAIbAwYLCQgH AwIEFQIIAwQWAgMBAh4BAheAAAoJEGCj6azGVlvJQ2sAn2eEoSFQlwnBabq+fHay nyWaDq4DAJ9l1Nk2Kl6Ui2t2rRPduiKeuonIgLkCDQRUrM1sEAgAkj5RDSFRa0Om RrxXtvZHbywbbJ7+I86wdRK1KIq67ZwtuOv0V8r0KnxhQVqRmhP4nv7PbesPyF6e 5kfZ9A7jVvasyRg5JDyqCGGjRAirZXzNORUGzk0yC5GaoJNZGx3DuHHehlucZlYr UcsOr42mcOwZ+oAxstRdBtWPw4VLmycKWkj1HvndbEtYdm/xdGybPRiZuaO6Ip1h hOo+MTwCbxDBtHL5iAdeBl74LhCx1bCDxZYijIZjil24oT1e4bZMsMDwwIsdRK7p 6Qsd1h1Bjb5ldlMXI6fKTbHm6MlGR+cbA/2xzRf1Gd8xnlcL60x5qDVEH+wKH5AV LA8EPaOI9wADBQf8CRSthdwCmf+Uo7GHlfsCNh4N/72b7/eP09N4w4FdqpmW9GWM xNmOB4n0gsH/xQIBjeavpugHQDna+37U0Ez0FbMG/kU/5aS2lU6+oYvl+q//hRpA qgr8jVwVqhzu2qaZvxuTSv22jZhCHZyIKUzTwjlHTR78qyvXvzyUpBt996fPkDNj A+rS/Y19pmZHh+8w6TwIsuqC8K7wUasDzO5T3TGIfT/lqqT1nlT3on6SSK9YXoXE GitIGQwZXhDdHcoHcI9RNxdfDIcHoCOjUdZCnKD03hxLF4i3lMh/6J7rBDPMreqh WsVltt8ZiFrN3VXlnBC5ivNY3h3DKXuuLdLDWIhJBBgRAgAJBQJUrM1sAhsMAAoJ EGCj6azGVlvJYS8An2DLTHZVjuZ8TicdevZSZTuA3qj0AJ9GkvZDZMpX1UiJGlZ+ 9ywfCgbjcQ== =UMyq -----END PGP PUBLIC KEY BLOCK----- -----BEGIN PGP PUBLIC KEY BLOCK----- Version: GnuPG v1.4.5 (GNU/Linux) mQGiBEhk3UsRBADVYqwh28ZnuktVsHK3YFPjdK+NEmEfitsbDsTFAX02hLAJPjM6 V+o0hJKXoqHW4w9ZfYds+KiBSAxsbnBsObwVjw8VpztdozLBCh+Ld48PyeZ6bLez 0iac9Wj9s+0alug+EUZggZwskDKqngsZ5iX6VGrlXn5DuRyUv9fOEgGgOwCgzuPc RF7IyyTS1R+biMPtb+8BxAkD/2pI+wYULGVb6CQgNZ10V/BJ3RUh7UiYtlMgfzJ1 kedapbXuZ885uAMXB7UPSJoaKVbP+nDOfNa1tANwNKuDgbh+mxvlKna9hbjmtYhQ MgOvUK3vFL+4w3QgyH1ec+Wof75+s+oTBFK3bC9rXYi81f3x22r7r5vpPkEKjtUj QFuVA/40vmDI0N3pFcG5BquZ2+S0EXTBsTJywkAI69NzuSTJLe03m90OjEi40Dil hefWHP3oYJm0RErCtUCJMDSPm1E5N6IkKZcQLVhlRFq3Wh9fSdnAPc0ffWOiuZFS hTjKcQLhGXedMlTPxdSjlC4fljzbuUlG4Ak9qhbpOBF4iEShT7QkSmFycm9kIEpv aG5zb24gPGpiam9obnNvQHVzLmlibS5jb20+iGAEExECACAFAkhk3UsCGwMGCwkI BwMCBBUCCAMEFgIDAQIeAQIXgAAKCRAg5HWo2nNsaKK1AKDHVv0Oh6QrwM4RU8Bd J2E4cBIwswCgxUSdizrkbgsQ5lG5tHO9aTbD8W25Ag0ESGTdVxAIANxDZDKjJZUw jzvHtmvxTfNxhHQhpq2K48irIBVtyNVrlFYYcuY3fwX5qUtTJqVGKE50zgsxZrqt o2RML2cPmyITHyB7cnYe337dT3aD+/KAnAH7DuhUMEMKtmY7WRsAUMCkDJ4Y3gMC BAP/HerQe3peEz8XIi7+FHawCFj4OdtFvyavGwp055njH71aBoShrEBDf/S9Xx7i vT06GEX6a3HkeaAUAH0cM7rgMxzHkCGAN6oliSTrnpTsVexJ68Xi99cz+hEucYil +5bRY5zU08DI1P4z3tdSCJSj7YNgXbpYA1KWouDBDiYMDmOm2hUTWZ2mMNEe5pyv HronDf370x8AAwcH/3zR29vhi1AHCzkpx8T3FIagjk6eHMmuMht0Z7rVix+r7iTP XsFEZAxMh2gMs2rXJBLZATjjiqnZ21leU5/8AftIMyqWQM0Ev64t0HrftD7Enj2L ZKTvpM//WDhXYqDeBcu/B7nQQS5sDi6bsSWc5at49Fj2VgY8Ly/V06IGcVHYiENI HgBGjGtoLaiLw61J1xNsH/LeaTWwJSalmnARpieOj+lQJi7w6mryLpn2ny/ds38B pgnAEvIW6vHK7TzzfuEZBAk3OMGgxyxbIRp4RXTOLu0eFC+XrUH/ubTKoyW40yh/ vjjFAUoMxFNU87pQ7EoT1VRvRgmtSXbO/BVOQRKISQQYEQIACQUCSGTdVwIbDAAK CRAg5HWo2nNsaBhHAKCoBltVVPyoaOvEqClPNugwg4K+GQCfab/e9e0S133BxaQE PkKeSdN44us= =IR/6 -----END PGP PUBLIC KEY BLOCK----- - | -----BEGIN PGP PUBLIC KEY BLOCK----- Version: GnuPG v2.0.9 (GNU/Linux) mQGiBFSszWwRBADNkKKBDJT0HuAsga06rauS35lw1XMYdkh3eYWMzafs/r0hQgqx +6nNWWiRMCFXKoNBB7TrxnH2f1eV869HsDYBO6IXkhrFurFYfgZL3MEocUI/YQ8R 0l/sexExVGUQNdPMHmadguSXgotUwcv1z9tXW/w4xYk4Yy6Cwu26iBlq2wCgj0kT UZmu7JsD2Qii7sL0UYoGDOUD/0XEYRxDVDm9kWJbnIYlIrs6HJnzp6uFuhhA2yPF cmk1aBb1hcZMlbA6HxsXDHBZiC6pGSomVsPxCJyuWYHhCOAqkKZdPGsa+HLjfIqN uEh/CoK3TSAmPYa+aJA/ofcO2CgUwnAOVNb7r3tSuygV7nIi9vpwFEEmxT+E2ShY PzumBACnuZpdI1bczp6kmQI+Dgn2e8o/bjrJ8ToZkA7ZTkK35bxtxNhvhgUpo5AQ hsKvGb0gQ1CZOJFRev9iP3s/Tua6xPt0nAetJZbxK1E3hNcg+FuSomRHjerMg/yY uoGHIwVZgFjdIJ7D7Y8a4xV3ujUdPWP9sw4VeTI1OUgDQtply7QjeENBVCBTZWN1 cml0eSBLZXkgPHhjYXRAY24uaWJtLmNvbT6IYAQTEQIAIAUCVKzNbAIbAwYLCQgH AwIEFQIIAwQWAgMBAh4BAheAAAoJEGCj6azGVlvJQ2sAn2eEoSFQlwnBabq+fHay nyWaDq4DAJ9l1Nk2Kl6Ui2t2rRPduiKeuonIgLkCDQRUrM1sEAgAkj5RDSFRa0Om RrxXtvZHbywbbJ7+I86wdRK1KIq67ZwtuOv0V8r0KnxhQVqRmhP4nv7PbesPyF6e 5kfZ9A7jVvasyRg5JDyqCGGjRAirZXzNORUGzk0yC5GaoJNZGx3DuHHehlucZlYr UcsOr42mcOwZ+oAxstRdBtWPw4VLmycKWkj1HvndbEtYdm/xdGybPRiZuaO6Ip1h hOo+MTwCbxDBtHL5iAdeBl74LhCx1bCDxZYijIZjil24oT1e4bZMsMDwwIsdRK7p 6Qsd1h1Bjb5ldlMXI6fKTbHm6MlGR+cbA/2xzRf1Gd8xnlcL60x5qDVEH+wKH5AV LA8EPaOI9wADBQf8CRSthdwCmf+Uo7GHlfsCNh4N/72b7/eP09N4w4FdqpmW9GWM xNmOB4n0gsH/xQIBjeavpugHQDna+37U0Ez0FbMG/kU/5aS2lU6+oYvl+q//hRpA qgr8jVwVqhzu2qaZvxuTSv22jZhCHZyIKUzTwjlHTR78qyvXvzyUpBt996fPkDNj A+rS/Y19pmZHh+8w6TwIsuqC8K7wUasDzO5T3TGIfT/lqqT1nlT3on6SSK9YXoXE GitIGQwZXhDdHcoHcI9RNxdfDIcHoCOjUdZCnKD03hxLF4i3lMh/6J7rBDPMreqh WsVltt8ZiFrN3VXlnBC5ivNY3h3DKXuuLdLDWIhJBBgRAgAJBQJUrM1sAhsMAAoJ EGCj6azGVlvJYS8An2DLTHZVjuZ8TicdevZSZTuA3qj0AJ9GkvZDZMpX1UiJGlZ+ 9ywfCgbjcQ== =UMyq -----END PGP PUBLIC KEY BLOCK----- -----BEGIN PGP PUBLIC KEY BLOCK----- Version: GnuPG v1.4.5 (GNU/Linux) mQGiBEhk3UsRBADVYqwh28ZnuktVsHK3YFPjdK+NEmEfitsbDsTFAX02hLAJPjM6 V+o0hJKXoqHW4w9ZfYds+KiBSAxsbnBsObwVjw8VpztdozLBCh+Ld48PyeZ6bLez 0iac9Wj9s+0alug+EUZggZwskDKqngsZ5iX6VGrlXn5DuRyUv9fOEgGgOwCgzuPc RF7IyyTS1R+biMPtb+8BxAkD/2pI+wYULGVb6CQgNZ10V/BJ3RUh7UiYtlMgfzJ1 kedapbXuZ885uAMXB7UPSJoaKVbP+nDOfNa1tANwNKuDgbh+mxvlKna9hbjmtYhQ MgOvUK3vFL+4w3QgyH1ec+Wof75+s+oTBFK3bC9rXYi81f3x22r7r5vpPkEKjtUj QFuVA/40vmDI0N3pFcG5BquZ2+S0EXTBsTJywkAI69NzuSTJLe03m90OjEi40Dil hefWHP3oYJm0RErCtUCJMDSPm1E5N6IkKZcQLVhlRFq3Wh9fSdnAPc0ffWOiuZFS hTjKcQLhGXedMlTPxdSjlC4fljzbuUlG4Ak9qhbpOBF4iEShT7QkSmFycm9kIEpv aG5zb24gPGpiam9obnNvQHVzLmlibS5jb20+iGAEExECACAFAkhk3UsCGwMGCwkI BwMCBBUCCAMEFgIDAQIeAQIXgAAKCRAg5HWo2nNsaKK1AKDHVv0Oh6QrwM4RU8Bd J2E4cBIwswCgxUSdizrkbgsQ5lG5tHO9aTbD8W25Ag0ESGTdVxAIANxDZDKjJZUw jzvHtmvxTfNxhHQhpq2K48irIBVtyNVrlFYYcuY3fwX5qUtTJqVGKE50zgsxZrqt o2RML2cPmyITHyB7cnYe337dT3aD+/KAnAH7DuhUMEMKtmY7WRsAUMCkDJ4Y3gMC BAP/HerQe3peEz8XIi7+FHawCFj4OdtFvyavGwp055njH71aBoShrEBDf/S9Xx7i vT06GEX6a3HkeaAUAH0cM7rgMxzHkCGAN6oliSTrnpTsVexJ68Xi99cz+hEucYil +5bRY5zU08DI1P4z3tdSCJSj7YNgXbpYA1KWouDBDiYMDmOm2hUTWZ2mMNEe5pyv HronDf370x8AAwcH/3zR29vhi1AHCzkpx8T3FIagjk6eHMmuMht0Z7rVix+r7iTP XsFEZAxMh2gMs2rXJBLZATjjiqnZ21leU5/8AftIMyqWQM0Ev64t0HrftD7Enj2L ZKTvpM//WDhXYqDeBcu/B7nQQS5sDi6bsSWc5at49Fj2VgY8Ly/V06IGcVHYiENI HgBGjGtoLaiLw61J1xNsH/LeaTWwJSalmnARpieOj+lQJi7w6mryLpn2ny/ds38B pgnAEvIW6vHK7TzzfuEZBAk3OMGgxyxbIRp4RXTOLu0eFC+XrUH/ubTKoyW40yh/ vjjFAUoMxFNU87pQ7EoT1VRvRgmtSXbO/BVOQRKISQQYEQIACQUCSGTdVwIbDAAK CRAg5HWo2nNsaBhHAKCoBltVVPyoaOvEqClPNugwg4K+GQCfab/e9e0S133BxaQE PkKeSdN44us= =IR/6 -----END PGP PUBLIC KEY BLOCK-----
install_sources
(string) List of extra apt sources, per charm-helpers standard format (a yaml list of strings encoded as a string). Each source may be either a line that can be added directly to sources.list(5), or in the form ppa:<user>/<ppa-name> for adding Personal Package Archives, or a distribution component to enable.
- deb http://xcat.org/files/xcat/repos/apt/2.11/xcat-core trusty main - deb https://xcat.org/files/xcat/repos/apt/xcat-dep trusty main