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

01-14-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.txt

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 Bodhi 5.1.0 Fails
	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 Linux Lite 6.4 XFCE
	64bit LinuxMint LMDE-6 12.2 XFCE (sudo apt install build-essential) (bind error 13)
	64bit PCLinuxOS 2023 XFCE  (ID_LIKE="mandriva")
	64bit Ubuntu 22.04 GNOME