# AS400 Terminal Install & Setup Instructions

## Install MacOS

For the iMac model, use the following OSX releases:

> **A1195 (White Bezel)** - OSX 10.6 Snow Leopard (*10.4 Tiger* to *10.7 Lion*)
>
> **A1208 (White Bezel)** - OSX 10.6 Snow Leopard (*10.4 Tiger* to *10.7 Lion*)
>
> **A1224 (Silver Bezel)** - OSX 10.10 Yosemite (*10.5 Leopard* to *10.11 El Capitan*)
>
> **A1418 (Silverback)** - OSX 10.14 Mojave (*10.8 Mountain Lion* to *10.15 Catalina*)

- During install, split into 2 partitions. Format partition 1 as AFS or HFS. Format partition 2 as Fat32 (Apple refers to Fat32 as just FAT).
- Install the *next to most recent* version of OSX instead of the most recent onto partition 1.
- Shut down, then hold option after pressing the power button to choose the startup drive to select the Lubuntu install USB drive.

## Install Lubuntu

- Boot to the Lubuntu USB drive and choose Try Lubuntu. 
- Once loaded, click the start menu -> **System Tools** -> **KDE Partition Manager**.
- In the partition manager, select the Fat32 partition and click delete. Then click apply and close the partition manager.
- Double click the install Lubuntu icon from the desktop.
- The user name should be terminal (lowercase). For computer name, I used "terminal-MODELMMYY" (ex. terminal-A11950924)
- Make sure to select the option to not require login when creating the user.

## Setting up Lubuntu with the iAccess software

### Copy files

- Create a new folder on the desktop named temp (all lowercase).
- Copy the contents of `\\SOHBACKUP\Programs\2024-Terminals` to the new folder you created.
    - _Alternately you can copy the whole "Terminals" folder to the desktop, right click the folder and rename it to temp._

### Run setup script

- Open the terminal
    - For Lubuntu 18, it is LXTerminal: **Start** -> **System Tools** -> **LXTerminal**
    - For Lubuntu 24, it is QTerminal: **Start** -> **System Tools** -> **QTerminal**
- At the terminal prompt, type the following:
> `cd ~/Desktop/temp`
>
> `sudo chmod +x install*.sh`
>
> For 32-Bit systems (A1195 & A1208): `sudo ./install32.sh`
>
> For 64-Bit systems (A1224 & A1418): `sudo ./install64.sh`

This installs prerequisites*, JAVA (1.8.0_381), ODBC (2.3.12), IBM iAccess (v1r9), and other configuration files. It should ask you to answer a few questions once it starts installing the IBM software. Answer them all Yes.
	
#### Prerequisites
- install
- dialog
- make
- automake
- autoconf
- libtool
- glibc*
- alien
- odbcinst
- unixodbc
- libmotif-common
- numlockx

## Post Install

### Accept the i Access EULA

- Open IBM iAccess Client Solutions: **Start** -> **Internet** -> **IBM i Access Client Solutions**
    - You can drag the icon to the desktop for future use, if desired.

- In the window that first loads, scroll to the bottom of the EULA window and click accept.

- Close the iAccess window.

### Hide the taskbar

- Right click the taskbar and click "Panel Settings"
- Click on the Advanced tab
- Check the box that says "Minimize panel when not in use"
- Click Close

### Disable Power Management

- Open the Power Management console
    - Lubuntu 18: **Start** -> **Preferences** -> **Power Manager**
        - Security Tab
        - Change Slide all slider to the left so it says never
        - Click on the Security tab
	    - Click the box next to "Automatically lock the session" and change it to Never
	    - Click Close at the bottom
    - Lubuntu 24: **Start** -> **Preferences** -> **LXQt Settings** -> **Power Management**
        - Click the Idle section
        - Uncheck the "Enable Idleness Watcher" option at the top.
        - Optionally, disable the screensaver at **Start** -> **Preferences** -> **XScreenSaver Settings**