MULTICS TO UNIX MIGRATION PACKAGE INSTALLATION INSTRUCTIONS RELEASE 2.0 PREPARED BY: ACTC TECHNOLOGIES INC. Copyright, (C) BULL HN Information Systems Inc., 1990 MUM2.0 1 12/19/90 MSIB2.0 TRADEMARK ACKNOWLEDGMENT UNIX is a registered trademark of AT&T Bell Laboratories. MUM2.0 2 12/19/90 MSIB2.0 SECTION 1 INTRODUCTION This document describes Release 2.0 of the Multics to UNIX Migration Package (MUM2.0). MUM2.0 is intended for sites migrating from a Multics system to a DPX/2 system. (For the purposes of this document, the term UNIX refers to the DPX/2.) The components of the MUM2.0 package reside on the Multics and UNIX systems. Detailed instructions for first-time installation of the package on the two systems constitute the major portion of this document. No attempt is made to document features of MUM2.0 other than those directly required for its installation. _S_I_T_E _S_U_P_P_O_R_T We would appreciate that sites, as they complete installation of MUM2.0 enter a transaction in the install_instructions (ii) forum meeting on System-M. This forum allows you to communicate any problems encountered in the installation procedure, and lets other sites see the amount of exposure the release is receiving. FORUM PATHNAME SHORT NAME --------------------------------------------- ---------- >udd>ssa>sa_meeting>install_instructions ii Introduction 1-1 12/19/90 MSIB2.0 We encourage sites to report problems encountered while installing this release in the "ii" forum. Problems of a critical nature to a customer site (for a definition of critical, type: help tr.priorities) can be reported directly to ACTC Technologies Inc. by Multics mail or phone. NAME USER ID PHONE Doug Howe DGHowe.Multics (403) 295-5932 Problems with package software, not related to installation, should be reported using the TR system on System-M. Introduction 1-2 12/19/90 MSIB2.0 SECTION 2 DESCRIPTION OF PACKAGE _C_O_N_T_E_N_T_S _O_F _M_U_M_2_._0 _P_A_C_K_A_G_E MUM2.0 includes this document, a UNIX streamer tape, a Multics magnetic tape, 2 hardcopy dump maps, and a Migration Software Release Bulletin. To install the complete package, sites should refer to sections 3 and 4. The instructions in each of these sections guide a site through the installation of the package on Multics and the DPX/2. This is a total Migration Package release. It contains a complete set of all modules contained in the Migration Package for Multics and the DPX/2. Sites should refer to the supplied Multics hierarchy dump map and the UNIX cpio dump map to validate the reload operations. _T_a_p_e__N_a_m_e_s _D_e_s_c_r_i_p_t_i_o_n 2.0MUM-Multics A complete dump of the >ldd>migration hierarchy on Multics. Includes all source, object, include files, info files, online migration manuals and other supporting documentation for the Multics end. 2.0MUM-UNIX A complete dump of the migration hierarchy on UNIX. Includes all source, object, include files and info files for the UNIX end. Package Description 2-1 12/19/90 MSIB2.0 The accompanying hardcopy listings are: _L_i_s_t_i_n_g _D_e_s_c_r_i_p_t_i_o_n 2.0MUM-MULTICS.DUMP.MAP Contents of the 2.0MUM-Multics tape MANIFEST Contents of the 2.0MUM-UNIX tape (cpio file). Package Description 2-2 12/19/90 MSIB2.0 SECTION 3 INSTRUCTIONS FOR INSTALLING THE MULTICS COMPONENTS This section details the steps for installing the Multics components of the Multics to UNIX Migration Package on Multics. If problems are encountered in any of the steps listed below, return to the last step known to be successful and retry the Steps. Pay particular attention to procedure. This entire procedure was verified on the Multics System (MR12.4) at ACTC Technologies Inc., but some hardware/software differences may exist at a particular site. For the given procedure, you will need to use the initializer terminal (or bootload console). The directory ">ldd>migration" contains all of the Multics components of the Migration Package. If such a directory exists on your system, you should rename it before installing MUM2.0. After loading, there will be an online information file "migration.gi.info" in >ldd>migration>doc>info that introduces the package to the user. Site personnel may wish to reference this file when announcing the package. If you place the migration package in another hierarchy, "migration.gi.info" and "migration.g.i" will have to be modified to reflect the new location of the Migration Software. User input is preceded by an exclamation mark (!). Note to Beta Sites: The 'appe' command has been removed from the Migration Package. 'appe' is no longer supported nor is it to be distributed and should be removed from your system. Instructions - Installing 3-1 12/19/90 MSIB2.0 _S_T_E_P _1_: _L_O_G_I_N _T_H_E _R_E_T_R_I_E_V_E_R _S_Y_S_D_A_E_M_O_N At the initializer terminal, type: !login Retriever.SysDaemon For example: login Retriever.SysDaemon rt where "rt" is your site's label for the daemon that controls the hierarchy retrievals. The system will respond with: as LOGIN Retriever.SysDaemon dmn rt (create) rt r 1248 4.789 33.65 456 rt ->rt _S_T_E_P _2_: _L_O_A_D _T_H_E _T_A_P_E To load the tape, type: !r rt backup_load -nosetlvid -noquota The system will respond with: rt Input tape label: Type: !r rt 2.0MUM The system will respond with: RCP: Mount Reel 2.0MUM without ring on tapa_01 for Retriever.SysDaemon.z Mount the tape on the specified drive. The tape will spin, and the system will ask: rt Are there any more tapes to be reloaded? Type: !r rt no _S_T_E_P _3_: _L_O_G_O_U_T _T_H_E _R_E_T_R_I_E_V_E_R _S_Y_S_D_A_E_M_O_N Logout the daemon by typing: !r rt logout The Multics components of the Multics to UNIX Migration Package are now installed on your Multics system. Proceed to Section 4 to install the UNIX components of the Migration Package on UNIX. Instructions - Installing 3-2 12/19/90 MSIB2.0 SECTION 4 INSTRUCTIONS FOR INSTALLING THE UNIX COMPONENTS This section details the steps for installing the UNIX components of the Multics to UNIX Migration Package on the DPX/2. If problems are encountered in any of the Steps listed below, return to the last step known to be successful and retry the Steps. Pay particular attention to procedure. . This package, including the source hierarchy, occupies approximately seventy megabytes (70Mb) of storage. The source hierarchy itself is approximately fifty-five megabytes (55Mb) in size and is not needed for successful installation. Installation of this package will add approximately twenty-five megabytes (25Mb) to /usr. Please configure your system appropriately. After loading, there will be an online information file "migration.g.i" in /usr/local/info that introduces the package to the user. Site personnel may wish to reference this file when announcing the package. If you place the migration package in another hierarchy, "migration.gi.info" and "migration.g.i" will have to be modified to reflect the new location of the Migration Software. User input is preceded by an exclamation mark (!). Instructions - Installing 4-1 12/19/90 MSIB2.0 _S_T_E_P _1_: _M_I_G_R_A_T_I_O_N _D_I_R_E_C_T_O_R_I_E_S Set up the required directories on your system: Switch user to root: !su root Create a directory called multics in a convenient place with the following command: Create Directory and set access: !mkdir multics !chown bin multics !chgrp bin multics !chmod 755 multics Then change to the multics directory: !cd multics Ensure the following directories exist. /usr/local /usr/local/info /usr/include/multics Create them if they are not present and set access: !mkdir /usr/local !mkdir /usr/local/info !mkdir /usr/include/multics !chown bin /usr/local !chown bin /usr/local/info !chown bin /usr/include/multics !chgrp bin /usr/local !chgrp bin /usr/local/info !chgrp bin /usr/include/multics !chmod 755 /usr/local !chmod 755 /usr/local/info !chmod 755 /usr/include/multics Instructions - Installing 4-2 12/19/90 MSIB2.0 _S_T_E_P _2_: _I_N_S_E_R_T _T_A_P_E Insert the tape 2.0MUM-UNIX into the tape drive. If you do not want to load the source skip to step 4. _S_T_E_P _3_: _L_O_A_D _T_A_P_E _(_S_O_U_R_C_E _I_N_C_L_U_D_E_D_) Run these commands while in the ./multics directory: !cpio -ivcudBI /dev/tape !./install Set access to the multics hierarchy, from the multics directory: !find . -depth -print -exec chown bin {} \; !find . -depth -print -exec chgrp bin {} \; !find . -depth -print -exec chmod 755 {} \; The installation is complete. Please note that the sources are quite large. You should think twice about leaving them online. Instructions - Installing 4-3 12/19/90 MSIB2.0 _S_T_E_P _4_: _L_O_A_D _T_A_P_E _(_S_O_U_R_C_E _E_X_C_L_U_D_E_D_) Run these commands while in the ./multics directory: !cpio -ivcudB "[lbic]*"