           "How To" about installation process of OS/4 kernel
                             ver. 0.5


FILES:

    DOCS\*.*                - some docs
    OS2\BOOT\*.*            - drivers for OS/4 kernel
    TEST\                   - some tests and samples
    HowTo                   - the file you are reading now
    OS2LDR                  - the new loader
    os2ldr.ini.template     - new loader configuration file
    os4krnl                 - the OS/4 kernel (dbg)
    os4krnl.sym               with its symbols file
    os4krnlr                - the OS/4 kernel (retail)
    os4logo                 - the OS/4 logo
    os4dump                 - the OS/4 dump facility

INSTALLATION:

    Assume that the boot drive is C:\

    1. Rename original loader:
        C:\OS2LDR -> C:\OS2LDR.ORY

    2. Copy C:\CONFIG.SYS to C:\CONFIG.OS4
       (OS/4 kernel will use C:\CONFIG.OS4)

    3. Copy to C:\ the following files:
        OS2LDR
        os2ldr.ini.template (and rename to os2ldr.ini)
        os4krnl
        os4krnl.sym
        os4krnlr
        os4logo
        os4dump

    4. Copy all drivers from OS2\BOOT\ of the package to C:\OS2\BOOT\
       (Supplied drivers will not replace the original ones since they have
        different names)

    5. Modify C:\OS2LDR.INI file if you need. Supplied configuration file
       will boot your original OS/2 kernel by default and allow you to select
       booting the OS/4 kernel with CONFIG.OS4

    6. Edit CONFIG.OS4 according to instructions below

CHANGES TO CONFIG.OS4:

    1. REM the following lines out:
        PSD=ACPI.PSD                  (see note about ACPI.PSD usage below)
        BASEDEV=APM.ADD               (it is not compatible with OS/4)
        BASEDEV=TIMER0.SYS            (it is not used with OS/4)
        DEVICE=C:\OS2\BOOT\PmDD.SYS   (PmDDk.SYS will be used instead)
        VIRTUALADDRESSLIMIT=xxxx      (is set in C:\OS2LDR.INI)
        SET NSPR_OS2_NO_HIRES_TIMER=1 (OS/4 provides bugless DosTmrQueryTime)

    2. Add the following:
        PSD=OS4APIC.PSD /APIC  (for some systems PSD=OS4APIC.PSD)
        DEVICE=C:\OS2\BOOT\PmDDk.SYS

    3. Highly suggested but not obligatory set:
        MEMMAN=SWAP,NOPACK
        PROCESSES=128
        THREADS=511
        DLLBASING=OFF
        SET NOJIT=YES
        (PROCESSES= and THREADS=  have to be as little as possible but enough,
         check the real needs with
         Local System -> System Setup -> OS/2 Kernel -> Scheduler
         at same time settings 128/511 will be ok for almost everybody)

    4. Add explicit value for JFS cache size, for example:
        IFS=C:\OS2\BOOT\JFS.IFS /LW:5,20,4 /AUTOCHECK:* /CACHE:131072

    ***Note***

    OS/4 kernel sets VirtualAddressLimit (VAL) according to settings in os2ldr.ini
    Supplied os2ldr.ini.template contains setting for VAL as 3072 which is
    optimal for many cases. But if your application/system requires some other
    value of VAL just edit your OS2LDR.INI to set VAL to desirable value.

UNINSTALL:

    1. Restore original boot loader:
       C:\OS2LDR.ORY -> C:\OS2LDR

    2. Remove all files you have copied during installation.

ACPI.PSD COMPATIBILITY NOTE:

    The latest compatible ACPI.PSD is 3.23.01 but it needs a patch, please see:
    http://gus.biysk.ru/os4/Patches/AcpiPsdPatches.rar

REPORTING BUGS AND REQUESTING IMPROVEMENTS:

    https://www.os2world.com/
    irc://irc.nac.net/#os2russian
    irc://irc.freenode.net/#netlabs
    you may be requested to show the log:
      COPY KERNLOG$ my.log
      or using comport terminal

INFO:
    https://www.os2world.com/wiki/index.php/Phoenix_OS/4

DISCLAIMER:

    Standard for such cases  - NO WARRANTIES, NO RESPONSIBILITIES
