B.2 Branch Server Directory Structure

Directory

 

Contents

/etc/opt/SLES/POS/

 

 

branchserver.conf

The LDAP base configuration file.

Both the Administration and Branch Server use this file.

 

keys/

 

 

 

 

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

During installation of the Administration Server, Novell Linux Point of Service automatically installs a CA and generates self-signed certificates to secure communication between the Administration and Branch Servers. However, the CA's public key is distributed to the branch servers only if you enable LDAP SSL during installation. For more information on setting up LDAP SSL, see Running posInitLdap.sh in the Novell Linux Point of Service 9 Installation Guide.

 

 

certs/

 

 

 

The certs directory contains the Administration Server certificate and keys.

 

 

 

ca.crt

The public key for the CA that signed the Administration Server's server certificate.

This file is distributed to Branch Servers only 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.

/tftpboot/

 

 

 

 

 

The TFTP server directory on the Branch Server.

/tftpboot/

 

 

 

continued

 

CR/

 

The CR directory contains config.MAC_ Address image configuration files for every registered Point of Service terminal on the current Branch Server.

 

 

MAC_address/

 

The MAC_address directory contains system configuration files for individual Point of Service terminals, such as XF86config.

 

boot/

 

 

 

The boot directory contains the boot images and configuration files required to boot Point of Service terminals.

 

 

linux

The linux file is actually the DiskNetboot-version-date.kernel.version-SLRS image. The Linux image provides the Linux kernel used to PXE boot the Point of Service terminals.

IMPORTANT:The DiskNetboot-version-date.kernel.version-SLRS image must be copied to the opt/SLES/POS/rsync/boot/ directory as linux before running posSynchImages.pl on the Branch Server. For more information on this process, see Setting Up the Administration Server in the Novell Linux Point of Service 9 Installation Guide.

 

 

initrd.gz

The initrd.gz file is actually the DiskNetboot.gz image. The initrd.gz image provides the second bootstrap image used to PXE boot the Point of Service terminals.

IMPORTANT:The DiskNetboot.gz image must be copied to the opt/SLES/POS/rsync/boot/ directory as initrd.gz before running posSynchImages.pl on the Branch Server. For more information on this process, see Setting Up the Administration Server in the Novell Linux Point of Service 9 Installation Guide.

 

 

pxelinux.0

The pxelinux.0 image is the first boostrap image used to PXE boot the Point of Service terminals.

 

 

pxelinux.config/

The pxelinux.config directory contains the configuration files required to PXE boot the Point of Service terminals.

Pxelinux.cfg files indicate which kernel and RAM disk to load for the Point of Service terminal. These files enable Branch Servers to distribute SLRS 8 and Novell Linux Point of Service 9 images.

Novell Linux Point of Service automatically creates the pxelinux.cfg files based on the distribution container configurations in the LDAP directory. For more information, see Section 5.0, The Novell Linux Point of Service LDAP Directory.

 

/tftpboot/boot/pxelinux.config/

 

continued

 

 

 

default

The default configuration file for Point of Service terminal's PXE boot.

This configuration file is used by all Point of Service terminals that boot the Novell Linux Point of Service 9 kernel.

 

 

 

IP_address_hex_value

Custom pxelinux configuration files.

If you have a custom distribution container, Novell Linux Point of Service automatically generates custom pxelinux configuration files that distribute the kernel specified by that distribution directory.

For example, if you migrate from SLRS 8 to Novell Linux Point of Service 9, the migration script creates the SLRS 8 distribution container. This container stores all the scPosImage objects for SLRS 8 images and points to the SLRS 8 kernel. The migration script also updates the existing scCashRegister objects to point to scPosImage objects in the SLRS 8 container. When you run posldap2crconfig or posleases2ldap, Novell Linux Point of Service automatically generates custom pxelinux configuration files for the Point of Service terminals that boot images in the SLRS 8 container. For more information, see Migrating from SLRS 8 to Novell Linux Point of Service 9 in the Novell Linux Point of Service 9 Installation Guide.

The filename for custom pxelinux configuration files is the IP address of the booting client. For example, if the client IP address is 10.1.1.1, the filename of the corresponding pxelinux configuration file is OA0101.

 

image/

 

 

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

NOTE:On Novell Linux Point of Service, the Branch Server can simultaneously distribute SLRS 8 and Novell Linux Point of Service 9 terminal images.

 

upload/

 

 

The directory into which the hwtype.MAC_ Address files for newly registered Point of Service terminals are uploaded. These files are used to create the Point of Service terminal's workstation object in LDAP.

This directory also stores temporary files for Image Install Notification. When a new image is installed on a Point of Service terminal, the bootversion.MAC_address file is created in tftpboot/upload. posleases2ldap transfers the information in the bootversion.MAC_address file to the scNotifiedimage attribute in the scWorkstation object in LDAP.