Table of Contents
- xcatexport Input Args
- xcatexport Function
- xcatimport Input Args
- xcatimport Function
- Restrictions and Assumptions
- Optional Behaviour or Uses
- Other Design Considerations
The purpose of these new cmds is to be able to take a picture/snapshot of an xcat mgmt node (everything but the base distro) and put it on a usb stick (or dvd, or directory) and be able to restore it to another machine with a single cmd. One use for this is if manufacturing set up a customer cluster config (to configure and test all of the hw), then before breaking it down and sending to the customer, they could do xcatexport to a usb stick. Then at the customer site, they physically hook up the hw, install the distro on the mn, put the usb stick in and run xcatimport, and then deploy the nodes. (There have been some schemes in the past that people have tried that included the whole os in the snapshot, but this gets into legal problems i don't want to deal with.) This would also be useful for the many solutions that will be using xcat. And could even be useful if you just want to replace the hw of your mn.
xcatexport Input Args
- the location of xcat rpms (including deps) that were used to install xcat on the MN. Need to handle the case in which the admin has placed them in an otherpkgs dir under /install. If the MN was installed directly from SF, then point to the specific URL that was used.
- Where to put the snapshot (usb drive, dir, etc.)
xcatexport Function
- tar up: rpms, db, /install, /tftpboot, /etc/xcat, all the conf files (dhcp, dns, conserver, etc), keys/certs (what else)
- probably need to exclude the diskless image initrds, kernels, and rootimgs (for both size and legal reasons)
- is there anything else in /opt/xcat that users can modify/customize that needs to be save?
- dumpxCATdb
- on the usb stick, probably have 3 files: xcatimport cmd (stand alone), xcat rpm tarball, tarball of the dirs/files/db
xcatimport Input Args
- It has been suggested that we add an arg specific putting to the config on a backup MN for HA (like skip the db). But i'm not sure we need to support this if MN pools will be our primary HA approach.
xcatimport Function
- untar rpms, set up yum repos in /etc/yum.repos.d or in zypper, and install them (the user must have previously set up a yum repo for the distro rpms)
- untar other dirs
- run db setup script (needs to be made tolerant of cfgloc being there)
- restorexCATdb
- what make/mk cmds need to be run? If we capture the config files from the original MN, might not have to do this
- start daemons (are there any that don't get auto started during installation?)
Restrictions and Assumptions
- export/import must be done on same distro level and arch
- the user has to get the xcat & dep rpms. Either they should have originally installed from the downloaded tarballs, or they have to make sure they grab the same rpms they installed from the internet, or point to the correct SF URL. xcatimport must be run with the same version of xcat as xcatexport, altho a different snap build within the same version is probably ok.
- we won't tar up /opt/xcat, so patches are not supported and all modified files (templates, pkg lists, etc.) must be in /install/custom
Optional Behaviour or Uses
- Integrate with PCM for their MN upgrade procedure
- Use to install the secondary MN in an HA environment? (Probably don't need this for MN pool.)
- Have a separate utility to automate changing hostnames & ip addrs of nodes, that can be run after xcatimport.
Other Design Considerations
- Required reviewers:
- Required approvers: Bruce Potter
- Database schema changes: N/A
- Affect on other components: N/A
- External interface changes, documentation, and usability issues: N/A
- Packaging, installation, dependencies: N/A
- Portability and platforms (HW/SW) supported: N/A
- Performance and scaling considerations: N/A
- Migration and coexistence: N/A
- Serviceability: N/A
- Security: N/A
- NLS and accessibility: N/A
- Invention protection: N/A
News
- Apr 22, 2016: xCAT 2.11.1 released.
- Mar 11, 2016: xCAT 2.9.3 (AIX only) released.
- Dec 11, 2015: xCAT 2.11 released.
- Nov 11, 2015: xCAT 2.9.2 (AIX only) released.
- Jul 30, 2015: xCAT 2.10 released.
- Jul 30, 2015: xCAT migrates from sourceforge to github
- Jun 26, 2015: xCAT 2.7.9 released.
- Mar 20, 2015: xCAT 2.9.1 released.
- Dec 12, 2014: xCAT 2.9 released.
- Sep 5, 2014: xCAT 2.8.5 released.
- May 23, 2014: xCAT 2.8.4 released.
- Jan 24, 2014: xCAT 2.7.8 released.
- Nov 15, 2013: xCAT 2.8.3 released.
- Jun 26, 2013: xCAT 2.8.2 released.
- May 17, 2013: xCAT 2.7.7 released.
- May 10, 2013: xCAT 2.8.1 released.
- Feb 28, 2013: xCAT 2.8 released.
- Nov 30, 2012: xCAT 2.7.6 released.
- Oct 29, 2012: xCAT 2.7.5 released.
- Aug 27, 2012: xCAT 2.7.4 released.
- Jun 22, 2012: xCAT 2.7.3 released.
- May 25, 2012: xCAT 2.7.2 released.
- Apr 20, 2012: xCAT 2.7.1 released.
- Mar 19, 2012: xCAT 2.7 released.
- Mar 15, 2012: xCAT 2.6.11 released.
- Jan 23, 2012: xCAT 2.6.10 released.
- Nov 15, 2011: xCAT 2.6.9 released.
- Sep 30, 2011: xCAT 2.6.8 released.
- Aug 26, 2011: xCAT 2.6.6 released.
- May 20, 2011: xCAT 2.6 released.
- Feb 14, 2011: Watson plays on Jeopardy and is managed by xCAT!
- xCAT Release Notes Summary
- xCAT OS And Hw Support Matrix
- xCAT Test Environment Summary
History
- Oct 22, 2010: xCAT 2.5 released.
- Apr 30, 2010: xCAT 2.4 is released.
- Oct 31, 2009: xCAT 2.3 released.
xCAT's 10 year anniversary! - Apr 16, 2009: xCAT 2.2 released.
- Oct 31, 2008: xCAT 2.1 released.
- Sep 12, 2008: Support for xCAT 2
can now be purchased! - June 9, 2008: xCAT breaths life into
(at the time) the fastest
supercomputer on the planet - May 30, 2008: xCAT 2.0 for Linux
officially released! - Oct 31, 2007: IBM open sources
xCAT 2.0 to allow collaboration
among all of the xCAT users. - Oct 31, 1999: xCAT 1.0 is born!
xCAT started out as a project in
IBM developed by Egan Ford. It
was quickly adopted by customers
and IBM manufacturing sites to
rapidly deploy clusters.