|
Size: 10363
Comment:
|
Size: 10828
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 {{{ knoppix 2}}} This will boot up knoppix in text mode and leave you with 4 terminals. |
=== First install CentOS 5 on the server === Boot from the "crecom CentOS 5 quick install" DVD: At the boot screen, type {{{ linux rescue}}} This will boot up Anaconda in text mode and leave you with 2 text terminals. |
| Line 10: | Line 9: |
| * '''/ (root)''' 4-8 Gig depending on size of drive, format as EXT3. * '''swap''' 1-2 Gig depending on size of system memory. |
* '''/ (root)''' 4-20 Gig depending on size of drive, format as EXT3. * '''swap''' 1-4 Gig depending on size of system memory. |
| Line 16: | Line 15: |
| #fdisk /dev/hda | #fdisk /dev/sda |
| Line 34: | 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 36: | Line 53: |
| #mkfs.ext3 -L / /dev/hda1 #mkfs.ext3 -L /u /dev/hda3 #mkswap -L SWAP-sda2 /dev/hda2}}} |
#mkfs.ext3 -L / /dev/sda1 #mkfs.ext3 -L /u /dev/sda3 #mkswap -L SWAP-sda2 /dev/sda2}}} |
| Line 40: | Line 57: |
| 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 |
Manually create the mount point and mount it. {{{ #mkdir /mnt/sda1 #mount /dev/sda1 /mnt/sda1 #mkdir /mnt/sda1/u #mount /dev/sda3 /mnt/sda1/u #mount /dev/hda /mnt/source}}} Adjust the last line accordingly if your dvd drive is not /dev/hda (if it gave you an error) == Untar the CentOS 5 image to the new partition == {{{ #cd /mnt/sda1 #tar xvzj /mnt/source/blankcentos5control.tar.bz2 |
| Line 54: | Line 75: |
| 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: |
First restart the CentOS environment: {{{ #exit #exit}}} Type in "linux rescue". 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: |
| Line 62: | Line 84: |
| #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 |
#rm /boot/initrd-2.6.18-128.el5.img #mkinitrd /boot/initrd-2.6.18-128.el5.img 2.6.18-128.el5 |
| Line 69: | Line 91: |
== After boot up, you may need to reconfigure X == Just accept all the defaults until it asks for the root password and enter it. It will bring up a graphical resolution setting utility. Just choose 1024x768 if you are unsure of the target screen. |
|
| Line 93: | Line 118: |
| 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 100: | Line 119: |
| 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"]. Now would be a good time to restart the machine. It will load the new kernel and the new hostname. |
| Line 107: | Line 128: |
| === 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: {{{ #!/bin/sh 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}}} |
|
| Line 127: | Line 129: |
| 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 148: | Line 150: |
| 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 157: | Line 164: |
| 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 168: | Line 167: |
| 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 176: | Line 177: |
| 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 178: | Line 181: |
| 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 196: | Line 190: |
| == 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 197: | Line 201: |
| === 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 214: | Line 205: |
| Section "Module" | Section "Module" # Add this line |
| Line 216: | Line 207: |
| EndSection Section "Screen" |
EndSection # Add this line Section "Screen" # This already exists |
| Line 219: | Line 210: |
| 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 253: | Line 212: |
| 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 261: | Line 216: |
| 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 coaad. Page 2 options should read: {{{ 208, 233, 243 120, 220, 255 208, 233, 243}}} |
| Line 294: | Line 263: |
| * '''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. |
Setup the company record(s) for the customer''' ''' {{{ $coaad }}} Setup the company record(s) for the customer. * Get the correct details for the company. If you leave some details out now DO NOT FORGET to come back and set it correctly before shipping the server out. * Ask the sales team what Subsystems they purchased and set it up correctly. * Find out the number of locations and number of users and set these accordingly. * Blank out "Today's Date" if there is a date on it. * Ask the sales team what the "Licensed to Date" should be. We normally set this up to the day they have paid the license. (usually 1 month). * Set Y to the fields "Backup Company" and "Autopost". * Check the background Colour settings on page 2 are the same as vnc:5 above. * Create a copy from standard * {{{ $cp -a /u/cc/standard /u/cc/<COMPANY>}}} * Create a test company for them. Change the background Colour settings on coaad to something different. This example gives a pink background. * {{{ 243, 208, 208 255, 220, 120 243, 233, 208}}} === Data Imports === * Run any data imports necessary. |
| Line 306: | Line 297: |
| === Data Imports === * Run any data imports necessary. |
=== Setting up workstations === You will need to get the customer's workstation set up: * windows workstation (regardless of with or without printer, local or remote) * set up openvpn * set up VNC (to connect to openvpn IP) * set up printers if needed (PDE, Label, Docket, Till, Customer Display) * leave directions on what line to change (in openvpn config) when they get connected to the lan * thin client running xdmcp * thin client running vnc * thin client running nx |
First install CentOS 5 on the server
Boot from the "crecom CentOS 5 quick install" DVD: At the boot screen, type
linux rescue
This will boot up Anaconda in text mode and leave you with 2 text terminals.
Partition the hard drive with fdisk to create the following partitions:
/ (root) 4-20 Gig depending on size of drive, format as EXT3.
swap 1-4 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/sda 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/sda1 #mkfs.ext3 -L /u /dev/sda3 #mkswap -L SWAP-sda2 /dev/sda2
Mount the partitions:
Manually create the mount point and mount it.
#mkdir /mnt/sda1 #mount /dev/sda1 /mnt/sda1 #mkdir /mnt/sda1/u #mount /dev/sda3 /mnt/sda1/u #mount /dev/hda /mnt/source
Adjust the last line accordingly if your dvd drive is not /dev/hda (if it gave you an error)
Untar the CentOS 5 image to the new partition
#cd /mnt/sda1 #tar xvzj /mnt/source/blankcentos5control.tar.bz2
after 10-15 minutes the whole image should now be on the new drive.
Boot Loader setup:
First restart the CentOS environment:
#exit #exit
Type in "linux rescue". 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.18-128.el5.img #mkinitrd /boot/initrd-2.6.18-128.el5.img 2.6.18-128.el5 #grub-install /dev/sda #exit #exit
Now Eject the disc. Your system should now boot up.
After boot up, you may need to reconfigure X
Just accept all the defaults until it asks for the root password and enter it. It will bring up a graphical resolution setting utility. Just choose 1024x768 if you are unsure of the target screen.
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"].
Now would be a good time to restart the machine. It will load the new kernel and the new hostname.
To test the VPN connection, use the following:
# pppd call crecom nodetach debug
Configuring the OS for CONTROL
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
X related configuration
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 coaad. Page 2 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
Setup the company record(s) for the customer
$coaad
- Setup the company record(s) for the customer.
- Get the correct details for the company. If you leave some details out now DO NOT FORGET to come back and set it correctly before shipping the server out.
- Ask the sales team what Subsystems they purchased and set it up correctly.
- Find out the number of locations and number of users and set these accordingly.
- Blank out "Today's Date" if there is a date on it.
- Ask the sales team what the "Licensed to Date" should be. We normally set this up to the day they have paid the license. (usually 1 month).
- Set Y to the fields "Backup Company" and "Autopost".
- Check the background Colour settings on page 2 are the same as vnc:5 above.
- Create a copy from standard
$cp -a /u/cc/standard /u/cc/<COMPANY>
- Create a test company for them. Change the background Colour settings on coaad to something different. This example gives a pink background.
243, 208, 208 255, 220, 120 243, 233, 208
Data Imports
- Run any data imports necessary.
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.
Setting up workstations
You will need to get the customer's workstation set up:
- windows workstation (regardless of with or without printer, local or remote)
- set up openvpn
- set up VNC (to connect to openvpn IP)
- set up printers if needed (PDE, Label, Docket, Till, Customer Display)
- leave directions on what line to change (in openvpn config) when they get connected to the lan
- thin client running xdmcp
- thin client running vnc
- thin client running nx
Setting up a DEMO company in a server
- Follow ["DemoCD"] under Linux steps 1-14 for the DEMO company and additional companies as needed.
