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