Contributor Topics

The goal of this page is to provide a 'TO DO' list of things which need to be documented.

The organization of the resources below are listed first according to the document title they pertain to, followed by individual topics found within that particular document title. For each document the published URL and internal site path to the document have been provided.

Potentially useful reference information

Below you will find a list of links, most of which are from the Internet Archive 'Wayback' machine. As such, when clicking on the links found within these resources, it may be necessary to remove the ;jsessionid=xxx from the end of the URL. Otherwise the wayback machine will report a not found error message.

About OpenIndiana

The 'About OpenIndiana' document is effectively a renamed and enhanced copy of the OpenIndiana FAQ found on OpenIndiana.org. Given FAQ's are so rarely composed of things people actually inquire about, having a document titled 'About OpenIndiana' made more sense for this documentation site.

Suggested topics:

Below are some resources which may be useful for further improving this document. Take some time to look them over for ideas and inspiration for writing new content:

Handbook - Getting Started

DOC TEAM NOTE:

DOC TEAM NOTE:

This document is likely to change significantly over the course of it's development.

  • Some topics may be moved to more relevant locations within other documents.
  • As the document grows and matures, it is likely to become necessary to break things up into smaller more manageable pieces.

The Getting Started document has been initially structured to cover the following topics:

  • Introduction
  • OpenIndiana software releases
  • System requirements
  • Exploring OpenIndiana
  • Preparation for installing OpenIndiana
  • Creating a bootable OpenIndiana DVD
  • Creating a bootable OpenIndiana USB flash drive
  • Booting OpenIndiana installer media
  • Installing OpenIndiana
  • Post installation steps
  • Troubleshooting installations
  • The Image Package System (IPS)
  • Managing boot environments
  • The X-Window system

Suggested topics:

Import first section of Wiki page: http://wiki.openindiana.org/oi/Using+OpenIndiana+-+Technical+FAQ

Have a look at the following resources for ideas and inspiration for writing new content:

Handbook - Common Tasks

DOC TEAM NOTE:

DOC TEAM NOTE:

This document is likely to change significantly over the course of it's development.

  • Some topics may be moved to more relevant locations within other documents.
  • As the document grows and matures, it is likely to become necessary to break things up into smaller more manageable pieces.

The Common Tasks document has been initially structured to cover the following topics:

  • Basic UNIX commands
  • Basic system administration
  • Desktop applications
  • Multimedia - Audio
  • Multimedia - Video
  • Printing
  • Graphics workstation
  • Desktop Publishing system, Etc.

Currently this section is largely desktop oriented. Perhaps some additional items such as system backups might fit better in this section. As previously mentioned, this is a living document and things will likely get shuffled around as the document matures.

Suggested topics:

CUPS Printing

The Common UNIX Printing System (CUPS) has been selected as the default print service, replacing the LP print service, in OpenSolaris 2010.03. CUPS support includes a web and graphical interface to manage your printing environment. A system that is running CUPS becomes a host that can accept print requests from client systems, process those requests, and then send them to the appropriate printer. To facilitate CUPS support, a new print-service command has been introduced that provides a mechanism for switching between CUPS print service and the LP print service, including 2 new SMF services.

Doc team Note: The guidance provided by the OSOL printing administration book is largely obsolete (but parts may still be valid) as CUPS replaced the old Solaris printing subsystem found in OpenSolaris 2009.06. However, OpenIndiana has 2 print subsystems (CUPS and LP). They are managed by the print-service command, which allows you to designate the active print subsystem. See the print-services (1M) man page for more information. In contrast, Oracle dropped lp completely in the Solaris 11.0 release.

Handbook - Systems Administration

DOC TEAM NOTE:

DOC TEAM NOTE:

This document is likely to change significantly over the course of it's development.

  • Some topics may be moved to more relevant locations within other documents.
  • As the document grows and matures, it is likely to become necessary to break things up into smaller more manageable pieces.

The systems administration document has been initially structured to cover the following topics:

  • Configuration and tuning
    • Configuring a UPS
    • Fault Management (FMA)
    • Service Management (SMF)
    • Systems logging and monitoring
  • Illumos boot process
  • Security
    • Role Based Access Control (RBAC)
  • Zones
  • Storage
    • Mounting file systems
    • NTFS support - 3rd party
    • Configuring OpenIndiana as an ISCSI Target Server - (COMSTAR)
    • System backups
    • ZFS
  • Virtualization
  • Localization
  • Dtrace
  • Configuring Networking
    • NWAM
  • Clustering

Suggested topics:

Have a look at the following resources for ideas and inspiration for writing new content:

Systems Admin Guides

SMF

WIFI/NDIS

Zones

ZFS

ABI support

Write about Virtualization

Handbook - Network Communications

DOC TEAM NOTE:

DOC TEAM NOTE:

This document is likely to change significantly over the course of it's development.

  • Some topics may be moved to more relevant locations within other documents.
  • As the document grows and matures, it is likely to become necessary to break things up into smaller more manageable pieces.

The network communications document has been initially structured to cover the following network related topics:

  • PPP
  • PPPoE
  • Email servers
  • WWW servers
  • Firewalls
  • Advanced networking
  • Crossbow
  • Using OpenIndiana as a NAS
    • CIFS
    • SAMBA
    • NFS
  • NIS
  • LDAP
  • DHCP
  • FTP
  • DNS
  • NTP
  • INETD

Suggested topics:

Have a look at the following resources for ideas and inspiration for writing new content:

Comstar

Crossbow

CIFS

NFS

IPFilter

Rsync

Installing OI onto an ISCSI exposed SCSI target

A good tutorial might be to write about installing OpenIndiana Hipster on an ISCSI target.

[14:50:02] <alp> does someone have some links on "installing OI on ISCSI" ?
[14:57:40] <tsoome> alp get to illumos wiki, open projects loader -> ideas, from there you get link for jeffpc iscsi experiment
[14:57:46] <tsoome> I did use it to play with ipxe+iscsi+loader

Also can look at Oracle docs for reference: https://docs.oracle.com/cd/E26502_01/html/E29008/iscsi-1.html

Handbook - Appendix

DOC TEAM NOTE:

DOC TEAM NOTE:

This document is likely to change significantly over the course of it's development.

  • Some topics may be moved to more relevant locations within other documents.
  • As the document grows and matures, it is likely to become necessary to break things up into smaller more manageable pieces.

The appendix document has been initially structured to cover the following topics:

  • Finding help and support
  • Developing with OpenIndiana
  • Software Development Testing

This document might also be a good place to put the following topics:

  • Basic UNIX commands
  • Contrast and comparison tables (e.g. Unix versus Linux, etc.)
  • Feature comparison tables

Suggested topics:

Write some comparison tables

OpenSolaris Redistributable Books

DOC TEAM NOTE:

DOC TEAM NOTE:

The OpenSolaris books are from the 2009.06 release of OpenSolaris. As OpenIndiana has diverged from it's OpenSolaris roots, the relevancy of this documentation has diminished. Some of the documentation was obsolete even when it was published.

The primary value of this documentation may be to use it as inspiration for writing new content for the handbook. The documentation is all PDL licensed so it may be copied verbatim without incurring any legal risks.

As for the future of these documents, the project has some choices:

  • Pull in any and all reverent content into the new handbook and then discard the books.
  • Write errata for the books, pointing out what has changed between OpenSolaris and OpenIndiana.
  • Use the books to write task specific tutorials.

Suggested topics: