Updates for Nexenta Server documentation porting

Bug #284363 reported by anilg
6
Affects Status Importance Assigned to Milestone
Nexenta Operating System
In Progress
Medium
anilg

Bug Description

The documentation is currently at http://www.nexenta.org/~anil/serverguide/C/ which is a derivative of the ubuntu-doc repository. Its intention is to make opensolaris and Nexenta specific changes to upstream.

This bug will be used to list changes as and when the server guide is updated.

Revision history for this message
anilg (anil-verve) wrote :

As an initial start.. I've manually replaced several occurrences of Ubuntu with Nexenta. The content is still ubuntu/linux specific.

Revision history for this message
Jerome Warnier (jwarnier) wrote :

URL above is a dead link.

Revision history for this message
anilg (anil-verve) wrote :

Hey,

I moved them to my user account.. find the latest at
http://www.nexenta.org/~anil/serverguide/C/

-Anil

Revision history for this message
anilg (anil-verve) wrote :

An update for those following this bug,

I've been changing the /etc/init.d calls for variosu packages to their SMF equivalent (svcadm enable/disable) and also adding this support to the packages themself.

The Backups section, virtualization and networking has been rewritten for opensolaris and ZFS.

The logos have been changed, and many links to ubuntu changed. If you have any comments on the current status, do add on to the discussion here

Revision history for this message
Jerome Warnier (jwarnier) wrote :

The Software RAID part needs a complete rewrite, and this could be a huge work.

Package management should say something about "apt-clone".

As root does have a password on NCP, sudo would probably better be forgotten at some places.

Configuration of APT should cover subject "/etc/apt/sources.list.d" in "Extra Repositories".

Last paragraph in "Network Configuration->Ethernet" is about /etc/network/interfaces (and manpage), which do not exist on NCP. Same thing about the whole "Bridging" sub-chapter.

I'm stopping here to let you rework this (or give comments).

Suggestion: could you make the documentation editable by other contributors? As-is, you would have to work a lot to keep up with (potential) contributions.

Revision history for this message
anilg (anil-verve) wrote :

Thanks for the inputs, Jerome. I'll add the apt-clone and networking changes. Sections like RAID and openldap are in need of review/rewrite. (the RAID part is much easier with ZFS :) )

The original sources are from the ubuntu-doc repository. I've made my changes, and uploaded them at
https://code.launchpad.net/~anil-verve/nexenta-base/serverdoc

You can pull them locally using
bzr branch https://code.launchpad.net/~anil-verve/nexenta-base/serverdoc

Our changes are concerned with the following files under serverguide/C/ directory
serverguide/C/backups.xml
serverguide/C/databases.xml
serverguide/C/dns.xml
serverguide/C/file-server.xml
serverguide/C/installation.xml
serverguide/C/introduction.xml
serverguide/C/mail.xml
serverguide/C/network-auth.xml
serverguide/C/network-config.xml
serverguide/C/package-management.xml
serverguide/C/remote-administration.xml
serverguide/C/security.xml
serverguide/C/serverguide.xml
serverguide/C/vcs.xml
serverguide/C/virtualization.xml
serverguide/C/web-servers.xml
serverguide/C/wikis.xml
serverguide/C/windows-networking.xml

The xml format is easy to parse and edit in a syntax highlighting editor (gedit/bluefish/geany .. I use bluefish)

To generate the html docs run 'make serverguide'
This will create the files under 'build' directory.

Revision history for this message
anilg (anil-verve) wrote :

Added devzones to virtualization section.

anilg (anil-verve)
description: updated
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Related blueprints

Remote bug watches

Bug watches keep track of this bug in other bug trackers.