Unix-Projects-3b2/3b2-install-notes.txt

01-10-2024 Kenunix 

Installing AT&T 3b2 emulators, open-simh and the 3b2 package.

Do these steps once.

Get all the required packages:

Download the following from:  https://yeolpishack.net/repos/KenUnix/Unix-Projects-3b2

1) Download 3b2-install-notes.txt
   https://yeolpishack.net/repos/KenUnix/Unix-Projects-3b2/raw/branch/master/3b2-install-notes.txt
   After text appears click Ctrl-s to save
   Save it to your Documents directory
   After download finishes click the browser <-- button
   
2) open-simh-012024.tar.gz
    https://yeolpishack.net/repos/KenUnix/Unix-Projects-3b2/raw/branch/master/open-simh-012024.tar.gz

3) System-V-r3-3b2400-64bit.tar
   https://yeolpishack.net/repos/KenUnix/Unix-Projects-3b2/raw/branch/master/System-V-r3-3b2400-64bit.tar

4) If you plan on loading 3b2-700 also download
   https://yeolpishack.net/repos/KenUnix/Unix-Projects-3b2/raw/branch/master/System-V-r3-3b2700-64bit.tar
     
5) putty.defs
   https://yeolpishack.net/repos/KenUnix/Unix-Projects-3b2/raw/branch/master/putty.defs
   After text appears click Ctrl-s to save
   Save it to your home directory
   After download finishes click the browser <-- button

Available PDF and help documents:

From:  https://yeolpishack.net/repos/KenUnix/Unix-Projects-3b2

UNIX_System_V_Release_3_Users_and_System_Administrators_Reference_Manual.pdf
System_V_Release_3_Owner-Operator_Manual.pdf
System-V-3b2-Editing-Utilities.pdf
System-V-3b2-Help-Subsystem.pdf
System-V-3b2-User-Environment.pdf
System-V-3b2-Terminal-Information.pdf
System-V-3b2-User-Environment.pdf
System-V-3b2-Utilities.pdf
AT&T 3B2 SCSI R3 Release Notes.pdf
3b2 UNIX Admin reference.pdf
3b2 Admin Utilities Guide
3b2 User Guide.pdf
3b2 User Reference Manual
3b2-FAQ0019.txt
3b2-FAQ0020.txt
3b2-Tape-Drives.doc

Download these into your Documents directory.

Install any required packages:

Type in: sudo apt-get install gcc make ed sed

TIP: If using Arch Linux type: sudo pacman -S gcc make ed sed

If it reports you already have the latest that is OK.

Setup downloaded packages:

Open a terminal window.

Type in: tar -xvf System-V-r3-3b2400-64bit.tar

If you also downloaded 3b2-700
   Type: tar -xvf System-V-r3-3b2700-64bit.tar

Type in: gunzip open-simh-012024.tar.gz     To be updated

Type in: tar -xf open-simh-012024.tar

Type in: cd open-simh-simh-c077c22

Build the runtime modules:

Type in: make 3b2

If this is a 32 bit machine instead type: make WARNINGS=ALLOWED 3b2
   This will generate warning messages. You can ignore these.
  
Type in: cp BIN/3b2-400 ~/System-V-r3-3b2400-runtime/.

If you downloaded 3b2-700 do the following:
   make 3b2-700
   If this is a 32bit machine type in: make 3b2-700 WARNINGS=ALLOWED
   This will generate warning messages. You can ignore these.
   cp BIN/3b2-700 ~/System-V-r3-3b2700-runtime/.

Setup is complete. Congratulations.

Running Unix. These are the only steps required to run next time.

Open a terminal window using a terminal emulator like LX-terminal or Mate-terminal.

When the $ prompt appears continue.

Type in: cd ~/System-V-r3-3b2400-runtime
   or  : cd ~/System-V-r3-3b2700-runtime   if installed
   
TIP: If running on a non GUI system adjust screen size to 80x24 so vi works.
     If on a non GUI system with vi stick with - to backup one line, Enter to go to the
     next line, space bar to move into the line, a to append, dd to delete, i to insert,
     r to replace 1 character under cursor, R to overwrite from cursor forward, x to erase
     one character and :w to write the file and :q! to quit without saving and Esc to exit
     intsert or append mode.
     
TIP: If running Arch Linux expect "egrep warning messages" at startup. These can be ignored.

To Start Unix type in: ./unix

Unix will start automatically setting Unix date/time and logging you in as root.

Note that startup time may be as long as 5 minutes. Observe on screen messages.

Follow on screen directions.

Good luck.

If you plan on using putty do the following:
 
If putty is not installed type: sudo apt-get install putty
TIP: If running Arch Linux type: sudo pacman -S putty
   mkdir ~/.putty
   mkdir ~/.putty/sessions
   cp putty.defs ~/.putty/sessions/telnet2323

If putty is aleady installed type : cp putty.defs ~/.putty/session/telnet2323

To use putty type: putty and select the telnet2323 entry and click open.
   You can login as guest with no password.
   To exit right click on the title bar and click close.


Tested under:
	32bit Ubuntu 18.04 LXDE Workstation
	32bit Ubuntu 18.04 Server
	64bit Arch 202312 GNOME
	64bit Debian 11.5
	64bit Devuan 5.0.1 XFCE
	64bit PCLinuxOS 2023 XFCE ID_LIKE="mandriva"
	64bit Ubuntu 22.04 GNOME