diff --git a/docs/handbook/getting-started.md b/docs/handbook/getting-started.md index 3a1a8239..d9496530 100644 --- a/docs/handbook/getting-started.md +++ b/docs/handbook/getting-started.md @@ -562,13 +562,13 @@ As it runs, you will be prompted with a few questions. Secure boot (UEFI boot path validation) must be disabled (if it is enabled by default) because UEFI secure boot is currently not yet supported. - For further information, consult the manufacturers documentation for your computer hardware. + For further information, consult the manufacturer's documentation for your computer hardware. ### Booting the OpenIndiana installer on virtual hardware The most efficient way to boot a virtual machine is to boot directly from the DVD ISO file. -Alternately, you may use host to guest DVD/USB passthrough to boot from physical media. +Alternately, you may use host-to-guest DVD/USB passthrough to boot from physical media. See the notes below for optimizing OpenIndiana for several popular hypervisors. | Hypervisor | Configuration Notes @@ -1413,11 +1413,49 @@ Use the following steps to change the root password:
!!! note The image packaging system is delivered as part of the OpenIndiana userland. - As such, the pkg related man pages are not available on the illumos.org website. + As such, the pkg-related man pages are not available on the illumos.org website. These pages are only available by running the man page viewer locally on your system.
-### Introduction +### Quick Start to IPS + +As a desktop user, you will likely want to enable the `Software Installation` profile for +your user; you can use `sudo` instead of `pfexec` if you are just getting started with +OpenIndiana and are not yet familiar with RBAC (role-based authentication), being sure +to replace `username` with your actual username: + + +``` +sudo usermod -P "Software Installation" username +``` + +Now you can use `pfexec` to execute `pkg install` + + +For instance, you may want to search for the `emacs` editor by running `pkg search -p emacs` + +``` +$ pkg search -p emacs +PACKAGE PUBLISHER +pkg:/developer/exuberant-ctags@5.8-2020.0.1.1 openindiana.org +pkg:/editor/gnu-emacs/gnu-emacs-gtk@29.1-2023.0.0.1 openindiana.org +pkg:/editor/gnu-emacs/gnu-emacs-lisp@29.1-2023.0.0.1 openindiana.org +pkg:/editor/gnu-emacs/gnu-emacs-no-x11@29.1-2023.0.0.1 openindiana.org +pkg:/editor/gnu-emacs/gnu-emacs-x11@29.1-2023.0.0.1 openindiana.org +pkg:/editor/gnu-emacs@29.1-2023.0.0.1 openindiana.org + +``` + + +Then you can install the one that you like by copying and pasting the FMRI (see more details on that later) into a `pkg install` command: + + +``` +pfexec pkg install pkg:/editor/gnu-emacs/gnu-emacs-no-x11@29.1-2023.0.0.1 +``` + + +### IPS Overview diff --git a/docs/handbook/systems-administration.md b/docs/handbook/systems-administration.md index 48cf8562..546f8804 100644 --- a/docs/handbook/systems-administration.md +++ b/docs/handbook/systems-administration.md @@ -751,6 +751,26 @@ onto the system before changing the run-level. process is not interrupted by system prompts requiring user-interactive intervention. + +## Updating All Packages (Upgrading Your System) + +OpenIndiana Hipster is a rolling release +distribution, so to upgrade your system, you simply run `pkg update` +all packages will be updated to the latest revision: + +```sh +pfexec pkg update +``` + +(Note: for `pfexec` to succeed you'll need to have the `Software Installation` profile [enabled for your user account](../getting-started/#quick-start-to-ips).) + + +New installation images are beneficial for those +with newer hardware that illumos may have added +support for, but the above command should suffice +for existing installations. + + ## Service Management Facility Services are an extension to processes.