softraid clarification in manpage

classic Classic list List threaded Threaded
7 messages Options
Reply | Threaded
Open this post in threaded view
|

softraid clarification in manpage

Amit Kulkarni-5
Hi,

I just configured a mirror using softraid, the manpage was extremely
helpful. I just copy pasted the relevant commands. To a complete
newbie, it was missing a few more lines. I just added those and
sending the diff. I hope a variation of this is accepted to make the
"how to create mirror using softraid" is complete. Googling brings a
lot of RAIDFrame etc, there is very little out there on a pure data
mirror.

Thanks,
amit


Index: softraid.4
===================================================================
RCS file: /cvs/src/share/man/man4/softraid.4,v
retrieving revision 1.27
diff softraid.4
147a148,159

> .Pp
> To use the freshly created mirror
> .Bd -literal -offset indent
> # mkdir /datamirror
> # mount /dev/sd0a /datamirror
> # chown normal_openbsd_user /datamirror
> .Ed
> .Pp
> Adding the following line to /etc/fstab will make it useful after every boot
> .Bd -literal -offset indent
> /dev/sd0a /datamirror ffs rw,softdep,nodev,nosuid 1 2
> .Pp

Reply | Threaded
Open this post in threaded view
|

Re: softraid clarification in manpage

Jason McIntyre-2
On Wed, Jan 26, 2011 at 04:24:07PM -0600, Amit Kulkarni wrote:

> Hi,
>
> I just configured a mirror using softraid, the manpage was extremely
> helpful. I just copy pasted the relevant commands. To a complete
> newbie, it was missing a few more lines. I just added those and
> sending the diff. I hope a variation of this is accepted to make the
> "how to create mirror using softraid" is complete. Googling brings a
> lot of RAIDFrame etc, there is very little out there on a pure data
> mirror.
>
> Thanks,
> amit
>
>
> Index: softraid.4
> ===================================================================
> RCS file: /cvs/src/share/man/man4/softraid.4,v
> retrieving revision 1.27
> diff softraid.4
> 147a148,159
> > .Pp
> > To use the freshly created mirror
> > .Bd -literal -offset indent
> > # mkdir /datamirror
> > # mount /dev/sd0a /datamirror
> > # chown normal_openbsd_user /datamirror
> > .Ed
> > .Pp
> > Adding the following line to /etc/fstab will make it useful after every boot
> > .Bd -literal -offset indent
> > /dev/sd0a /datamirror ffs rw,softdep,nodev,nosuid 1 2
> > .Pp

(as an aside, please send unified diffs (-u) in future)

there is a line near the end of EXAMPLES:

        The RAID volume is now ready to be used as a normal disk device.

for me, the instructions you've added come under the umbrella of
using the raid partition as a normal disk partition. so i'd argue
that it's outside the remit of this page.

maybe other developers think otherwise though.

jmc

Reply | Threaded
Open this post in threaded view
|

Re: softraid clarification in manpage

Nick Guenther
On Thu, Jan 27, 2011 at 9:39 AM, Jason McIntyre <[hidden email]> wrote:

> On Wed, Jan 26, 2011 at 04:24:07PM -0600, Amit Kulkarni wrote:
>> Hi,
>>
>> I just configured a mirror using softraid, the manpage was extremely
>> helpful. I just copy pasted the relevant commands. To a complete
>> newbie, it was missing a few more lines. I just added those and
>> sending the diff. I hope a variation of this is accepted to make the
>> "how to create mirror using softraid" is complete. Googling brings a
>> lot of RAIDFrame etc, there is very little out there on a pure data
>> mirror.
>>
>> Thanks,
>> amit
>>
>>
>> Index: softraid.4
>> ===================================================================
>> RCS file: /cvs/src/share/man/man4/softraid.4,v
>> retrieving revision 1.27
>> diff softraid.4
>> 147a148,159
>> > .Pp
>> > To use the freshly created mirror
>> > .Bd -literal -offset indent
>> > # mkdir /datamirror
>> > # mount /dev/sd0a /datamirror
>> > # chown normal_openbsd_user /datamirror
>> > .Ed
>> > .Pp
>> > Adding the following line to /etc/fstab will make it useful after every
boot

>> > .Bd -literal -offset indent
>> > /dev/sd0a /datamirror ffs rw,softdep,nodev,nosuid 1 2
>> > .Pp
>
> (as an aside, please send unified diffs (-u) in future)
>
> there is a line near the end of EXAMPLES:
>
>        The RAID volume is now ready to be used as a normal disk device.
>
> for me, the instructions you've added come under the umbrella of
> using the raid partition as a normal disk partition. so i'd argue
> that it's outside the remit of this page.
>
> maybe other developers think otherwise though.

As someone who has long been a newbie, this sort of trivial pointer
can be a life-saver. If you think like a programmer and see your OS as
a program this sort of thing comes naturally, but lots of people
don't.
-Nick

Reply | Threaded
Open this post in threaded view
|

Re: softraid clarification in manpage

Thordur Bjornsson-2
On Thu, Jan 27, 2011 at 02:35:54PM -0500, Nick Guenther wrote:

> On Thu, Jan 27, 2011 at 9:39 AM, Jason McIntyre <[hidden email]> wrote:
> > On Wed, Jan 26, 2011 at 04:24:07PM -0600, Amit Kulkarni wrote:
> >> Hi,
> >>
> >> I just configured a mirror using softraid, the manpage was extremely
> >> helpful. I just copy pasted the relevant commands. To a complete
> >> newbie, it was missing a few more lines. I just added those and
> >> sending the diff. I hope a variation of this is accepted to make the
> >> "how to create mirror using softraid" is complete. Googling brings a
> >> lot of RAIDFrame etc, there is very little out there on a pure data
> >> mirror.
> >>
> >> Thanks,
> >> amit
> >>
> >>
> >> Index: softraid.4
> >> ===================================================================
> >> RCS file: /cvs/src/share/man/man4/softraid.4,v
> >> retrieving revision 1.27
> >> diff softraid.4
> >> 147a148,159
> >> > .Pp
> >> > To use the freshly created mirror
> >> > .Bd -literal -offset indent
> >> > # mkdir /datamirror
> >> > # mount /dev/sd0a /datamirror
> >> > # chown normal_openbsd_user /datamirror
> >> > .Ed
> >> > .Pp
> >> > Adding the following line to /etc/fstab will make it useful after every
> boot
> >> > .Bd -literal -offset indent
> >> > /dev/sd0a /datamirror ffs rw,softdep,nodev,nosuid 1 2
> >> > .Pp
> >
> > (as an aside, please send unified diffs (-u) in future)
> >
> > there is a line near the end of EXAMPLES:
> >
> >        The RAID volume is now ready to be used as a normal disk device.
> >
> > for me, the instructions you've added come under the umbrella of
> > using the raid partition as a normal disk partition. so i'd argue
> > that it's outside the remit of this page.
> >
> > maybe other developers think otherwise though.
>
> As someone who has long been a newbie, this sort of trivial pointer
> can be a life-saver. If you think like a programmer and see your OS as
> a program this sort of thing comes naturally, but lots of people
> don't.

IMO, this kind of details are most suitable for a FAQ entry.
Maybe section 14.13 of the FAQ could use some love ?

Reply | Threaded
Open this post in threaded view
|

Re: softraid clarification in manpage

Stuart Henderson
In reply to this post by Nick Guenther
On 2011/01/27 14:35, Nick Guenther wrote:

> On Thu, Jan 27, 2011 at 9:39 AM, Jason McIntyre <[hidden email]> wrote:
> > On Wed, Jan 26, 2011 at 04:24:07PM -0600, Amit Kulkarni wrote:
> >> Hi,
> >>
> >> I just configured a mirror using softraid, the manpage was extremely
> >> helpful. I just copy pasted the relevant commands. To a complete
> >> newbie, it was missing a few more lines. I just added those and
> >> sending the diff. I hope a variation of this is accepted to make the
> >> "how to create mirror using softraid" is complete. Googling brings a
> >> lot of RAIDFrame etc, there is very little out there on a pure data
> >> mirror.
> >>
> >> Thanks,
> >> amit
> >>
> >>
> >> Index: softraid.4
> >> ===================================================================
> >> RCS file: /cvs/src/share/man/man4/softraid.4,v
> >> retrieving revision 1.27
> >> diff softraid.4
> >> 147a148,159
> >> > .Pp
> >> > To use the freshly created mirror
> >> > .Bd -literal -offset indent
> >> > # mkdir /datamirror
> >> > # mount /dev/sd0a /datamirror
> >> > # chown normal_openbsd_user /datamirror
> >> > .Ed
> >> > .Pp
> >> > Adding the following line to /etc/fstab will make it useful after every
> boot
> >> > .Bd -literal -offset indent
> >> > /dev/sd0a /datamirror ffs rw,softdep,nodev,nosuid 1 2
> >> > .Pp
> >
> > (as an aside, please send unified diffs (-u) in future)
> >
> > there is a line near the end of EXAMPLES:
> >
> >        The RAID volume is now ready to be used as a normal disk device.
> >
> > for me, the instructions you've added come under the umbrella of
> > using the raid partition as a normal disk partition. so i'd argue
> > that it's outside the remit of this page.
> >
> > maybe other developers think otherwise though.
>
> As someone who has long been a newbie, this sort of trivial pointer
> can be a life-saver. If you think like a programmer and see your OS as
> a program this sort of thing comes naturally, but lots of people
> don't.

If this was really ready for a newbie, you wouldn't be reading a
kernel device manpage to learn how to configure it, you'd be reading
the FAQ or installation notes and answering questions in the installer...

Reply | Threaded
Open this post in threaded view
|

Re: softraid clarification in manpage

Amit Kulkarni-5
In reply to this post by Thordur Bjornsson-2
thib@,

That's a much better suggestion, also keeping in mind what jmc@ said.
I will send a unified diff against the following file over the
weekend.

http://www.openbsd.org/cgi-bin/cvsweb/www/faq/faq14.html

But first I will tear down the mirror and document everything from scratch.

Thanks for your feedback

On Thu, Jan 27, 2011 at 2:52 PM, Thordur Bjornsson <[hidden email]> wrote:

> On Thu, Jan 27, 2011 at 02:35:54PM -0500, Nick Guenther wrote:
>> On Thu, Jan 27, 2011 at 9:39 AM, Jason McIntyre <[hidden email]> wrote:
>> > On Wed, Jan 26, 2011 at 04:24:07PM -0600, Amit Kulkarni wrote:
>> >> Hi,
>> >>
>> >> I just configured a mirror using softraid, the manpage was extremely
>> >> helpful. I just copy pasted the relevant commands. To a complete
>> >> newbie, it was missing a few more lines. I just added those and
>> >> sending the diff. I hope a variation of this is accepted to make the
>> >> "how to create mirror using softraid" is complete. Googling brings a
>> >> lot of RAIDFrame etc, there is very little out there on a pure data
>> >> mirror.
>> >>
>> >> Thanks,
>> >> amit
>> >>
>> >>
>> >> Index: softraid.4
>> >> ===================================================================
>> >> RCS file: /cvs/src/share/man/man4/softraid.4,v
>> >> retrieving revision 1.27
>> >> diff softraid.4
>> >> 147a148,159
>> >> > .Pp
>> >> > To use the freshly created mirror
>> >> > .Bd -literal -offset indent
>> >> > # mkdir /datamirror
>> >> > # mount /dev/sd0a /datamirror
>> >> > # chown normal_openbsd_user /datamirror
>> >> > .Ed
>> >> > .Pp
>> >> > Adding the following line to /etc/fstab will make it useful after
every

>> boot
>> >> > .Bd -literal -offset indent
>> >> > /dev/sd0a /datamirror ffs rw,softdep,nodev,nosuid 1 2
>> >> > .Pp
>> >
>> > (as an aside, please send unified diffs (-u) in future)
>> >
>> > there is a line near the end of EXAMPLES:
>> >
>> >        The RAID volume is now ready to be used as a normal disk device.
>> >
>> > for me, the instructions you've added come under the umbrella of
>> > using the raid partition as a normal disk partition. so i'd argue
>> > that it's outside the remit of this page.
>> >
>> > maybe other developers think otherwise though.
>>
>> As someone who has long been a newbie, this sort of trivial pointer
>> can be a life-saver. If you think like a programmer and see your OS as
>> a program this sort of thing comes naturally, but lots of people
>> don't.
>
> IMO, this kind of details are most suitable for a FAQ entry.
> Maybe section 14.13 of the FAQ could use some love ?

Reply | Threaded
Open this post in threaded view
|

Re: softraid clarification in manpage

Nick Holland
On 01/27/11 17:17, Amit Kulkarni wrote:

> thib@,
>
> That's a much better suggestion, also keeping in mind what jmc@ said.
> I will send a unified diff against the following file over the
> weekend.
>
> http://www.openbsd.org/cgi-bin/cvsweb/www/faq/faq14.html
>
> But first I will tear down the mirror and document everything from scratch.
>
> Thanks for your feedback

unless you write many times as fast as I do (actually, most people do),
you need a lot more time than that.

there's a softraid FAQ entry I've been working on for a while that's on
hold until certain people are happier with the state of softraid and
diskmap.

Nick.