Changes between Version 6 and Version 7 of Download/SCDB

Timestamp:

Oct 12, 2006, 11:35:34 PM (19 years ago)

Author:

/C=FR/O=CNRS/OU=UMR8607/CN=Michel Jouvin/emailAddress=jouvin@…

Comment:

--

Download/SCDB

@@ -4 +4 @@
 [[TOC(inline)]]
 
+
+== Web Server Installation ==
+
+The Quattor server needs to run a Web server to serve profiles, kickstart configuration files and execute the CGI script at end of installation to change PXE boot to local disk. In addition, it is recommended (but not necessary) to use this Web server for serving RPMs.
+
+Web server installation requires nothing specific, just the configuration of a document root with enough space if you plan to serve RPMs and the configuration of CGIs. This Web server can be shared with other usages and you can use a specific virtual host instead of a dedicated server.
+
+Apache is the recommended Web server (installation instuctions here refer to Apache) and it can be installed from the OS distribution.
 
 == Subversion Server ==
@@ -76 +84 @@
  * Adding a script on the Quattor server that will be launched by the hook script, using ssh
  * Configuring SSH keys to allow execution of the previous script as root (preferably) from the Apache account
- * Add a CGI script on Quattor web server used at end of installation of a machine to allow next boot from local disk.
+ * Add a CGI script on Quattor server used at end of installation of a machine to allow next boot from local disk.
+ * Configuration of AII
+
 
 === Installation of hook script and server script ===
@@ -84 +94 @@
 The other script, `build-tag.pl`, also provided as part of SCDB, in the `src/hooks` directory, must be installed (root executable) in `/root/quattor` on the Quattor server.
 
+
+=== Creation of Ssh Keys ===
+
+Currently, deployment of new version of the templates is done by the hook script triggered by `ant deploy` executing the server script `build-tag.pl` through ssh. There is no way to enter a password at this time, thus ssh must be configured in such a way that the Apache account on the Subversion server can do a ssh connection as root on the Quattor server, without password. The easiest is to use ssh keys to do that.
+
+
+=== Post-installation CGI Script ===
+
+At the end of a machine installation, as part of the Kickstart post-intallation script, a CGI script is executed on the Quattor server to change PXE configuration in order for the machine to boot from local disk next time. This allows to set PXE as the first boot device in the BIOS and control re-installation via `aii-shellfe` command.
+
+This script, `build-tag.pl`, can be found in SCDB directory `src/cgis`. It must be placed on the Web server running on the Quattor server, in the directory for CGIs.
+
+
+=== Configuration of AII ===
+
+This involves 2 separate steps :
+ * Customization of `/etc/aii*.conf` files
+ * Customization of AII related variables in templates
+
+To customize AII configuration files, located in `/etc` and named `aii-*.conf`, refer to the comment in each files. Main parameters to customize are the URL to use to download profiles (in `aii-shellfe.conf`) and the directory where to place kickstart configuration files produced by AII (in `aii-osinstall.conf`).
+
+There are a few variables to customize in site templates to reflect your Quattor and AII configuration, mainly :
+
+ * `QUATTOR_PROFILE_URL` : URL to use to download machine profiles.
+ * `AII_OSINSTALL_SRV` : Name of the Web server serving kickstart configuration files and RPMs.
+ * `AII_ACKSRV` : Name of the Web server to use for the post-installation CGI. Defaults to `AII_OSINSTALL_SRV`
+ * `AII_ACKCGI` : post-installation CGI URL. Defaults to `/cgi-bin/aii-installack.cgi`.
+ * `AII_OSINSTALL_TEMPLATE` : name of the Kickstart configuration template to use. Defaults to `i386_sl3_ks.conf`.
+
+These variables are generally defined site-wide, in the template `pro_site_global_variables.tpl` located in site directory. Look at provided examples, in SCDB distribution.
+
+
+