First install Fedora 8 CONTROL server

Boot from the "new store quick install" DVD:

At the boot screen, type

knoppix 2

This will boot up knoppix in text mode and leave you with 4 terminals.

Partition the hard drive with fdisk to create the following partitions:

The following example is for a 8 Gig / partition. Don't forget to change partition 2 to type 82 (linux swap) and to make partition 1 bootable. The default (83) should be fine for partition 1 and 3.

#fdisk /dev/hda
The number of cylinders for this disk is set to 9729.
There is nothing wrong with that, but this is larger than 1024,
and could in certain setups cause problems with:
1) software that runs at boot time (e.g., old versions of LILO)
2) booting and partitioning software from other OSs
   (e.g., DOS FDISK, OS/2 FDISK)
Command (m for help):n
Command action
   e   extended
   p   primary partition (1-4)
p
Partition number (1-4):1
First cylinder (1-9729, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (6619-9729, default 9729):+8192M
Command (m for help):

Formatting the partitions:

#mkfs.ext3 -L / /dev/hda1
#mkfs.ext3 -L /u /dev/hda3
#mkswap -L SWAP-sda2 /dev/hda2

Mount the partitions:

If the /mnt/hda1 was not auto created, manually create it.

#mount /dev/hda1 /mnt/hda1
#mkdir /mnt/hda1/u
#mount /dev/hda3 /mnt/hda1/u

Untar the fedora 8 image to the new partition

#cd /mnt/hda1
#tar xvzf /u/blankf8forcontrol.tgz

after 10-15 minutes the whole image should now be on the new drive.

Boot Loader setup:

First get out of the knoppix environment:

#shutdown -r now

The disk will eject, insert the Fedora 8 Rescue CD. You can use the Fedora 8 installer and select "Rescue installed system". Accept all the defaults, except you do not need to enable networking. Once you get to the prompt, you need to create a new initial ramdisk and then reinstall grub:

#chroot /mnt/sysimage
#rm /boot/initrd-2.6.26.5-28.fc8.img
#mkinitrd /boot/initrd-2.6.26.5-28.fc8.img 2.6.26.5-28.fc8
#grub-install /dev/sda
#exit
#exit

Now Eject the disc. Your system should now boot up.

Network configuration:

This will be dependant on the machine's connection to the internet. DHCP is configured by default. If a DHCP server is unavailable, configure a static IP address, Netmask, gateway, and nameserver. For example:

This can be changed by logging in as root and running "system-config-network". Where this machine is on an internal network, you should ensure that SSH (port 22) is forwarded to it from the router to allow Creative Computing to access the machine remotely.

Hostname configuration:

This should be a shortened version of the company name for a head office server (6-12 characters, no spaces or dots), or a similarly shortened location name for a store server. Configure this into /etc/sysconfig/network

hostname=compname 

TimeZone selection:

Select "Hardware Clock is GMT" to ensure correct operation across daylight savings changes. Select the appropriate timezone for the server location (e.g. Australia/Sydney). Use "system-config-date" to change this setting.

Additional Operating System configuration

yum

Update the packages with

yum update

Note: be careful of glibc updates for older releases of CONTROL

If yum insists on gpg keys then, in /etc/yum.conf and /etc/yum.repos.d/*,

gpgcheck=0

VPN

Add the hostname (uname -n) into /etc/hosts on muppets. Assign the machine the next IP in the sequence.Also update the ["DNS"].

To test the VPN connection, use the following:

# pppd call crecom nodetach debug

Configuring the OS for CONTROL

Configure the ccc user

Edit the ~ccc/.bashrc and add the following to the end:

umask 0

Edit the ~ccc/.vnc/xstartup file used by Xvnc. It should read:

export NODEID="vnc$DISPLAY"
sleep 5
. /u/cc/usr/common.sh
exec fvwm

Setup user defaults

Copy the~ccc/.vnc/folder to/etc/skel/

# cp -r ~ccc/.vnc /etc/skel/
# chown root:root /etc/skel/.vnc

Copy CONTROL

Package control programs on sam (Server side)

export CONTROL_FILES="
std/binl
std/utbinl
std/binx11
std/utbinx11
adm
blank
standard
standard.adm
pixmap
lib
binl
binx11
DEMO
manual
usr/common.linux
"
cd /u/ccdev/
tar cvzhf control.tgz --exclude=.sccs $CONTROL_FILES

send control.tgz to client machine

Setup /u/cc/ directory (Client Side)

touch /dev/lp8
chmod 666 /dev/lp8
umask 0
mkdir /u/cc/
chmod 777 /u/cc/
ln -s /u/cc /cc
mkdir /u/cc/usr
chmod 777 /u/cc/usr
ln -s ~ccc /u/cc/usr/ccc
mkdir /u/cc/LOG
chmod 777 /u/cc/LOG
chown ccc:control /u/cc/LOG /u/cc/usr
chown ccc:control /u/cc/usr/ccc /u/cc/usr/ccc/.*
cd /u/cc
tar xvzf PATH_TO_CONTROL_TAR_FILE/control.tgz (do this step if you have already copied control.tgz to client machine)
chown ccc:control std/* std/*/*
chown ccc:control binl/*
chown ccc:control binx11/*
binl/link_cntrl
chown ccc:control standard/*
chmod 666 standard/*
cp /u/cc/standard.adm/* /u/cc/adm
mv /u/cc/usr/common.linux /u/cc/usr/common.sh

Libraries

For Fedora versions prior to Fedora Core 5, update /etc/ld.so.conf to included the following line

/u/cc/lib

For Fedora Core 5 and later, execute:

cd /usr/lib
ln -s /u/cc/lib/libcqt3.* .

You will also need to edit /u/cc/usr/common.sh

LD_LIBRARY_PATH=/lib:/usr/lib:$CCDIR/lib

Then for all versions to rebuild the library cache execute:

ldconfig

Install necessary fonts

As a minimum, the system should have the 75-dpi, 100-dpi and truetype fonts appropriate for the installed X Font Server

To search for the fonts:

yum search fonts

The packages are usually of the form fonts-xorg-75dpi

Once you have found the correct fonts packages

yum install <font package>

Make console (DISPLAY=0) a VNC server

Edit /etc/X11/xorg.conf

Section "Module"
        Load "vnc"      # Add this line
EndSection
Section "Screen"
        Option "PasswordFile" "/u/cc/usr/ccc/.vnc/passwd"       # Add this line
EndSection

Installing FVWM

We use FVWM as a slimline window manager where users don't need or expect a full remote desktop. You'll need to locate files fvwm-2.4.19-1.i386.rpm and libstroke-0.5.1-4.fc4.i386.rpm which are available on sam.

# yum install compat-readline43 gtk+ imlib
# rpm -Uvh fvwm-2.4.19-1.i386.rpm fvwm-themes-0.6.2-1.noarch.rpm libstroke-0.5.1-4.fc4.i386.rpm

Need to update Xclients such that FVWM is started when local user logs in.

# cd /etc/X11/xinit
# mv Xclients Xclients.bak
# vi Xclients

Update Xclients to initialise the control environment and execute FVWM as below:

rm -f $HOME/Xrootenv.0
rm -f /tmp/fvwmrc* 2>/dev/null
. /u/cc/usr/common.sh
exec /usr/bin/fvwm

Finally give Xclients execute permissions

chmod +x Xclients

Configuring FVWM

mkdir /etc/X11/fvwm2

Copy from system.fvwm2rc from /u (sam) or from a recent client's system and place it in the newly created directory. Also place a symbolic link to system.fvwm2rc in /etc/

ln -s /etc/X11/fvwm2/system.fvwm2rc /etc/

User Manuals

Install Firefox

yum install firefox

Download the Adobe Acrobat Reader plugin at http://www.adobe.com and install

firefox http://www.adobe.com

User manual files already included in the tarball copied from sam (/u/ccdev/manual)

Post Control Installation Options

Backups

Scheduled processes

Enter the company code in the script /cc/binl/clrdayqty . crontabsetup auto_postal, eom_job, initda/backups and other scripts that need to run automatically.

For ccc:

* * * * * /u/cc/binl/auto_postal 2>&1 > /u/cc/LOG/auto_postal.out
1 0 1 * * /u/cc/binl/auto_eom >/u/cc/LOG/auto_eom 2>&1
59 23 * * * /u/cc/binl/auto_signoff > /u/cc/LOG/auto_signoff 2>&1
10 0 * * * /u/cc/binl/post_sum > /u/cc/LOG/post_sum 2>&1
0 22 * * * /cc/binl/clrdayqty > /cc/LOG/clrdayqty.out 2>&1

For root:

30 2 * * * /u/cc/binl/netchecktime > /u/cc/LOG/netchecktime.out 2>&1
# The daily backup script
0 3 * * * /u/cc/binl/bacint -s > /u/cc/LOG/bacint.out 2>&1
# Initialise dayfile. Only needed if not using our backup script
#0 3 * * * /u/cc/binl/initda -s > /u/cc/LOG/initda.out 2>&1

Background tasks

You will need to edit /etc/inittab:

id:5:initdefault:  # Need to change run level from 3 to 5
v5:345:respawn:su - ccc -c /usr/local/bin/inittab_vnc 2>&1 >> /var/log/vnc.ccc

Customer Company

Printers, Overlays and Docket Logos

You will need to get the customer's logo and artwork from the sales team.

To create a docket logo, see ["Docket Logo"].

For a list of compatible laser printers, see["Laser Printers"].

For setting up printers, see InstallingPrinter.

Data Imports

Setting up a DEMO company in a server