Installation from source tarball¶
In order to install Pulse2 and it’s plugins you first need to install and configure MMC.
Get the current tarball at download page:
# tar xzvf pulse2-.x.y.x.tar.gz
# cd pulse2-x.y.z
# ./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var
# make
# make install
The pulse2-setup tool can then be used to provision databases, setup and check configuration files, etc. If you plan to use imaging service, please read the following section, as pulse2-setup does not handle with its configuration.
The default $PREFIX for installation is /usr/local. You can change it on the ./configure line by adding the option --prefix=/usr for example.
configure options¶
The configure recognizes the following options to control how it operate:
–help, -h: Print a summary of all of the options to configure, and exit.
- –help=short –help=recursive: Print a summary of the options unique to this
package’s configure, and exit. The short variant lists options used only in the top level, while the recursive variant lists options also present in any nested packages.
- –version, -V: Print the version of Autoconf used to generate the configure
script, and exit.
- –cache-file=FILE: Enable the cache: use and save the results of the tests
in FILE, traditionally config.cache. FILE defaults to /dev/null to disable caching.
–config-cache, -C: Alias for –cache-file=config.cache.
- –quiet, –silent, -q: Do not print messages saying which checks are
being made. To suppress all normal output, redirect it to /dev/null (any error messages will still be shown).
- –srcdir=DIR: Look for the package’s source code in directory DIR. Usually
configure can determine that directory automatically.
- –prefix=DIR: Use DIR as the installation prefix. note Installation
Names for more details, including other options available for fine-tuning the installation locations.
- –no-create, -n: Run the configure checks, but stop before creating any
output files.
- –disable-conf: Do not install conf files. On a first install, you may not
use this option as configuration files are required.
- –disable-conf-backup: Do not backup configuration files if they are
already installed. Default is to create backup files like *.~N~.
–disable-wol: Do not build and install wake-on-lan tool.
OpenLDAP Schema¶
Old versions¶
The mmc schema is needed to set ACLs on users in the MMC web interface:
# cp /usr/share/doc/python-mmc-base/contrib/ldap/mmc.schema /etc/ldap/schema/
Then in /etc/ldap/slapd.conf include the schema:
include /etc/ldap/schema/mmc.schema
New versions¶
#TODO: Talk more about openldap changes in config and schema new storage.
Copy mmc schema to your current directory:
$ cp /usr/share/doc/python-mmc-base/contrib/ldap/mmc.schema .
Create a file mmc.conf with:
include mmc.schema
Create a folder schemas:
$ mkdir schemas
Convert mcc.schema to ldif:
$ slaptest -f mmc.conf -F schemas/
Edit mmc schema, remove {0} from dn:, cn: and add cn=schema,cn=config to dn
dn: cn=mmc,cn=schema,cn=config
objectClass: olcSchemaConfig
cn: mmc
Remove the following lines at the bottom of that file:
structuralObjectClass: olcSchemaConfig
entryUUID: 0ec2fe60-1381-1031-8f21-f92982aeda45
creatorsName: cn=config
createTimestamp: 20120405153755Z
entryCSN: 20120405153755.316520Z#000000#000#000000
modifiersName: cn=config
modifyTimestamp: 20120405153755Z
Add schema to ldap:
# ldapadd -Y EXTERNAL -H ldapi:/// -f schemas/cn\=config/cn\=schema/cn\=\{0\}mmc.ldif
Restart the slapd daemon.
Pulse setup¶
pulse2-setup will ask:
INFO - Load defaults values from existing config
INPUT - Enable audit module (Y/n): y
INPUT - Enable inventory server (Y/n): y
INPUT - Enable imaging server (Y/n): y
INPUT - Enable package server (proxy) (Y/n): y
INPUT - Server external IP address (default: 10.0.2.15): 172.16.0.4
INFO - Run setup
INPUT - Database host (default: localhost):
INPUT - Database admin user (default: root):
INPUT - Database admin password:
...
INPUT - LDAP uri (default: ldap://127.0.0.1:389):
INPUT - LDAP base DN (default: dc=mandriva, dc=com):
INPUT - LDAP admin DN (default: cn=admin, dc=mandriva, dc=com):
INPUT - LDAP admin password:
...
INPUT - Wake-on-lan tool path (default: /usr/sbin/pulse2-wol):
Imaging client installation¶
Imaging client can run only on i386 compliant machines. It is not run directly on the server, but served through the network to i386 machines. For your convenience, prebuilt binaries are available, so that you can install it on a server which is not i386.
Once you have downloaded prebuilt binaries as pulse2-imaging-client-<version>_i386.tar.gz, simply run the following, as root: $ tar xfC pulse2-imaging-client-<version>_i386.tar.gz /
All files are extracted in /var/lib/pulse2/imaging/ dir.
As to serve the imaging client to the machines, you must then configure the following network services.
DHCP Setup¶
The imaging module of Pulse 2 needs PXE functionalities, NFS and TFTP services. For PXE configure the DHCP server on the network to serve the Pulse2 PXE bootmenu.
For example with dhcp3-server in /etc/dhcp3/dhcpd.conf:
subnet 192.168.0.0 netmask 255.255.255.0 {
option broadcast-address 192.168.0.255; # broadcast address
option domain-name "pulse2.test"; # domain name
option domain-name-servers 192.168.0.2; # dns servers
option routers 192.168.0.2; # default gateway
pool {
range 192.168.0.170 192.168.0.180;
filename "/bootloader/pxe_boot";
next-server 192.168.0.237;
}
}
- filename and next-server are the relevant options to set.
You can find an example file for dhcp3 server in or repository.
NFS setup¶
In /etc/exports file, add the following lines:
/var/lib/pulse2/imaging/computers *(async,rw,no_root_squash,subtree_check)
/var/lib/pulse2/imaging/masters *(async,rw,no_root_squash,subtree_check)
/var/lib/pulse2/imaging/postinst *(async,ro,no_root_squash,subtree_check)
Then reload the new NFS configuration, as root.
Check the export list:
# showmount -e
Export list for imaging:
/var/lib/pulse2/imaging/masters *
/var/lib/pulse2/imaging/postinst *
/var/lib/pulse2/imaging/computers *
TFTP Setup¶
Bootloader and kernel are served to the client with TFTP protocol. We recommend using the atftpd server as it supports multicast..
You must configure the TFTP server to use as base directory:
/var/lib/pulse2/imaging
Note
don’t use inetd.
Then check the configuration:
# atftp localhost
tftp> get /bootloader/pxe_boot
tftp> quit
# rm pxe_boot