Child pages
  • State Software Installation Procedure

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The OECN State Software is distributed as a series of backup savesets. Please read the Acquiring the Release page for specific details on how to download the backup savesets.

The files included in the kit consist of a number of required savesets and optional package savesets. The required savesets must be available at the time that OECN_INSTALL is executed. You cannot invoke OECN_INSTALL to install an individual package unless the required savesets are also available.

...

To begin the installation process, enter the following:

Code Block

$ @OECN$UTL:OECN_INSTALL [device] [OPTIONS option]

...

The first time you receive a distribution using the installation procedure, you will have to perform several steps manually. This is necessary to load the OECN_INSTALL.COM procedure onto your system. After you have done this once, it should not be necessary for future installations. After mounting the tape enter: (replace the device and directory names with ones appropriate for your system)

Code Block

$ DEFINE OECN$UTL DUA0:[ODE.UTL] (If not previously defined.) 
$ ALLOCATE MFA0:
$ MOUNT/FOREIGN MFA0:
$ BACKUP/NEW_VERSION MFA0:UTIL.BCK OECN$UTL:
$ DISMOUNT/NOUNLOAD MFA0:
$ @OECN$UTL:OECN_INSTALL

...

An option is provided to perform a special function and expedite the installation process. The option must be specified on the command line when OECN_INSTALL is invoked as follows:

Code Block

$ @OECN$UTL:OECN_INSTALL \{device\} OPTIONS \{option\}

...

To specify the "Autoanswer" option, you would enter:

Code Block

$ @OECN$UTL:OECN_INSTALL MFA0: OPTIONS A

...

For any given site the responses to prompts during an installation are generally repetitive from one release to the next. The autoanswer option allows the answers to the installation prompts to be saved in a special file and used to install future releases. To use this option include the letter "A" in the options list, as follows:

Code Block

$ @OECN$UTL:OECN_INSTALL MFA0: OPTIONS A

...

The following section contains a sample run of a typical installation. Comments enclosed in parentheses () are part of this document, and therefore will not be seen during an actual installation. All input by the operator is in SMALL UPPERCASE.

Code Block

$ @OECN$UTL:OECN_INSTALL
Code Block
 
 

$ @OECN$UTL:OECN_INSTALL 
 
 Copyright (C) 1987 Ohio Department of Education 
 Division of Computer Services and Statistical Reports 
 
 
  -- State Software Installation Procedure -- 
 
  Enter '?' for help at any time. 
 
 
 
Deleting Global symbols . . . 
 
     Note: This procedure will completely supersede the packages that it 
installs.  Old versions of files will not be retained. 
 
 
Enter device where distribution media is located: DKA100:[OECN_SSDT.RELEASE] 
 
Enter top-level directory to place distribution: <DKA100:[ODE]> 
 
Enter OECN utility directory: <DKA100:[ODE.UTL.DIST]> 
 
Installing UTIL.BCK . . . 
 
 
Do you want to print a copy of the release notes? <Y> n 
The release notes will be available after the installation 
in DKA100:[ODE.UTL.DIST] 
 
Do you wish to proceed with the installation? <Y> 
 
 Some of the packages on this distribution may need to be LINK'ed 
 before they can be executed. 
 
Options: 
   1)  Link all packages (LINKALL via SYS$BATCH) 
   2)  Don't Link. 
 
Enter link/compile option<1> 1 
 
Do you want the programs LINK'ed with /TRACE? <N> 
 
Enter username to send error messages to: <SMITH> 
 
Enter time to start compiles/links <NOW> 
 
    - Installing mandatory backup sets - 
 
Purging destination directory . . . 
Decompressing DKA100:[ODE.TAPE]COBLIB.ZIP; using UNZIP 
Decompressing DKA100:[ODE.TAPE]COBLIB_AXP.ZIP; using UNZIP 
Restoring COBLIB_AXP to [COBLIB] 
Restoring COBLIB to [COBLIB] 
 
OECN Sharable Image Installation: 
--------------------------------- 
%INSTALL-W-NOPREV, no previous entry exists - new entry created for DEV:[SYS0.SYSCOMMON.][SYSLIB]OECNSHR.EXE;1 
 
%OECNINS-I-SHRINST, OECN sharable image installed. 
%OECNINS-I-RTLINST, Inserted CDA$ACCESS into OECNSHR 
%OECNINS-I-INSTV, Installing translated VAX sharable images 
Installation complete for: OECN COBOL libraries 
 
Package   Description           Destination 
-------   -----------           ----------- 
CSSR10    CSSR Version 1.0      [CSSR.V1P0.DIST]
DOCS      Software Docs         [DOCUMENT.DIST]    
EMIS16    EMIS Version 1.6      [EMIS.V1P6.DIST]    
OECN10    OECN Version 1.0      [OECN.V1P0.DIST]     
SAAS20    SAAS Version 2.0      [SAAS.V2P0.DIST]     
SECIMS10  SECIMS Version 1.0    [SECIMS.V1P0.DIST]         
TRAINING  Training Materials    [TRAINING.DIST...]            
USAS60    USAS Version 6.0      [USAS.V6P0.DIST]              
USPS40    USPS Version 4.0      [USPS.V4P0.DIST]              
 
 
Which package(s) do you want to install: <*> oecn10,usas60 
 
Purging destination directory . . . 
Decompressing DKA100:[ODE.TAPE]OECN10.ZIP; using UNZIP 
Decompressing DKA100:[ODE.TAPE]OECN10_AXP.ZIP; using UNZIP 
Restoring OECN10_AXP to [OECN.V1P0.DIST] 
Restoring OECN10 to [OECN.V1P0.DIST] 
 
OECN Version 1.0 Installation: 
------------------------------ 
 
Do you want customized security ids installed from OECN$CUSTOM: <Y> n 
 
Identiiers will not be installed. 
 
Installation complete for: OECN Version 1.0 
 
Purging destination directory . . . 
Decompressing DKA100:[ODE.TAPE]USAS60.ZIP; using UNZIP 
Decompressing DKA100:[ODE.TAPE]USAS60_AXP.ZIP; using UNZIP 
Restoring USAS60_AXP to [USAS.V6P0.DIST] 
Restoring USAS60 to [USAS.V6P0.DIST] 
 
USAS Version 6.0 Installation: 
------------------------------ 
 
Which USAS purchase order form layout does your site use? 
 
    1) NWOCA supported layout 
    2) State supported layout 
 
Enter USAS PO layout selection: <1> 
Installation complete for: USAS Version 6.0 
 
Package   Description           Destination 
-------   -----------           ----------- 
CSSR10    CSSR Version 1.0      [CSSR.V1P0.DIST]              
DOCS      Software Docs         [DOCUMENT.DIST]               
EMIS16    EMIS Version 1.6      [EMIS.V1P6.DIST]              
OECN10    OECN Version 1.0      [OECN.V1P0.DIST]              
SAAS20    SAAS Version 2.0      [SAAS.V2P0.DIST]              
SECIMS10  SECIMS Version 1.0    [SECIMS.V1P0.DIST]            
TRAINING  Training Materials    [TRAINING.DIST...]            
USAS60    USAS Version 6.0      [USAS.V6P0.DIST]              
USPS40    USPS Version 4.0      [USPS.V4P0.DIST]              
 
 
Which package(s) do you want to install: <*> 
 
Job COMP_PACKAGES (queue SYS$BATCH, entry 447) started on SYS$BATCH 
 
Please add the following line to your SYSTARTUP file: 
 
@DKA100:[ODE.UTL.DIST]OECN_STARTUP.COM 
 
%OECNINS-S-NORMAL, Installation procedure completed successfully 
 
 
 (End of Sample Run) 
 

...

INSTALL_PACKAGE accepts several parameters that determine the function it should perform and package to install. The syntax for invoking INSTALL_PACKAGE is:

Code Block
         $ @OECN$UTL:INSTALL_PACKAGE \{function\} \{dist_dir\} [options] 

...

The following examples show several uses of INSTALL_PACKAGE.

Code Block

$ @OECN$UTL:INSTALL_PACKAGE HELP 

This example causes the procedure to display the help messages for INSTALL_PACKAGE. You may may also request help on specific functions or topics. For example:

Code Block

$ @OECN$UTL:INSTALL_PACKAGE HELP FULL 
$ @OECN$UTL:INSTALL_PACKAGE HELP RESTRICTIONS 

The first example will display help for the FULL function. The second example displays help for the "RESTRICTIONS" help topic. The "RESTRICTIONS" topic displays the latest information about any restrictions on using the INSTALL_PACKAGE procedure.

Code Block

$ @OECN$UTL:INSTALL_PACKAGE FULL OECN$ROOT:[SAAS.V2P0.DIST] 

This command causes INSTALL_PACKAGE to do full installation for the SAAS Version 2.0 package, including CDD/DTR definitions.

Code Block

$ @OECN$UTL:INSTALL_PACKAGE EXECUTION OECN$ROOT:[USPS.V4P0.DIST] PURGE 

This command installs everything needed to run USPS Version 4.0. It would not install CDD definitions. Also, because the "PURGE" option was specified, old versions of files replaced by the installation are purged.

Code Block

$ @OECN$UTL:INSTALL_PACKAGE CHECK OECN$ROOT:[USPS.V4P0.DIST] 

...

By default, BUILD_ALIAS will build the alias file based on the current value of OECN$MENU$FILES, OECN$MENU and OECN$ALIAS. If you only have one menu system on your system and the logicals are defined in your current process, you can rebuild the alias file using the following command:

Code Block

$ @OECN$:BUILD_ALIAS 

The procedure will also accept parameters that allow you to specify the location and name of a menu system if different from the default. The following syntax is used:

Code Block

$ @OECN$:BUILD_ALIAS [location] [main_menu] [alias] 

...

For example, assume you have a menu system located in USERA:[MENUFILES] and the main menu is called MY_MAIN_MENU.DAT and the alias file is called MY_ALIAS.DAT. You could use the following command to build a new alias file:

Code Block


$ @OECN$:BUILD_ALIAS USERA:[MENUFILES] MY_MAIN_MENU MY_ALIAS