Jump to contentJump to page navigation: previous page [access key p]/next page [access key n]
Applies to SUSE Linux Enterprise Point of Service 11 SP3 and SUSE Linux Enterprise Point of Service 12 Image Server

A SUSE Linux Enterprise Point of Service Files and Directory Structure

This section provides a quick reference for the directory structure.

A.1 Administration Server Directory Structure

/etc/openldap/slapd.d

The LDAP directory contains the LDAP server configuration database files which should not be edited directly. For modification, use the ldapmodify with DN cn=admin,cn=config and your SUSE Linux Enterprise Point of Service administration password.

/etc/SLEPOS/adminserver.conf

The Administration Server directory contains the standard configuration file for the Administration Server. On the Combo Server, both /etc/SLEPOS/adminserver.conf and /etc/SLEPOS/branchserver.conf are used.

/etc/SLEPOS/keys/

The keys directory contains the keys and certificates required to secure LDAP communication between Administration Server and Branch Server.

During installation of the Administration Server, SUSE Linux Enterprise Point of Service may automatically create and install custom CA and generate self-signed certificates to secure communication between Administration Server and Branch Server. For more information on setting up LDAP SSL, see Section 4.2, “Initializing the LDAP Directory with posInitAdminserver.

/etc/SLEPOS/keys/ca/

This directory contains the CA certificate, keys, and all related data. This directory is managed by YaST CA Management module, use the yast2 ca-mgm command for management.

/etc/SLEPOS/keys/ca/ca.crt

This file contains the public key for the CA that signed the server certificate. This is only copied to the rsync directory if you enable LDAP SSL during installation of the Administration Server. The public key for the CA allows the Branch Servers to trust the Administration Server.

/etc/SLEPOS/keys/ca/ca.key

This files contains the CA’s private key.

/etc/SLEPOS/keys/certs/

This directory contains the Administration Server certificate and keys.

/etc/SLEPOS/keys/certs/server.crt

This file contains the Administration Server certificate public key. This certificate is used to secure LDAP communication between Administration and Branch Server.

/etc/SLEPOS/keys/certs/server.key

This file contains the private key for the server certificate.

/etc/SLEPOS/rsync/

The rsync directory contains the configuration files for the rsync service.

/etc/SLEPOS/rsync/rsyncd.conf

This file contains the rsync configuration data for the Administration Server.

/etc/SLEPOS/template/

The template directory contains the template files required for the Administration and Branch Server services.

/etc/SLEPOS/template/adminserver.conf.template

This file contains the template for the Administration Server configuration file.

/etc/SLEPOS/template/branchserver.conf.template

This file contains the template for the Branch Server configuration file.

/etc/SLEPOS/template/branchslapd.conf.template

This file contains the template for Branch Server's local LDAP configuration. The posInitBranchServer script uses this template to create the openLDAP server configuration file, /etc/openldap/slapd.conf.

/etc/SLEPOS/template/dhcpd.conf.header.template

This file contains the template for the DHCP services.

/etc/SLEPOS/template/dns-zonefile.header.template

This file contains the template for the DNS services.

/etc/SLEPOS/template/ldif.pos

This file contains initial LDAP data for eDirectory. posInitEdir imports this file into the Administration Server's eDirectory server. This file uses the structure of the ldap.pos.template, but is populated with the names provided during installation.

/etc/SLEPOS/template/ldif.pos.template

This file contains the template for the ldif.pos file.

/etc/SLEPOS/template/slapd.conf.template

This file contains the template for slapd configuration. posInitAdminserver uses this template to create the openLDAP server configuration file /etc/openldap/slapd.conf.

/etc/SLEPOS/template/XML/LDAPschema.xsl

This is the XSL template for visualizing the SUSE Linux Enterprise Point of Service validation template in a Web browser.

/etc/SLEPOS/template/XML/basic.xml

This file contains initial LDAP data for openLDAP database. The posInitAdminserver script imports this file into the Administration Server's openLDAP server.

/etc/SLEPOS/template/XML/validateSLEPOSXMLv0.1.rng

This is the validation template for SUSE Linux Enterprise Point of Service XML v0.1.

/srv/SLEPOS/certs/ca.crt

This file contains the public key for the CA that signed the server certificate. This is only copied to the rsync directory if you enable LDAP SSL during installation of the Administration Server. The CA’s public key allows the Branch Server to trust the Administration Server.

/srv/SLEPOS/config/

The config directory contains hardware configuration files that are distributed by the Administration Server over rsync. Ultimately, these configuration files are distributed by the Branch Server to the Point of Service terminals over TFTP.

Note
Note: Referenced Configuration Files

Any configuration files referenced in the scConfigFileSyncTemplate object must be located in /srv/SLEPOS/rsync/config/.

/srv/SLEPOS/image/

The image directory contains active client images that are distributed by the Administration Server over rsync. Ultimately, these images are distributed by the Branch Server to Point of Service terminals over TFTP.

A.2 Branch Server Directory Structure

/etc/SLEPOS/branchserver.conf

This file contains the LDAP base configuration. It is used on Branch Server and Combo Server.

/etc/SLEPOS/dhcpd/

The dhcpd directory contains DHCP configuration header and DHCP configuration file.

/etc/SLEPOS/dhcpd/dhcpd.conf

Contains the current SUSE Linux Enterprise Point of Service DHCP configuration for registered terminals (with fixed ip).

/etc/SLEPOS/dhcpd/dhcpd.conf.header

The header of the dhcp.conf file to which posleases2ldap appends terminal specific data.

/etc/SLEPOS/dhcpd/dhcpd.conf.old

The backup of the last used DHCP configuration.

/etc/SLEPOS/keys/

The keys directory contains the keys and certificates required to secure LDAP communication between Administration and Branch Servers.

/etc/SLEPOS/keys/certs/

The certs directory contains the Administration Server certificate and keys.

/etc/SLEPOS/keys/certs/ca.crt

This file contains the public key for the CA that signed the Administration Server's server certificate. This file is only distributed to Branch Servers if you enable LDAP SSL during installation of the Administration Server. The CA’s public key allows the Branch Servers to trust the Administration Server.

/etc/SLEPOS/salt.key

This file contains a randomly generated key used for password obfuscation in the configuration files.

/etc/SLEPOS/template/pxelinux.cfg.template

This file contains the template for pxelinux.cfg files. The pxelinux.cfg files are stored on the Branch Server. They indicate which kernel and RAM disk to load for the POS terminal. These files enable the Branch Server to distribute SUSE Linux Enterprise Point of Service images.

SUSE Linux Enterprise Point of Service automatically creates the pxelinux.cfg files based on the distribution container configurations in the LDAP directory.

/etc/named.d/ldap_generated

The directory contains generated dns configuration file (named.conf) for the DNS service provided by Branch Server for POS terminals.

/srv/tftpboot/

The tftpboot directory contains data for the TFTP and/or FTP services.

/srv/tftpboot/KIWI/ or /srv/tftpboot/CR

Contains configuration files for all registered Point of Service terminals on the current Branch Server. Also contains rollback.MAC files indexing rollback information for given MAC addresses and, in the role-based case, rolelists and idlists. /srv/tftpboot/CR is a symbolic link to /srv/tftpboot/KIWI for backward compatibility.

/srv/tftpboot/KIWI/MAC/

Contains system configuration files for the individual Point of Service terminals, such as xorg.conf.

/srv/tftpboot/KIWI/backup/

Contains backups of all previously used configuration files.

/srv/tftpboot/KIWI/rollback/

Contains config.MAC.hash files used for restoring older configurations.

/srv/tftpboot/boot/

The boot directory contains the boot images and configuration files required to boot Point of Service terminals. On the Branch Server, this directory can also contain boot images used for rolled back configurations.

/srv/tftpboot/boot/linux

This file contains the default Linux kernel used to boot the Point of Service terminals via PXE.

Important
Important: Preparations on the Branch Server

The kernel image must be copied to the /srv/SLEPOS/rsync/boot/ directory before running posSyncImages on the Branch Server.

/srv/tftpboot/boot/linux.md5

The md5 sum of the linux file.

/srv/tftpboot/boot/initrd.gz

The initrd.gz links the initrd image, which provides the second bootstrap used to boot the Point of Service terminals using PXE.

Important
Important: Preparations on the Branch Server

The initrd image must be copied to the /srv/SLEPOS/boot/ directory before running posSyncImages on the Branch Server. For more information on this process, see Chapter 4, Setting Up the Administration Server.

/srv/tftpboot/boot/initrd.md5

The md5 sum of the initrd.gz file.

/srv/tftpboot/boot/menu.c32

This file is a link to /usr/share/syslinux/menu.c32 to allow presenting a PXE boot menu for selection of a specific boot images.

/srv/tftpboot/boot/memdisk

This file is a link to /usr/share/syslinux/memdisk to allow booting of specific images (e.g for BIOS update).

/srv/tftpboot/boot/pxelinux.0

This file is a link to /usr/share/syslinux/pxelinux.0, which is the first boostrap image used to PXE boot the Point of Service terminals.

/srv/tftpboot/boot/pxelinux.cfg/

This directory contains the configuration files required to boot the Point of Service terminals using PXE. The file pxelinux.cfg indicates which kernel and initrd image to load for the Point of Service terminal. These files enable Branch Servers to distribute SLES images.

Branch Server automatically creates the pxelinux.cfg files based on the distribution container configurations and PXE objects in the LDAP directory. For more information, see Chapter 11, The LDAP Directory on SUSE Linux Enterprise Point of Service.

/srv/tftpboot/boot/pxelinux.cfg/default

This file contains the default configuration data for Point of Service terminal's PXE boot. This configuration file is used by all Point of Service terminals except those with specific kernel or initrd, or with a specific PXE configuration (see Section 10.6, “Specifying Kernel Command Line Options for Selected Terminals”), or terminals that have been rolled back.

This file is created and modified by posInitBranchserver, pos dump-lists, pos dump-all and in every posleases2ldap loop.

/srv/tftpboot/boot/pxelinux.config/01-dash_separated_MAC

These are specific PXE Linux files with custom configuration data. If you have a custom distribution container, a machine using specific kernel parameters, or a rolled back machine, the Branch Server generates custom PXE Linux configuration files containing the kernel or kernel parameters associated with the relevant machine. The file name for custom PXE Linux configuration files is the lowercase, '-' separated MAC address of the booting client, with 01 prefix.

For example, if the client MAC address is 00:11:25:A7:D6:1E, the file name of the corresponding PXE Linux configuration file is 01-00-11-25-a7-d6-1e. If the machine has registered with more MAC addresses, specific PXE's are created for all those MAC addresses (one as a file and the rest of them as links).

/srv/tftpboot/image/

The image directory contains the client images that are distributed to Point of Service terminals and their associated checksums.

/srv/tftpboot/upload/

Serves as the destination directory to upload hwtype.MAC.HASH files for newly registered Point of Service terminals. These files are used to create the Point of Service terminal's workstation object in LDAP.

This directory also stores the bootversion.MAC files that the posleases2ldap daemon uses to provide image install notification. When an image is successfully installed on a Point of Service terminal, the linuxrc script creates a bootversion.MAC file in the /tftpboot/upload directory on the Branch Server. posleases2ldap then transfers the information to the scNotifiedImage attribute in the scWorkstation object in LDAP and deletes the bootversion.MAC file.

/srv/tftpboot/upload/backup/

Contains backup of all previously used hwtype and bootversion files.

A.3 Image Building Server Files and Directory Structure

The template-version part of the following paths should be replaced with the actual names of the image template directories in /usr/share/kiwi/image/SLEPOS/. For example, for the graphical image version 4.0.0, the template-version should be replaced with graphical-4.0.0 or graphical-4 (a symbolic link).

/usr/share/kiwi/images/SLEPOS

This directory contains SUSE Linux Enterprise Point of Service image templates, which are used for creating customized image configurations. They are stored in single subdirectories template_name-version. Symbolic links from template_name-majorname to template_name-version are present (for example a link fromgraphical-4 to graphical-4.0.0. Image Creator shows these templates in the Base on Template list.

/usr/share/kiwi/image/SLEPOS/template-version/config.xml

This file is the main configuration file. It is used to define base names, image types, profiles, options, and the package/pattern list.

/usr/share/kiwi/image/SLEPOS/template-version/config/

The config directory contains optional shell scripts. These are executed after all packages are installed. For example, you can include scripts here that remove parts of a package. The name of the Bash script must match the package name listed in the config.xml file.

/usr/share/kiwi/image/SLEPOS/template-version/config.sh

config.sh contains an optional configuration script, executed at the end of the installation.

/usr/share/kiwi/image/SLEPOS/template-version/images.sh

The images.sh file contains an optional configuration script, executed at the beginning of the image creation process. It is still supported, but not used in SUSE Linux Enterprise Point of Service images version 4 and later. It is now recommended to use usr/share/kiwi/image/SLEPOS/template-version/root/build-custom for this purpose.

/usr/share/kiwi/image/SLEPOS/template-version/config-yast.xml

The config-yast.xml file contains optional AutoYaST configuration data. The file creates a profile /root/autoinst.xml, which can be used to create a clone of an installation.

/usr/share/kiwi/image/SLEPOS/template-version/root/

The root directory contains files, directories, and scripts. It is used to adapt the image environment after the installation of all package and lets you customize your image with data that is not available as a package.

/usr/share/kiwi/image/SLEPOS/template-version/repo/

This directory was used as the repository containing RPM packages directly accessible in Image Creator. It is no longer used in SUSE Linux Enterprise Point of Service images version 4 and later. The functionality can be however restored by creating the directory and adding the following to the config.xml:

<repository type="rpm-dir">
  <source path="this://repo"/>
</repository>

It is however recommended to consider other possibilities, like creating one central repository for pos packages and use this repository in all images.

/var/lib/SLEPOS/dist/

This directory holds SLES and SLEPOS repositories; it contains RPM packages selectable in Image Creator. It is now deprecated and used only in cases when SMT is not used for repository management.

/var/lib/SLEPOS/system/

This directory contains the chroot directory used for KIWI/Image Creator building of images, the images subdirectory containing built images and image_name subdirectories with all KIWI configuration files.

/var/lib/SLEPOS/system/chroot/image_name

This directory is used by KIWI/Image Creator for building of the image_name image.

/var/lib/SLEPOS/system/images/image_name

This directory contains the build image image_name. For example:

initrd-netboot-suse-SLES11.i686-2.1.1.gz
initrd-netboot-suse-SLES11.i686-2.1.1.kernel -> initrd-netboot-suse-SLES11.i686-2.1.1.kernel.3.0.82-0.7-default
initrd-netboot-suse-SLES11.i686-2.1.1.kernel.3.0.82-0.7-default
initrd-netboot-suse-SLES11.i686-2.1.1.kernel.3.0.82-0.7-default.md5
initrd-netboot-suse-SLES11.i686-2.1.1.md5
initrd-netboot-suse-SLES11.i686-2.1.1.packages
initrd-netboot-suse-SLES11.i686-2.1.1.splash.gz
initrd-netboot-suse-SLES11.i686-2.1.1.splash.md5
initrd-netboot-suse-SLES11.i686-2.1.1.verified
image_name.i686-1.0.0
image_name.i686-1.0.0.config
image_name.i686-1.0.0.ext3 -> image_name.i686-1.0.0
image_name.i686-1.0.0.gz
image_name.i686-1.0.0.md5
image_name.i686-1.0.0.packages
image_name.i686-1.0.0.verified
/var/lib/SLEPOS/system/image_name

This directory contains all KIWI configuration files for image_name. For example:

bootsplash.tar
config.sh
config.xml
config.xml.POSsave
root
wlan.tar.gz
Print this page