Upgrading Xyplex Software From CD-ROM To An Alpha Host

Pre-Installation Activities

Please complete the following steps prior to copying the new Alpha files down to your host.

 To preserve the parameters for your Xyplex unit, copy your parameter file (located in MOM$LOAD) to another directory.
 
 Rename the current software image name.  For example, if you are currently running V5.3.1 software on an MX1640, the image name in MOM$LOAD: would be xpcsrv20.sys.  Rename it to xpcsrv20.v531.
 
 Rename sys$common:[sysexe]xyp_server.exe to xyp_server.old
 Rename sys$common:[sysexe]xyp_manager.exe to xyp_manager.old.
 
 Rename sys$manager: xyp_manager.com to xyp_manager.old.


CDROM INSTALLATION PROCEDURE:

$ show dev/full  (gets the correct device name for your CDROM drive  - ex: DKAx:)

Disk SSEALP$DKA0:, device type RRD43, is online, file-oriented device,
    shareable, available to cluster, error logging is enabled.

    Error count                    0    Operations completed               226
    Owner process                 ""    Owner UIC                     [SYSTEM]
    Owner process ID        00000000    Dev Prot           S:RWPL,O:RWPL,G:R,W
    Reference count                0    Default buffer size                512
    Total blocks               16876    Sectors per track                    4
    Total cylinders              704    Tracks per cylinder                  6


$ mount /override=indentification DKA0:

Disk SSEALP$DKA0:, device type RRD43, is online, file-oriented device,
    shareable, available to cluster, error logging is enabled.

    Error count                    0    Operations completed               226
    Owner process                 ""    Owner UIC                     [SYSTEM]
    Owner process ID        00000000    Dev Prot            :RWPL,O:RWPL,G:R,W
    Reference count                0    Default buffer size                512
    Total blocks               16876    Sectors per track                    4
    Total cylinders              704    Tracks per cylinder                  6


$ set default DKA0:[000000]

$ directory 

Directory DKA0:[000000]

ALPHAVMS.DIR;1      APGEN.TAR;1         CCL.TAR;1           DEFAULT.DMP;1      
DEFAULT.PRM;1       DOCS.DIR;1          DOS.DIR;1           HOST.TAR;1         
KERMIT.EXE;1        MCFFS1.SYS;1        MX1400A.SYS;1       MX1500.SYS;1       
MX1710.SYS;1        MX25GW.SYS;1        MX800.SYS;1         TSMJ8LT.SYS;1      
UNIXVMS.DIR;1       VAXVMS.DIR;1        XPCS00C.SYS;1       XPCS00S.SYS;1      
XPCSRV20.SYS;1        

$ set def [.alphavms]

$ directory

Directory DKA0:[000000.ALPHAVMS]

README.TXT;1        README.VMS;1        XMANAGER.EXE;1      XSERVER.EXE;1


 You will notice that there are no savesets in this directory.  You must use the COPY command to place the files in the appropriate directories.  All the files you will need for setting up the host for image/parameter loading and Xyplex server images are in this directory.   Due to file length restrictions, the host file names are slightly different.  Cpy to the destination using the original names.

$ copy  xserver.exe sys$common:[sysexe]xyp_server.exe
$ copy xmanager.exe sys$common:[sysexe]xyp_manager.exe
$ copy xmanager.com  sys$manager:xyp_manager.com
$ set def [-.as]
$ copy xpcsrv20.sys sys$common:[mom$system]xpcsrv20.sys  (specify the correct image name(s) for your xyplex unit)


NOTE:	Due to the use of different file formats used by the Alpha workstation and the CD-Rom, the following file conversion will need to be done to the file XYP_MANAGER.COM on the Alpha workstation.

1.	$ set default sys$manager

2.	Open the Filview application from the Applications pull down menu.

	In the field at the top of the Fileview display, enter:  sys$sysroot:[sysmgr]
	In the File Filter field at the bottom of the display, enter:  xyp_manager.com

3.	Click on Apply.

4.	Highlight the file xyp_manager.com.  From the Application pull-down menu choose Note Pad.

5.	From Note Pad choose the File pull-down menu and select  Open Selected which will open the xyp_manager.com file.

6.	Save the file as xyp_manager.com.  This creates a new version of  the sys$manager:xyp_manager.com file with the correct file format. 

7.	Please purge sys$manager:xyp_manager.com to remove obsolete versions of this file.


CONFIGURING THE ALPHA HOST AS A LOAD SERVER:

$ run sys$system:ncp
NCP>  show active circuit (list the DECnet  service circuits on your system, ex: SVA-0, QNA-0, make sure state = ON)

Active Circuit Volatile Summary as of 21-JUL-1995 09:15:58

   Circuit          State                   Loopback     Adjacent
                                              Name      Routing Node
    SVA-0             on                                  1.100


NCP> show circuit circuit-name characteristics (verify that Service = enabled, State = on)

NCP>show circuit sva-0 characteristics

Circuit Volatile Characteristics as of 21-JUL-1995 09:16:12

Circuit = SVA-0

State                    = on
Service                  = enabled
Designated router        =  1.100
Cost                     = 4
Maximum routers allowed  = 33
Router priority          = 64
Hello timer              = 15
Type                     = Ethernet
Adjacent node            =  1.100
Listen timer             = 45

NCP>  show known nodes (lists currently defined nodes/addresses defined in database)

Known Node Volatile Summary as of 21-JUL-1995 09:17:10

Executor node = 1.230 (SSEALP)

State                    = on
Identification           = DECnet for OpenVMS AXP V6.1

    Node           State      Active  Delay   Circuit     Next node
                              Links
 
 1.200 (X391F)                                SVA-0         1.100
 1.209 (XANTH)                                SVA-0         1.100
 1.211 (MANNAH)                               SVA-0         1.100
 1.224 (X5A116)                               SVA-0         1.100
 1.225 (XAB9BB)                               SVA-0         1.100
 1.250 (X47181)                               SVA-0         1.100
 1.251 (X26B44)                               SVA-0         1.100
 1.252 (X26B42)                               SVA-0         1.100
 1.253 (X16DCE)                               SVA-0         1.100
 1.254                                        SVA-0         1.100
 1.300 (X566F3)                               SVA-0         1.100
57.101 (IMPC1)                                SVA-0         1.100


Using NCP Commands to Add a Unit to the DECnet Database

a.	Type the command:

	$ RUN SYS$SYSTEM:NCP

b.	The system will respond with the NCP> prompt. At the NCP> prompt, type the following commands:

	NCP>SHOW CIRCUIT service-circuit CHARACTERISTICS

Examine the NCP display to determine the setting for the "State" and "Service" characteristics.  (If the "Service" characteristic is shown as enabled, go to the next step.)  If the circuit "Service" characteristic is shown as disabled you must bring down the circuit in order to enable the service.  This will kill any activity over that circuit.  Type the following commands:

	NCP>SET CIRCUIT service-circuit STATE OFF
	NCP>DEFINE CIRCUIT service-circuit SERVICE ENABLED
	NCP>SET CIRCUIT service-circuit SERVICE ENABLED
	NCP>SET CIRCUIT service-circuit STATE ON

c.	At the NCP> prompt, type the following commands (for each Xyplex unit):

	NCP>DEFINE NODE decnet-node-address NAME decnet-node-name
	NCP>DEFINE NODE decnet-node-address SERVICE CIRCUIT service-circuit
	NCP>DEFINE NODE decnet-node-address HARDWARE ADDRESS ethernet-address
	NCP>DEFINE NODE decnet-node-address LOAD FILE loader-directory-name:load-filespec
	NCP>DEFINE NODE decnet-node-address DUMP FILE dump-filespec
	NCP>SET NODE decnet-node-address ALL

where:

	service-circuit	represents the DECnet Service Circuit-ID of the load server (e.g., UNA-0 or UNA-1 for a UNIBUS adaptor, BNT-0 or BNT-1 for a BI Bus adaptor, QNA-0 or QNA-1 for a Q-Bus adaptor, or SBA-0 for a MicroVAX 2000 adaptor).
	decnet-node-name	represents the 1 to 6 character DECnet node name for the unit.
	decnet-node-address	represents the DECnet node address you assigned for the unit.
	ethernet-address	represents the unique Ethernet address of the unit.  For a MAXserver 1000 Series Server, refer to the label on the rear of the unit to determine the Ethernet address  For a MAXserver 4500, 5000, or 5500, refer to the label on the rear of the MAXserver chassis to determine the base Ethernet address for the MAXserver.  Each MAXserver card has a unique Ethernet address that you calculate by adding the slot number to the base address.
	loader-directory-name 	represents the Loader directory you specified during the software installation procedure (refer to chapter 2) 


Example NCP configuration for an MX-1600 terminal server:

$ run sys$system:ncp

NCP> define node 1.224 name x5a115
NCP> define node 1.224 service circuit sva-0
NCP> define node 1.224 hardware address 08-00-87-05-a1-16
NCP> define node 1.224 load file [mom$load]:xpcs00s.sys
NCP> define node 1.224 dump file [mom$load]:x5a116.dmp
NCP> show node x5a116 characteristics

Node Volatile Characteristics as of 13-JUL-1995 13:22:39
 
Remote node =   1.224 (X5A116)

Service circuit          = SVA-0

Hardware address         = 08-00-87-05-A1-16

Load file                = [MOM$LOAD]:XPCS00S.SYS
Dump file                = [MOM$LOAD]:X5A116.DMP


NCP>  exit

The procedure requires additional information for configuring a Network 9000 401/402 module.  Please reference the example given below for configuring it to load over link W1 from a VMS host.  You must add the ethernet address of link W1 to the NCP database on the host.  You must also configure the W1 ethernet address and the base ethernet address in the XYP_MANAGER database.  (Refer to Chapter 4 of the Software Installation Guide for VMS Kits for additional information.)

NCP>define node 1.226 name xa9b83
NCP>define node 1.226 service circuit sva-0
NCP>define node 1.226 hardware address 08-00-87-0a-9b-83 (base ethernet address)
NCP>define node 1.226 load file [mom$load]:xprr2.sys
NCP>define node 1.226 dump file[mom$load]: xa9b83.dmp

NCP>define node 1.227 name 1a9b83
NCP>define node 1.227 service circuit sva-0
NCP>define node 1.227 hardware address 08-00-87-2a-9b-83 (W1 ethernet address)
NCP>define node 1.227 load file [mom$load]:xprr2.sys
NCP>define node 1.227 dump file [mom$load]:xa9b83.dmp
NCP>set node 1.226 all
NCP>set node 1.227 all
NCP>show node xa9b83 char

Node Volatile Characteristics as of 21-JUL-1995 09:29:14
 
Remote node =   1.226 (XA9B83)
 
Service circuit          = SVA-0
Hardware address         = 08-00-87-0A-9B-83
Load file                = [MOM$LOAD]:XPRR2.SYS
Dump file                = [MOM$LOAD]:XA9B83.DMP

 
NCP>sho node 1a9b83 char
 
Node Volatile Characteristics as of 21-JUL-1995 09:29:33
 
Remote node =   1.227 (1A9B83)
 
Service circuit          = SVA-0
Hardware address         = 08-00-87-1A-9B-83
Load file                = [MOM$LOAD]:XPRR2.SYS
Dump file                = [MOM$LOAD]:XA9B83.DMP

NCP>exit
$ @sys$manager:xyp_manager restart  (this adds parameter file entries to the database)

21-JUL-95 9:30:5
%XYP-I-STOPPED, Parameter Server shut down complete
%RUN-S-PROC_ID, identification of created process is 0000C317

The information in this document was extracted from the Xyplex documentation listed below.  Please refer to these documents for additional information on the update/loading process.

Applicable Xyplex Software Release Notes (available on Cdrom software update kit)
Software Kit Information Document (available on Cdrom software update kit)
Software Installation Guide for Xyplex Loader Kits   #420-0392C
Software Installation Guide for VMS kits   #420-0391A
Getting Started with Network 9000 Models 401 and 402 Processor Modules
