Differences between revisions 1 and 4 (spanning 3 versions)
Revision 1 as of 2010-03-12 04:40:30
Size: 14039
Editor: JonCo
Comment:
Revision 4 as of 2010-03-16 05:04:05
Size: 9615
Editor: JonCo
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:


= First install Fedora 8 CONTROL server =
== Boot from the "new store quick install" DVD: ==
At the boot screen, type
=== First install Fedora 8 CONTROL server ===
Boot from the "new store quick install" DVD: At the boot screen, type
Line 9: Line 6:
This will boot up knoppix in text mode and leave you with 4 terminals. This will boot up knoppix in text mode and leave you with 4 text terminals.
Line 36: Line 33:
Use the following sequence to create 2nd and 3rd partition (2 gig swap, everything else for /u):

{{{
n
p
2
<enter>
+2048M
n
p
3
<enter>
<enter>
t
2
82
w
}}}
Line 51: Line 66:
#xvzf /u/blankf8forcontrol.tgz #tar xvzf /u/blankf8forcontrol.tgz
Line 89: Line 104:
The server should now be ready to install CONTROL programs and set up the user environment. InstallingControl

----
 . CategoryInstallation
== Installing the OS ==
Please follow the ["Installing Fedora5"] instructions for Fedora installations (Latest usable is Fedora 8).

If you installed Fedora 8 using the ''quick install DVD'', Don't forget to clean out the /home/ccc directory of all the additional files that may have come from an old install of another company. Also clean out the /u/cc directory:

{{{
#rm -rf ~ccc/*.tgz /u/cc
 }}}
Line 102: Line 105:
=== SELinux ===
SELinux has been known to cause problems with Control's directory model. To turn it off, change {{{ /etc/selinux/config }}} to read

{{{
SELINUX=disabled}}}
N.B. The changes will not take effect until the machine reboots.

=== Samba and PAM ===
New ccpass scripts for updating user passwords work around the problems of password synchronisation. As such, the SambaPasswordSync hack is considered depreciated.

To try and ensure locking works reliably between Windows and Linux, edit {{{/etc/samba/smb.conf}}} and add the following lines after the "global" section header:

{{{
#get record locking working between Windows and Linux
        strict locking = yes
        oplocks = False}}}
=== Serial Ports ===
In {{{/etc/rc.d/rc.local}}},

{{{
chmod 666 /dev/ttyS0
chmod 666 /dev/ttyS1}}}
== yum ==
In {{{/etc/yum.repos.d/fedora-repo}}}, {{{/etc/yum.repos.d/fedora-extras.repo}}} and {{{/etc/yum.repos.d/fedora-updates.repo}}}, set the {{{enable}}} flag to {{{1}}}

{{{
enable=1}}}
Do '''NOT''' do this for any of the development files. Doing so can cause libraries to be updated and, as a result, CONTROL may not run.
=== yum ===
Line 135: Line 110:
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}}}
Line 142: Line 111:
Copy {{{vpn.tgz}}} from /u and extract it using the following commands:

{{{
# scp <user>@sam:/u/vpn.tgz /etc/ppp/
# cd /etc/ppp
# tar -xvzf vpn.tgz}}}
Then as root accept the fingerprint:

{{{
# ssh 220.233.135.250
The authenticity of host '220.233.135.250 (220.233.135.250)' can't be established.
RSA key fingerprint is f6:f0:5c:21:74:0e:03:db:fc:71:e6:21:63:b5:c0:43.
Are you sure you want to continue connecting (yes/no)?}}}
Type yes and cancel the connection.

Add the hostname ({{{uname -n}}}) into {{{ /etc/hosts }}} on muppets. Assign the machine the next IP in the sequence.

Also update the ["DNS"].
Add the hostname ({{{uname -n}}}) into{{{ /etc/hosts }}}on muppets. Assign the machine the next IP in the sequence. Also update the ["DNS"].
Line 165: Line 117:
Once the VPN can connect correctly, add to the following to {{{/etc/inittab}}}:

{{{
vpn:2345:respawn:/etc/ppp/connect-crecom >> /var/log/connect-crecom.error}}}
=== Additional Packages Needed by Control ===
The following packages need to be installed to enable some features:

 * mkisofs - building backup CD images
 * sharutils - E-Mailing PDF's
 * dvd+rw-tools - Burning DVD's
 * postgresql-odbc - New Rel9 and 10 installations require DB support.
 * cdrecord - Burning CD/DVD backups
 * rxvt - For running scripts in X11 mode
Line 179: Line 118:
=== Creating the control group ===
Create the following group

{{{
# groupadd -g 3232 control}}}
=== Create and configure the ccc user ===
Create user ccc

{{{
# adduser -g control ccc
# passwd ccc}}}
Edit the {{{~ccc/.bash_profile}}} to the following:

{{{
CUST=`uname -n`
export CUST
export PS1='${PWD}!>'
. /u/cc/usr/common.sh
ccusers}}}
=== Configure the ccc user ===
Line 202: Line 123:
Setup the VNC password

{{{
# mk
dir ~ccc/.vnc
# vncpasswd ~ccc/.vnc/passwd}}}
Crea
te the {{{~ccc/.vnc/xstartup}}} file used by Xvnc. It should read:
Edit the {{{~ccc/.vnc/xstartup}}} file used by Xvnc. It should read:
Line 215: Line 131:
Make {{{~ccc/.vnc/xstartup}}} executable.

{{{
chmod +x ~ccc/.vnc/xstartup}}}
Transfer ownership of folders to ccc

{{{
# chown -R ccc:control ~ccc/.vnc}}}
Line 224: Line 132:
Edit {{{/etc/default/useradd}}} such that the following variables are set and that rest can remain the same.

{{{
GROUP=3232
HOME=/u/cc/usr}}}
Replace the contents of {{{/etc/skel/.bash_profile}}} with the following

{{{
logname=`logname`
. /u/cc/usr/common.sh
if [ "$logname" != "" ]; then
  if [ "$DISPLAY" = "" ]; then
    exec start
  fi
fi}}}
Copy the {{{~ccc/.vnc/}}} folder to {{{/etc/skel/}}}
Copy the{{{~ccc/.vnc/}}}folder to{{{/etc/skel/}}}
Line 245: Line 138:
Package control programs on sam (Server side) Package control programs on sam (Server side, you can copy/paste these into sam via an xterm)
Line 266: Line 159:
tar cvzhf control.tgz --exclude=.sccs $CONTROL_FILES}}}
send control.tgz to client machine

Setup /u/cc/ directory (Client Side)
tar cvzf control.tgz --exclude=.sccs $CONTROL_FILES
tar cvzhf controlmanual.tgz --exclude=.sccs manual}}}
send control.tgz and controlmanual.tgz to client machine (<newhost> is the IP of the new server)

{{{
scp control.tgz controlmanual.tgz ccc@<newhost>:}}}
Exit the connection to Sam

Setup Control (connect using an xterm to the new server as root and just copy/paste these)
Line 275: Line 173:
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
Line 286: Line 176:
tar xvzf PATH_TO_CONTROL_TAR_FILE/control.tgz (do this step if you have already copied control.tgz to client machine) tar xvzf ~ccc/control.tgz
tar xvzf ~ccc/controlmanual.tgz
rm -rf /u/cc/adm/*
Line 294: Line 186:
mv /u/cc/usr/common.linux /u/cc/usr/common.sh}}} rm -rf /u/cc/standard.adm /u/cc/usr/common.sh
mv /u/cc/usr/common.linux /u/cc/usr/common.sh
rm /u/cc/pixmap/menuback.jpg
}}}
Line 296: Line 190:
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
You will need to edit /u/cc/usr/common.sh
Line 314: Line 199:
== Reset all terminals ==
The default terminals may possibly point to non existent companies. Run the following command to point it all to DEMO:(log in as ccc)

{{{
conset -a -c DEMO
export NODEID=console
ccusers
<enter>
14
}}}
Line 315: Line 210:
=== 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>}}}
Line 332: Line 214:
Section "Module" Section "Module"        # Add this line
Line 334: Line 216:
EndSection
Section "Screen"
EndSection # Add this line
Section "Screen" # This already exists
Line 337: Line 219:
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:

{{{
#!/bin/bash
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/}}}
EndSection # This already exists}}}
Line 371: Line 221:
Install Firefox

{{{
yum install firefox}}}
Download the Adobe Acrobat Reader plugin at http://www.adobe.com and install
Download the Adobe Acrobat Reader plugin at http://www.adobe.com and install (use the firefox on the new server)
Line 379: Line 225:
User manual files already included in the tarball copied from sam (/u/ccdev/manual)

== Post Control Installation Options ==
Click on "download Adobe Reader" and save it (defaults to the Desktop directory). Run the installer as root: (note: name may change in the future)

{{{
su -
chmod 755 ~ccc/Desktop/AdbeRdr9.3.1-1_i486linux_enu.bin
~ccc/Desktop/AdbeRdr9.3.1-1_i486linux_enu.bin
}}}
Just accept all the defaults.

=== Post Control Installation Options ===
=== Change the default Background/button colour ===
From vnc:5 as ccc, run cocont. Page 3 options should read:

{{{
208, 233, 243
120, 220, 255
208, 233, 243}}}

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 text terminals.

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

  • / (root) 4-8 Gig depending on size of drive, format as EXT3.

  • swap 1-2 Gig depending on size of system memory.

  • /u with rest of available space, format as EXT3.

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):

Use the following sequence to create 2nd and 3rd partition (2 gig swap, everything else for /u):

n
p
2
<enter>
+2048M
n
p
3
<enter>
<enter>
t
2
82
w

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:

  • IP address: 192.168.1.85
  • Netmask: 255.255.255.0
  • Gateway: 192.168.1.1
  • Nameserver: 192.168.1.1

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

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, you can copy/paste these into sam via an xterm)

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 cvzf control.tgz --exclude=.sccs $CONTROL_FILES
tar cvzhf controlmanual.tgz --exclude=.sccs manual

send control.tgz and controlmanual.tgz to client machine (<newhost> is the IP of the new server)

scp control.tgz controlmanual.tgz ccc@<newhost>:

Exit the connection to Sam

Setup Control (connect using an xterm to the new server as root and just copy/paste these)

touch /dev/lp8
chmod 666 /dev/lp8
umask 0
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 ~ccc/control.tgz
tar xvzf ~ccc/controlmanual.tgz
rm -rf /u/cc/adm/*
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
rm -rf /u/cc/standard.adm /u/cc/usr/common.sh
mv /u/cc/usr/common.linux /u/cc/usr/common.sh
rm /u/cc/pixmap/menuback.jpg 

Libraries

You will 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

Reset all terminals

The default terminals may possibly point to non existent companies. Run the following command to point it all to DEMO:(log in as ccc)

conset -a -c DEMO
export NODEID=console
ccusers
<enter>
14

Make console (DISPLAY=0) a VNC server

Edit /etc/X11/xorg.conf

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

User Manuals

Download the Adobe Acrobat Reader plugin at http://www.adobe.com and install (use the firefox on the new server)

firefox http://www.adobe.com

Click on "download Adobe Reader" and save it (defaults to the Desktop directory). Run the installer as root: (note: name may change in the future)

su -
chmod 755 ~ccc/Desktop/AdbeRdr9.3.1-1_i486linux_enu.bin
~ccc/Desktop/AdbeRdr9.3.1-1_i486linux_enu.bin

Just accept all the defaults.

Post Control Installation Options

Change the default Background/button colour

From vnc:5 as ccc, run cocont. Page 3 options should read:

208, 233, 243
120, 220, 255
208, 233, 243

Backups

  • cocont option Days before display system warning mesg should be set to 30. This allows the client to have at least one system backup to restore various configuration system configuration files in the event of a failure.

  • Enter the Linux device into cocont's Backup device field.

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

  • coaad Setup the company record(s) for the customer.

  • Ensure that the /u/cc/<CUSTOMER> directory exists and is a copy of standard. Also make sure that the correct amount of users and locations have been set.

  • Enter the customer's company name into cocont's Company codes to be backed up field.

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

  • Run any data imports necessary.

Setting up a DEMO company in a server

  • Follow ["DemoCD"] under Linux steps 1-14 for the DEMO company and additional companies as needed.


Installing_Control_server (last edited 2016-11-24 22:33:03 by fuzzy)