| Info |
|---|
New in QubeInstaller v1.1 |
Synopsis
QubeInstaller kickstart files capture an interactive installation session so that it may be repeated from the command-line or script.
Each time you run the installer, a kickstart .QKS file is generated. This file will be saved next to the manifest file that was used for installation. The filename is in the format qube-component_group-install_version-kickstart.qks, e.g qube-upgrade-6.4-4-kickstart.qks or qube-worker-6.4-4-kickstart.qks. The kickstart file can be used by the installer to replicate the install/upgrade on another computer. This is an OS independent file, so you can, for example, install or upgrade across Linux, OS X, and Windows using the same kickstart file on the command line of each OS.
The kickstart file contains the list of the components that were selected for installation, uninstallation, the component group selection, and the supervisor discovery parameters if they were provided. It follows, then, that a kickstart file could be used to manage the removal of Qube components as well as it can be used for install or upgrade.
For the component group options "Upgrade Installed" or "Uninstall Everything", the exact component selection saved in the kickstart file is ignored and will be replaced at run time. For all other component group selections, the exact selections for install and uninstall will be replicated each time the kickstart file is used.
In either case, when running on the command line (without a GUI), any component that needs to be downloaded will be downloaded by the installer before it is installed. If the component has already been downloaded by one computer, it will not be downloaded again by subsequent computers (assuming the location of the manifest, and therefore individual component installation files, is on a shared file server).
To use the kickstart file, you must run the installer on the command line. In fact, the installer may only be run on the command line when used in conjunction with a kickstart file. Once the file is created, usage is quite simple:
/path/to/qubeInstaller.version.os.exe /path/to/qube-kickstart.qks
| Note | ||
|---|---|---|
| ||
On OS X, the installer is an application package. You must run the binary inside the application package in order to use command line options. The binary in the applicaiton package will be, for example, in qubeInstaller.MacOSX-x86_64.app/Contents/MacOS/qubeInstaller, in which case, an OS X user would run the above command as:
|
Upgrading an entire farm via command-line
As mentioned above, the "Upgrade Installed" and "Uninstall Everything" component group options will make the installer evaluate the component selection at runtime. If one wanted to upgrade all Qube computers in a farm, they would simply run an upgrade install on a single computer (choosing the "Upgrade Installed" component group) then run the installer at the command-line on every other machine with the qube-upgrade-6.x-x.qks file that was generated by the installer. Even if one machine is a supervisor, a second is a worker, and a third is only a client, the upgrade kickstart file will do what is expected and upgrade all the components on the local machine.
| Tip |
|---|
The directory that contains the manifest, kickstart, and subdirectories for OS-dependent installation files is portable. It can be moved from one directory to another or from one machine to another or from one OS to another. |
Example Usage
briank$ sudo qubeInstaller.MacOSX-x86_64.app/Contents/MacOS/qubeInstaller qube-upgrade-6.4-4-kickstart.qks INFO: Running in non-UI modeDownloading:INFO: Adding component_qube-core to ftp queueINFO: Adding component_qube-supervisor to ftp queueINFO: Adding component_qube-worker to ftp queueINFO: Adding component_qubegui to ftp queueINFO: Adding component_qubeArtistView to ftp queueINFO: Adding component_qube-mayajt to ftp queueINFO: Adding component_qube-mentalrayjt to ftp queueINFO: Adding component_qube-miGenjt to ftp queueINFO: Adding component_qube-mtorjt to ftp queueINFO: Adding component_qube-pyHoudinijt to ftp queueINFO: Adding component_qube-pyNukejt to ftp queueqube-worker 100.0%qubegui 100.0%qube-supervisor 100.0%qube-mayajt 100.0%qube-mentalrayjt 100.0%qube-miGenjt 100.0%qubeArtistView 100.0%qube-mtorjt 100.0%qube-pyHoudinijt 100.0%qube-pyNukejt 100.0%qube-core 100.0%qube-pyNukejt Uninstalling...qube-pyNukejt Uninstalledqube-pyHoudinijt Uninstalling...qube-pyHoudinijt Uninstalledqube-mtorjt Uninstalling...qube-mtorjt Uninstalledqube-miGenjt Uninstalling...qube-miGenjt Uninstalledqube-mentalrayjt Uninstalling...qube-mentalrayjt Uninstalledqube-mayajt Uninstalling...qube-mayajt UninstalledqubeArtistView Uninstalling...qubeArtistView Uninstalledqubegui Uninstalling...qubegui Uninstalledqube-worker Uninstalling...INFO: worker has shut down.qube-worker Uninstalledqube-supervisor Uninstalling...INFO: supervisor has shut down.qube-supervisor Uninstalledqube-core Uninstalling...qube-core Uninstalledqube-core Installing...qube-core 6.4-4qube-supervisor Installing...qube-supervisor 6.4-4qube-worker Installing...qube-worker 6.4-4qubegui Installing...qubegui 6.4-4qubeArtistView Installing...qubeArtistView 1.0-2qube-mayajt Installing...qube-mayajt 6.4-1qube-mentalrayjt Installing...qube-mentalrayjt 6.4-0qube-miGenjt Installing...qube-miGenjt 6.4-0qube-mtorjt Installing...qube-mtorjt 6.4-0qube-pyHoudinijt Installing...qube-pyHoudinijt 6.4-0qube-pyNukejt Installing...qube-pyNukejt 6.4-0
+------------------------------+
| Qube Upgrade Report |
+--------------------+---------+
| qube-miGenjt | 6.4-0 |
| qube-pyHoudinijt | 6.4-0 |
| qube-worker | 6.4-4 |
| qube-supervisor | 6.4-4 |
| qube-core | 6.4-4 |
| qube-mtorjt | 6.4-0 |
| qube-pyNukejt | 6.4-0 |
| qubegui | 6.4-4 |
| qube-mentalrayjt | 6.4-0 |
| qube-mayajt | 6.4-1 |
| qubeArtistView | 1.0-2 |
+--------------------+---------+
Install Complete