Differences between revisions 5 and 9 (spanning 4 versions)
Revision 5 as of 2018-10-22 01:30:59
Size: 6785
Editor: fuzzy
Comment:
Revision 9 as of 2018-10-26 00:00:08
Size: 7350
Editor: fuzzy
Comment:
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
Rsync from sam to ccstandard (add this to OS install instructions)
Rsync from sam ccstandard to new server's ccstandard (do this from sam)

{{{
rsync --delete -avkz /u/ccstandard/ root@<new_server>:/u/ccstandard/
}}}
Line 43: Line 46:
''Need to find out why gorel and other utilities don't work at this point. In the meantime just run''

{{{
export CCDIR=/u/cc<companyname>
. /u/cc/usr/commonx11.sh
}}}
== Adding new session: ==
Add a Linux user and set their password

 . '''Important: do not create <session_name> to be the same as one of the locations. If you need to, add a number at the end. Instead of calling session_name "stafford", call it "stafford1" as there are programs that will automatically create employees with same name as a location.<<BR>> '''

{{{
adduser -b ${CCDIR}/usr -m <session_name> -G sftpusers
mkdir -p /sftp/<session_name>/<session_name>
chmod 755 /sftp/<session_name>
passwd <session_name>
}}}
Add this to /etc/fstab:

{{{
/u/cc/usr/<session_name> /sftp/<session_name>/<session_name> none bind
}}}
Then mount it.

{{{
mount -a
}}}
Edit the file /u/cc/usr/vncusers.sh and add a line

{{{
USER[<USER_NUMBER>]='<session_name>'
RESO[<USER_NUMBER>]='800x600'
HOST[<USER_NUMBER>]='<hostname>'
}}}
<USER_NUMBER> is a vnc session number, for now keep this between 6 and 100. 5 is the screen we use for support.

The 'RESO' line is optional, if you leave it out, it defaults to 1600x900

The 'HOST' line is optional, if you specify something it will put this on the session name when they connect via VNC. If not, it leaves it blank. This is so that when binarylane assigns a strange hostname it is easy to hide it from the end users.

Start up the vnc session manually:

{{{
initctl start turbo VNC=<USER_NUMBER>
}}}
Use a VNC client to connect to <ip_address_of_server>:<USER_NUMBER>. Initial password is set to "123456"

If the menu is on top, go to System->Log out <session_name>, then click OK. If the screen saver has started, unlock it with the linux password and log out. This will move the menus to the bottom of the screen and disable the screen saver.

== Create terminal record and change the VNC password: ==
Open a terminal inside the session:

{{{
vi .vnc/xstartup.turbovnc
}}}
Insert the export CCDIR command under the 2 "unset" commands

{{{
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
export CCDIR=/u/cc<companyname>
export NODEID=vnc:`echo $DISPLAY|cut -d\: -f2`
export GTK2_RC_FILES="/etc/gtk-2.0/gtkrc"
}}}
Run ccusers to create the new terminal.:

{{{
ccusers
}}}
Choose terminal type 14, and if it asks you to press "cancel" use Ctrl-A as F1 won't likely be working.

{{{
conset -c <COMPANY_NAME>
}}}
{{{
/opt/TurboVNC/bin/vncpasswd
}}}
Edit the file /etc/init/start-xvncs.conf and add the number to the string ACTIVE_VNCSCREENS

{{{
env ACTIVE_VNCSCREENS="5 6 7 8 9 10 11 12"
}}}
This is to make sure the session will auto startup if the server was restarted.

create guacamole account:

in the web page http://<ip address>:8080/guacamole, log in as guacadmin

click on the guacadmin on the upper right then click on settings

click on connections

click on New Connection

{{{
Name: <session_name>
Maximum number of connections: 5
Maximum number of connections per user: 5
Hostname: localhost
Port: <5900+USER_NUMBER>
Password: <vnc_password>
Enable SFTP: <Tick>
Hostname: localhost
Port: 22
Username: <session_name>
Password: <Linux_password>
Default upload directory: /<session_name>
}}}
and then click Save.

Click on Users

Click on Add New User

{{{
Username: <session_name>
Password: <set up a password for end user>
Re-enter Password: same as Password
Change own password: <tick>
}}}
Connections:

tick on <session_name>
Line 46: Line 171:
Package '''control''' programs on sam (Server side)

{{{
export
_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
.tgz --exclude=.sccs $
_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:
 /u/cc/LOG /u/cc/usr
chown ccc:
 /u/cc/usr/ccc /u/cc/usr/ccc/.*
cd /u/cc
tar xvzf PATH_TO_
_TAR_FILE/
.tgz (do this step if you have already copied
.tgz to client machine)
chown ccc:
 std/* std/*/*
chown ccc:
 binl/*
chown ccc:
 binx11/*
binl/link_cntrl
chown ccc:
 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
}}}
== X related configuration ==
=== 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 ===
== Don't do any of the following yet. ==
Make console (DISPLAY=0) a VNC server
Line 160: Line 185:
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)

Copy CONTROL

Rsync from sam ccstandard to new server's ccstandard (do this from sam)

rsync --delete -avkz /u/ccstandard/ root@<new_server>:/u/ccstandard/

on the new machine

mkdir /u/ccr.<release_no>
cd /u/ccr.<release_no>
rsync -av /u/ccstandard/ ./

Create a new environment:

mkdir /u/cc<companyname>
cd /u/cc<companyname>
rsync -av /u/ccr.<release_no>/{adm,binl,binx11,LOG,overlay,usr} ./
ln -s /u/ccr.<release_no>/{env,lang_ts,lib,manual,pixmap,standard,std} ./

Set up a new company

export CCDIR=/u/cc<companyname>
export NODEID=vnc:5
cp -a standard <COMPANYNAME>
cd
ln -s `which coaad` contrl
./contrl

Clone the "standard" company to <COMPANYNAME> (make sure COMPANYNAME is in all caps, and 8 characters or less)

<insert screen cap of company file maintenance here>

Don't forget to delete your link

rm ./contrl

Then go to your company:

conset -c <COMPANYNAME>

Need to find out why gorel and other utilities don't work at this point. In the meantime just run

export CCDIR=/u/cc<companyname>
. /u/cc/usr/commonx11.sh

Adding new session:

Add a Linux user and set their password

  • Important: do not create <session_name> to be the same as one of the locations. If you need to, add a number at the end. Instead of calling session_name "stafford", call it "stafford1" as there are programs that will automatically create employees with same name as a location.

adduser -b ${CCDIR}/usr -m <session_name> -G sftpusers
mkdir -p /sftp/<session_name>/<session_name>
chmod 755 /sftp/<session_name>
passwd <session_name>

Add this to /etc/fstab:

/u/cc/usr/<session_name>        /sftp/<session_name>/<session_name>   none bind

Then mount it.

mount -a

Edit the file /u/cc/usr/vncusers.sh and add a line

USER[<USER_NUMBER>]='<session_name>'
RESO[<USER_NUMBER>]='800x600'
HOST[<USER_NUMBER>]='<hostname>'

<USER_NUMBER> is a vnc session number, for now keep this between 6 and 100. 5 is the screen we use for support.

The 'RESO' line is optional, if you leave it out, it defaults to 1600x900

The 'HOST' line is optional, if you specify something it will put this on the session name when they connect via VNC. If not, it leaves it blank. This is so that when binarylane assigns a strange hostname it is easy to hide it from the end users.

Start up the vnc session manually:

initctl start turbo VNC=<USER_NUMBER>

Use a VNC client to connect to <ip_address_of_server>:<USER_NUMBER>. Initial password is set to "123456"

If the menu is on top, go to System->Log out <session_name>, then click OK. If the screen saver has started, unlock it with the linux password and log out. This will move the menus to the bottom of the screen and disable the screen saver.

Create terminal record and change the VNC password:

Open a terminal inside the session:

vi .vnc/xstartup.turbovnc

Insert the export CCDIR command under the 2 "unset" commands

unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
export CCDIR=/u/cc<companyname>
export NODEID=vnc:`echo $DISPLAY|cut -d\: -f2`
export GTK2_RC_FILES="/etc/gtk-2.0/gtkrc"

Run ccusers to create the new terminal.:

ccusers

Choose terminal type 14, and if it asks you to press "cancel" use Ctrl-A as F1 won't likely be working.

conset -c <COMPANY_NAME>

/opt/TurboVNC/bin/vncpasswd

Edit the file /etc/init/start-xvncs.conf and add the number to the string ACTIVE_VNCSCREENS

env ACTIVE_VNCSCREENS="5 6 7 8 9 10 11 12"

This is to make sure the session will auto startup if the server was restarted.

create guacamole account:

in the web page http://<ip address>:8080/guacamole, log in as guacadmin

click on the guacadmin on the upper right then click on settings

click on connections

click on New Connection

Name: <session_name>
Maximum number of connections: 5
Maximum number of connections per user: 5
Hostname: localhost
Port: <5900+USER_NUMBER>
Password: <vnc_password>
Enable SFTP: <Tick>
Hostname: localhost
Port: 22
Username: <session_name>
Password: <Linux_password>
Default upload directory: /<session_name>

and then click Save.

Click on Users

Click on Add New User

Username: <session_name>
Password: <set up a password for end user>
Re-enter Password: same as Password
Change own password: <tick>

Connections:

tick on <session_name>


Don't do any of the following yet.

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

Post Control Installation Options

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, seeLaser_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.

Describe Installing_Control here.

Installing_Control (last edited 2019-03-11 05:08:01 by fuzzy)