CUSTOMER NAME:
CONTACT:
PROJECT TITLE:
DATE TO BE DONE:
AUTHOR:
DATE SUBMITTED:
OVERVIEW –
UniVision binary upgrade for SVR4,Unixware 7 and
Linux.
PRE-REQUISITES
–
2 verified
file-saves to be completed prior to upgrade.
EQUIPMENT LIST
–
Old UniVision
media
New UniVision
media
DETAILS –
1. Ensure
Customer has taken 2 verified file-saves.
2. Ensure all
media is on site as per on site documentation media listing.
3. Ensure customer has shut down all Processes, including all Background
Processes and that all processes are logged
out and quit from UniVision.
Use LISTPRO W to establish this, if any
processes are still logged in they will
be displayed, ask the customer to logoff
and quit any processes displayed. If
all processes are logged off then only the
process that the LISTPRO W is
being executed from will be displayed.
4. Change univ password (to stop users logging in during upgrade)
To do this enter the
following from root:
# passwd univ
New password: <enter new password>
N.B. univ
is used as the UniVision user in this example, if different substitute as
appropriate.
4a. Make a note of the Univision installation path by performing the following from UCL.
>!pwd
This will
produce an output similar to the following, this output is the home
path for
this Univision installation.
e.g. /unistore1/edp
5. Obtain a
print of T-STATUS, in order to verify that the tape drive order is
retained. To do this first use SP-ASSIGN to select an available printer then enter the following from UCL.
>T-STATUS (P
6. Ensure no prints are in
progress. To do this enter the following from root:
#lpstat
–o
If there are prints in
progress they will be displayed.
e.g. # lpstat -o
test1-58402 edp 184 May 19 10:47:36
Establish which printers are
in progress, ensure they are printing and either wait for them to complete or
with the customers permission cancel them by using the following command with
the relevant print job request number:
e.g. #cancel test1-58402
Re-execute an lpstat –o to ensure all prints are now complete or
cancelled.
7. Run latest
MAININFO Script and print output from /tmp (systeminfo) To do
this
carry out the following:
Insert the TAR formatted diskette with the maininfo script, into the diskette drive on the server.
Log in as
the root user and from the root prompt enter the following commands:
# mkdir systeminfo
# cd systeminfo
From
within the new directory enter the following:
# tar -vtf
/dev/rdsk/f0t
This will verify the TAR file located on the
diskette
# tar –xvf
/dev/rdsk/f0t
This will extract the contents of the diskette
and then return to the root prompt.
At the root prompt enter:
a) # chmod 777 maininfo
b) # sh maininfo
The
script has now been run and the resulting file created, which is located in /tmp, called systeminfo.html.
Rename the file and TAR it back to the diskette.
Use the following commands to do so:
# cd /tmp
# mv systeminfo.html
<customername>.html
Remove the original diskette and insert a blank
diskette. Perform the following:
# tar –cvf
/dev/rdsk/f0t <customername>.html
The maininfo is then printed and along with a copy on a
diskette, this remains
on-site.
8. Mount the UniVision CD. To do this enter the
following from root once the CD is inserted into the CD drive.
#mount –F cdfs –o ro /dev/cdrom/cdrom1 /mnt (for SVR4
and Unixware 7)
#mount /mnt/cdrom (for Linux)
10. Install
the new Univision package, to do this enter the
following from root:
#pkgadd –d
/mnt/ncr univision (for svr4)
#pkgadd –d
/mnt/sco univision (for unixware
7)
#rpm –i --force
--prefix $home /mnt/cdrom/linux/UniVisionxx (for linux)
(Where $home is the Univision installation path
noted earlier in option 4 and
xx is the version number of UniVision).
When prompted for installation path. Enter the
UniVision home directory
e.g /unistore1/univ
(This was noted earlier in
option 4).
Choose the U option,
to upgrade.
N to configure registry.
Y to re-link kernel.
Once complete reboot the
machine using the following:
#shutdown –y –i6 –g0
Login to UV. (If prompted
for password, enter OBJECTWARE).
When prompted setup the
tapes by inputting the relevant capitalised letter
relevant to the device type. The screen display will be similar to below, once
a letter is entered the cursor will reposition at the next device, once all
devices are entered input <esc> to [proceed].
LINUX Device Names Type Default B/S [Description] Page : 1 of 1
/dev/fd0H720 1.44MB Low Density
(720K)
/dev/nst0 Tape "Wangdat Model 3400D
Enter Device Type [Q]uarter
Inch, [F]loppy, [H]alf
Inch, [E]8mm, [D]at, d[L]t,
[T]ravan, [C]dRmo, lt[O]
Press (space) to Delete, or (Esc) to Finish :
11. Once at LOGON, Logon as
Sysprog and choose the UPGRADE
ACCOUNTS option from the SYSPROG menu.
(Option 4).
Enter ALL for all accounts.
Enter
NO to recompile
Enter YES to continue with list.
Once
complete exit the menu and access UCL.
12. Check
that the tape drive LTU numbers remain the same as before the
upgrade.
To do
this enter the following from UCL
>T-STATUS
This
will display a similar listing to the following:
0
F0 HIGH DENSIT High Density (1.44M) /dev/fd0H1440
1 D0 "Wangdat
Model 3400DX" /dev/nst0
2 FVT Virtual Tape
Drive ./VTape01.vfd
3
FVT (D3
Pick) Pseudo Tape ./VTape02.vtd
4
UVT UniVision VTape
./UVTape00
AUTOSAVE UVT UniVision
VTape
./UVTape00
Compare this to the T-STATUS listing obtained earlier.
If
they are different change back to the original order using the following
command:
> SET-TAPE
<device number> <LTU number>
e.g.
>SET-TAPE 4, F0
Execute this command as many times as is required to get the tape drives
in the
correct order.
N.B. It may be necessary to move
a tape drive to a non-existent LTU
number in order to complete the task.
13. Check
the emulation settings by performing the following from UCL:
>DEFINE-CURSOR
This will display something similar to the
following:
UniVision System Terminal Cross Reference
Utility
A maximum of 52 terminal types are allowed
& those selected are shown
below.
The terminal name must follow the system
conventions for "terminfo" device
names & exist in the "/usr/share/terminfo/?" directory.
A:at386 N:nutc a:AT386 n:nutc
B:at386-m O: b:AT386-M o:
C:at386-ie P:hp2621a c:AT386-ie p:via-prism
D:dterm Q:uvwyse50 d:via-cifer q:via-qume
E:dtterm R: e:via-esprit r:via-regent
F: S:ansi f: s:ANSI
G: T:tec g: t:
H: U:viewpoint h:hft u:
I:UVibmpc V:viewpoint5 i:ibm3151 v:viewpoint132
J:UVvt100 W:viewpoint132 j:vt100 w:via-wyse60
K:linux X:wyse160 k:vt200 x:
L:lft Y: l:via-vt52 y:
M:ampex Z:xterm m: z:
Enter the Terminal Cross Reference Letter if changes
required or 0 to exit.
Enter Selection (A-Z, a-z, 0) :-
Compare the letters and terminal definitions to those recorded in the
termxref listing obtained in the MAININFO.
If
there are differences then amend to the original settings by carrying out
the
following for the relevant cross reference letters.
N.B. The letter m is used in the following
example
Enter
Selection (A-Z, a-z, 0) :
You
are about to change the Cross Reference Name for Letter "m".
Is
this correct? (Y/N) :- y
Enter
the Terminal Name (14 characters max or # to delete it) :- viewpoint
You
are changing the Cross Reference Name for Letter "m" to
"viewpoint".
Is
this correct? (Y/N) :- y
The
"termxref" file has been successfully
changed.
Press
any key to return to the menu.
14. Licence
UniVision using by carrying out the following from UCL:
>!Authorize
This will display a screen similar to the
following:
Authorisation
codes:-
<1>
148444-2067-7000
<2>
EDP Support
<3>
116-1A87
<4>
703-2166-694-2166520
<5>
101301
<6>
989632
<7>
<8>
Enter 'M' to modify or 'E' to exit:
Enter the licence
information exactly as it appears on the
Univision CD case.
To do this enter the
following:
Enter 'M' to modify or 'E'
to exit: M
Enter line to modified: <input
line to be modified>
Enter code: <input
relevant licence code>
Repeat this procedure until all the licencing information is entered as per the Univision CD case.
15. Ensure MAXUSERS is set correctly by typing the following from UCL:
>MAXUSERS 5000
[9218] Maximum number of users is now : 101
This will set UniVision for the maximum permitted user licences for this
installation. (In the above example 101). Check with the customer that
sufficient licences are available.
16. Type the following on the system console from UCL to access the Univision
administrator menu:
>:QUIT
The following menu will be displayed:
Univision Setup
Univision admin tools
Univision tape utilities
Enter Univision
Exit
Use the cursor keys to highlight the UniVision setup option type <cr> to access the Univision setup menu:
The following menu will be displayed:
UniVision SETUP MENU
----------------------
(0) Exit
(1) Initial Parameter File Build
(2) Maintain Process Records
(3) Maintain Terminal Cross References
(4) Maintain Device Name Specifications
(5) Maintain Printer Records
(6) Maintain Initial TERM Settings
(7) Control Sub Menu
(8) Display Process Status
(9) Check For Unrelated UV's & SS's
(10) Maintain Process Size Limits
(11) Maintain Default Alternate Break Key Value
(12) Maintain External Spool File
(13) Maintain UniVision Network Parameters
(14) Maintain
(15) Maintain Timeout Parameters
Enter required option number :-
Take the following option to access the Process size limits options:
Enter required option number :-10
The following will be displayed:
*******************************************************************************
WARNING: THE "univision/admin/default_process_size" FILE MUST ONLY
BE CHANGED WHEN UniVision IS NOT IN USE!
*******************************************************************************
Do you wish to continue? (Y/N):
Enter the following to proceed:
Do you wish to continue? (Y/N):Y
The process size limits parameters will now bw displayed.
Check the settings displayed against the original process size limits recorded earlier by the MAININFO.
Process Size Limits:
<1> NormalProcessSize:700
<2> PrintersStartLine:0
Please wait while line quantities are checked ...
Line quantitites OK.
(E)xit (M)odify (S)how file :-
If the settings are lower than previously, then alter by carrying out the following:
(E)xit (M)odify (S)how file :-M
Enter <line> number of setting to modify
:- <Enter line to modify>
Enter new setting :- <Enter new setting>
Repeat these steps if more than one setting needs to be amended.
On completion the Univision setup menu will again be displayed:
17. Ask the customer to check the functionality of their remote Univision links.
If they do not function correctly then carry out the following steps to
reconfigure:
|
Network |
LOCAL
REMOTE
The first task is to create a UVListen process on the remote machine, this process
will run in the back ground on the remote system waiting for a login session on the
UniVision port (normally 2820).
The first thing to do is to login
into UniVision on the remote machine and then
enter the UVsetup menu. Upon entering the UVsetup menu you may receive a
warning stating that there appears to
be users in UniVision, enter Y to proceed to
the menu.
$ UVsetup
Please wait ....
There appears to be 1 process(es) still logged-on to UniVision.
Do you still want to enter UVsetup? (y/n) :- y
Please wait ....
Once you have the setup menu in
front of you select option “13”,
Maintain
Local/Remote UniVision Names.
UniVision SETUP
MENU
----------------------
(0)
Exit
(1)
Initial Parameter File Build
(2)
Maintain Process Records
(3)
Maintain Terminal Cross References
(4)
Maintain Device Name Specifications
(5)
Maintain Printer Records
(6)
Maintain Initial TERM Settings
(7)
Control Sub Menu
(8)
Display Process Status
(9)
Check For Unrelated UV's & SS's
(10)
Maintain Process Size Limits
(11)
Maintain Default Alternate Break Key Value
(12)
Maintain External Spool File
(13)
Maintain Local/Remote UniVision Names
(14)
Maintain COM Port Parameters File (NT only)
(15)
Maintain Timeout Parameters
Enter required option number :- 13
From the Maintain Local/Remote
UniVision Names menu select “u” for
UVRegistry.
Maintain Local/Remote UniVision Names
------------------ Maintain -----------------
(E)xit (I)dentity
Name (R)emote Names (U)VRegistry :- u
Now select “S” for UVServiceRegistry. (Extra option in UniVision 8.0.10)
If this is the first time that a UVRegistry has been created then the system will
report that the registry file is
empty and will then prompt you to select “a” to add.
The registry file is empty or does not exist.
(E)xit (A)dd :- a
For the Alias Name enter the UniVision user login on the remote system which
in the example is “univ”.
For the Program path and name enter the UniVision home path on the remote
system followed by /univision/bin/UVS.sh, which is
“/unistore1/univ/univision/bin/UVS.sh” in the example.
Enter the Program Path & Name (ESC to
exit):-
/unistore1/univ/univision/bin/UVS.sh
For the working directory enter the UniVision home path which is
“/unistore1/univ” in the example.
For the Program parameters just
enter a <cr>.
For the user name enter the UniVision user name for the remote system which
in the example is “univ”.
The server should be set to
active so enter a “y”.
As it read’s
an optional comment is optional so just enter a <cr>.
You will now be prompted to enter the UniVision password for the remote
system, enter this if there is one otherwise just enter a <cr>.
Enter the User's Password (ESC to exit):-
Re-Enter the User's Password (ESC to exit):-
The UVRegistry
process is now complete, enter any key to continue.
Press any key to continue.
This time the registry file is
displayed in the menu, select “e” to exit.
The Program Alias Names & Working
Directories in the registry file are:
univ /unistore1/univ
(E)xit (D)elete (M)odify (S)how
(A)dd
:- e
On completing the UVRegistry a check is made to see if there is a univision entry in the /etc/inet/services
file, if there is not entry then enter a “y” to create one.
"univision"
does not exist in
"/etc/inet/services"
for "tcp"
protocol.
Do
you want to add to the file now? (Y/N):- y
The standard tcp port is 2820 which should be used unless this port is in use
by another application, select “y” use the standard tcp port and it will error if it
is in use.
There is no real need to
create an alias at this point so select “n” to say no.
You will now be prompted to update the /etc/inet/services
file enter “y”
to accept.
OK to add
"univision
2820/tcp "
to the "/etc/inet/services"
file? (Y/N):- y
UniVision will be added to
the /etc/inet/services, hit any key to continue.
"univision"
added to "/etc/inet/services".
Press any key to continue.
This complete’s the configuration on the remote system, select “e” to exit at
the Maintain Local/Remote UniVision Names
menu.
Maintain Local/Remote UniVision Names
------------------
Maintain -----------------
(E)xit (I)dentity
Name (R)emote Names (U)VRegistry :-
From the UniVision setup
menu select “0” to exit.
UniVision SETUP
MENU
----------------------
(0) Exit
(1)
Initial Parameter File Build
(2)
Maintain Process Records
(3)
Maintain Terminal Cross References
(4)
Maintain Device Name Specifications
(5)
Maintain Printer Records
(6)
Maintain Initial TERM Settings
(7)
Control Sub Menu
(8)
Display Process Status
(9)
Check For Unrelated UV's & SS's
(10)
Maintain Process Size Limits
(11)
Maintain Default Alternate Break Key Value
(12)
Maintain External Spool File
(13)
Maintain Local/Remote UniVision Names
(14)
Maintain COM Port Parameters File (NT only)
(15)
Maintain Timeout Parameters
Enter required option number :- 0
With you configuration in place all that is left to do is to start the UniVision
listener process by entering “UVListen –l” at the UniVision shell prompt.
$ UVListen -l
UVListen -l: 'UVListenerd' launched
$ UVsetup
Please wait ....
The first thing to do is to
login into UniVision on the local machine and then
enter the UVsetup
menu. Upon entering the UVsetup menu you may receive
a warning stating that there
appears to be users in UniVision, enter “y” to
proceed to the menu.
There appears to be 1 process(es) still logged-on to UniVision.
Do you still want to enter UVsetup? (y/n) :- y
Please wait ....
Once you have the setup menu
in front of you select option “13”,
Maintain
Local/Remote UniVision Names.
UniVision SETUP
MENU
----------------------
(0)
Exit
(1)
Initial Parameter File Build
(2)
Maintain Process Records
(3)
Maintain Terminal Cross References
(4)
Maintain Device Name Specifications
(5)
Maintain Printer Records
(6)
Maintain Initial TERM Settings
(7)
Control Sub Menu
(8)
Display Process Status
(9)
Check For Unrelated UV's & SS's
(10)
Maintain Process Size Limits
(11)
Maintain Default Alternate Break Key Value
(12)
Maintain External Spool File
(13)
Maintain Local/Remote UniVision Names
(14)
Maintain COM Port Parameters File (NT only)
(15)
Maintain Timeout Parameters
Enter required option number :- 13
From the Maintain Local/Remote
UniVision Names menu select “r” for Remote
Names.
Maintain Local/Remote UniVision Names
------------------ Maintain
-----------------
(E)xit (I)dentity Name (R)emote Names (U)VRegistry :- r
The system will now display the default entries for the local system, select “a”
to add a new entry.
The format for the "univision/admin/remote_univision_names" file is:
ConnectionAliasName;ProgramAliasName@SystemHostName;Optional
Comment
The entries are:
<1>
UNIV;UniV@localhost;
<2>
UVLocal;UniV@localhost;
(E)xit (D)elete (A)dd :- a
The Connection Alias Name is a can be anything as this is what you are
going to call your link, in the example I have called it “univbox1”.
The Program Alias Name is the login for UniVision on the remote system,
which in the example is “univ”.
The system name is the name that is in or is to be entered into the /etc/hosts
file, in the example I have used “os4”.
As it read’s
an optional comment is optional so just enter a <cr>.
The program will now check the entries in the /etc/hosts file and then prompt
for a new entry added or confirmed, select “c” for correct.
Please wait while the database is checked
...
There is an entry for "os4" in
"/etc/inet/hosts"
as follows:
128.2.0.4 os4
Is this file entry correct or do you want
to delete it? (C/D):- c
The host file will now be
updated, hit any key to continue.
Press any key to continue.
The remote entries will be listed again, this time with the addition of the new
entry to the remote system. With your configuration complete select “e” to exit.
The format for the "univision/admin/remote_univision_names" file is:
ConnectionAliasName;ProgramAliasName@SystemHostName;Optional
Comment
The entries are:
<1>
UNIV;UniV@localhost;
<2>
UVLocal;UniV@localhost;
<3>
univbox1;univ@os4;
(E)xit (D)elete (A)dd :- e
This complete’s the configuration on the local system, select “e” to exit at the
Maintain Local/Remote UniVision
Names menu.
Maintain Local/Remote UniVision Names
------------------ Maintain
-----------------
(E)xit (I)dentity
Name (R)emote Names (U)VRegistry :- e
From the UniVision setup
menu select “0” to exit.
UniVision SETUP
MENU
----------------------
(0)
Exit
(1)
Initial Parameter File Build
(2)
Maintain Process Records
(3)
Maintain Terminal Cross References
(4)
Maintain Device Name Specifications
(5)
Maintain Printer Records
(6)
Maintain Initial TERM Settings
(7)
Control Sub Menu
(8)
Display Process Status
(9)
Check For Unrelated UV's & SS's
(10)
Maintain Process Size Limits
(11)
Maintain Default Alternate Break Key Value
(12)
Maintain External Spool File
(13)
Maintain Local/Remote UniVision Names
(14)
Maintain COM Port Parameters File (NT only)
(15)
Maintain Timeout Parameters
Enter required option number :- 0
To test that you link works logon to your local system and edit a new “MD”
item called “TEST”. Insert a “Q” in line 1 to denote a q pointer, in line 2 you
need to enter the Account name on the remote system for example “COMMS”,
followed by the “@”symbol, followed by the name of the remote link, which in
the example was “univbox1”. Line 3 is the name of the file on the remote
system in the example I have used “MD”.
>ED MD TEST
NEW ITEM
TOP
.I
001+Q
002+COMMS@univbox1
003+MD
004+
TOP
.FI
'TEST' filed.
Now we have a TEST file in place, LIST the file, if the file list without any errors
then your configuration is successful, if your LIST errors with “file not found”
then you need to check your configuration.
>LIST TEST
PAGE
1
14:42:26 13 MAY 2002
TEST...............................
1......... AMC....... S/NAME.... STRUCT
BLOCK-CONVERT Q BLOCK-CONV
T-ERASE
P
73
80 P
E6
V/TYP A
09 TP
CM.CHECK.LINE P E6
VIAODBC16 P
E6
:ITB PQ
[UVPROCS N
A]
VTW.GET.TEXT P E6
GUI.UVSPOOL1 P E6
CONVERSE P
212
SUBX P
17
CREATE-BFILE PC 26
ENABLE-DELETE-TRIGGER PD
2 7C
PCCTRL.PROG P E6
KERMIT P E6
STD.DEFS P E6
*A2 A
02 *A2
>
Set permission on the /etc/UVServiceRegistry to –rw-rw-rw.
Once this is complete return to the UniVision setup menu and take the following option
to return to the login prompt:
18. Ask
customer to test application and printer functionality.
19. Change
the UniVision password back to the original setting using the
instructions
outlined in step 4.
20. Perform
another MAININFO using the instructions in point 7, send a copy to
custinfo@edp.fastfreenet.com.