Re: [indiana-discuss] REVIEW System Admin. Guide for the Back to School Kit

2008-08-05 Thread (William) Brian Leonard

Hi Kathy:

Is the intent to keep this command line focused? In several cases there 
are GUIs you can work with for:


   * Managing services
   * Managing processes
   * Shutting down the system
   * Verifying device driver support

Other notes:

How to Stop a Program:
In this case, look for the bash process for pts/2 which has a process 
ID of 689.
For me it's pts/3 and the process id will always differ. Also, the ps 
command by itself is pretty useless. I generally use ps -ef | grep 
'some string'


I would also echo the sentiments of others to use pfexec instead of 
becoming superuser. It's much safer.



Note that the Server type should be IMAP Mail Server
Why are you assuming this is the case? You're probably better off just 
listing resources on how to configure Thunderbird to connect to popular 
mail servers, such as Yahoo!, gmail, etc.


  In addition to 
the system user account,
you should create a user account and ZFS file system for your personal 
files that can be managed
by delegating ZFS administration permissions, such as creating a file 
system snapshot.
Interesting. Why do we recommend creating a 2nd user account? I'm new to 
OpenSolaris, but this is the first I've heard of this.



http://blogs.sun.com/timf/resource/README.zfs-auto-backup.txt
Consider pointing them to Tim's blog on this subject instead: 
http://blogs.sun.com/timf/entry/zfs_automatic_for_the_people



mount -F smbfs //solarsystem/tmp /mnt
Before you can mount a SMB client you need to first enable the service 
via the GUI or the command line (svcadm enable network/smb/client)



Shut down the system.
Shouldn't the first suggestion be the System  Shutdown menu? And from 
the command line, shouldn't we recommend shutdown over init 5?


Regards,
Brian

Kathy Slattery wrote:

I have been leading a group of writers working on a
companion to the Getting Started Guide. The idea
is to document some useful procedures to help configure
an OpenSolaris laptop after the OS is installed.

Please take a look at a review draft of the
OpenSolaris 2008.05 System Administration Guide
(OSadminguide.pdf) at:

http://www.opensolaris.org/os/project/indiana/files/

We have been working on this book for a couple of weeks,
so we haven't had time to complete all sections or polish
the content yet, but the current content should give you an idea of
what we have decided to cover. In particular, the chapter about
Useful Commands has not been worked on yet. Also, the links to
docs.sun.com aren't working.

I need to deliver this book for the Back To School Kit before August 8th,
so please send me comments by COB on Wednesday 8/6.  We will be
developing this book further after the 8th for the 2008.11 release,
so there will be more time for comments later. For now:

1) send any corrections to me or to the alias if discussion is needed
2) tell me about any procedures that we should add
3) please give me suggestions for a better book title

Many thanks for your time and comments.

-Kathy
--

This message posted from opensolaris.org

___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss
  


--
(William) Brian Leonard
Technology Evangelist
408.404.6884
http://weblogs.java.net/blog/bleonard


___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss


Re: [indiana-discuss] REVIEW System Admin. Guide for the Back to School Kit

2008-08-05 Thread Cindy . Swearingen
Hi William,

Thanks for the comments...

For the ZFS comments:

1.
Good comment about pointing to Tim's blog instead of the script directly.

2. The user account that is created during the OpenSolaris
installation has root privileges. For example:
[EMAIL PROTECTED]:~/Desktop$ roles
root

So, for a student installing the Back to School Kit its probably
best to create a personal user account for papers, etc.

For the general comment:

Please explain how pfexec is safer. :-)

Thanks,

Cindy

(William) Brian Leonard wrote:
 Hi Kathy:
 
 Is the intent to keep this command line focused? In several cases there 
 are GUIs you can work with for:
 
 * Managing services
 * Managing processes
 * Shutting down the system
 * Verifying device driver support
 
 Other notes:
 
 How to Stop a Program:
 
 In this case, look for the bash process for pts/2 which has a process 
 ID of 689.
 
 For me it's pts/3 and the process id will always differ. Also, the ps 
 command by itself is pretty useless. I generally use ps -ef | grep 
 'some string'
 
 I would also echo the sentiments of others to use pfexec instead of 
 becoming superuser. It's much safer.
 
 Note that the Server type should be IMAP Mail Server
 
 Why are you assuming this is the case? You're probably better off just 
 listing resources on how to configure Thunderbird to connect to popular 
 mail servers, such as Yahoo!, gmail, etc.
 
   In addition to 
 the system user account,
 you should create a user account and ZFS file system for your personal 
 files that can be managed
 by delegating ZFS administration permissions, such as creating a file 
 system snapshot.
 
 Interesting. Why do we recommend creating a 2nd user account? I'm new to 
 OpenSolaris, but this is the first I've heard of this.
 
 http://blogs.sun.com/timf/resource/README.zfs-auto-backup.txt
 
 Consider pointing them to Tim's blog on this subject instead: 
 http://blogs.sun.com/timf/entry/zfs_automatic_for_the_people
 
 mount -F smbfs //solarsystem/tmp /mnt
 
 Before you can mount a SMB client you need to first enable the service 
 via the GUI or the command line (svcadm enable network/smb/client)
 
 Shut down the system.
 
 Shouldn't the first suggestion be the System  Shutdown menu? And from 
 the command line, shouldn't we recommend shutdown over init 5?
 
 Regards,
 Brian
 
 Kathy Slattery wrote:
 
I have been leading a group of writers working on a
companion to the Getting Started Guide. The idea
is to document some useful procedures to help configure
an OpenSolaris laptop after the OS is installed.

Please take a look at a review draft of the
OpenSolaris 2008.05 System Administration Guide
(OSadminguide.pdf) at:

http://www.opensolaris.org/os/project/indiana/files/

We have been working on this book for a couple of weeks,
so we haven't had time to complete all sections or polish
the content yet, but the current content should give you an idea of
what we have decided to cover. In particular, the chapter about
Useful Commands has not been worked on yet. Also, the links to
docs.sun.com aren't working.

I need to deliver this book for the Back To School Kit before August 8th,
so please send me comments by COB on Wednesday 8/6.  We will be
developing this book further after the 8th for the 2008.11 release,
so there will be more time for comments later. For now:

1) send any corrections to me or to the alias if discussion is needed
2) tell me about any procedures that we should add
3) please give me suggestions for a better book title

Many thanks for your time and comments.

-Kathy
--

This message posted from opensolaris.org

___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss
  

 
 -- 
 (William) Brian Leonard
 Technology Evangelist
 408.404.6884
 http://weblogs.java.net/blog/bleonard
 
 
 
 
 ___
 indiana-discuss mailing list
 indiana-discuss@opensolaris.org
 http://mail.opensolaris.org/mailman/listinfo/indiana-discuss
___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss


Re: [indiana-discuss] REVIEW System Admin. Guide for the Back to School Kit

2008-08-05 Thread Cindy . Swearingen
Hi Dave,

I see your point about the second user account so we'll drop it.

This issue also highlights a transition between managing user accounts
with home directories as a UFS directory and home directories as ZFS 
file systems.

I need to file a bug against the user account manager because it creates
a user account with a home dir as a directory not a ZFS file system. If 
I create a ZFS file system and feed it to user account manager, it
doesn't setup the user home dir ownership correctly.

In the meantime, I'll figure something else out.

Thanks for feedback--

Cindy

Dave Miner wrote:
 [EMAIL PROTECTED] wrote:
 
 Hi William,

 Thanks for the comments...

 For the ZFS comments:

 1.
 Good comment about pointing to Tim's blog instead of the script directly.

 2. The user account that is created during the OpenSolaris
 installation has root privileges. For example:
 [EMAIL PROTECTED]:~/Desktop$ roles
 root

 So, for a student installing the Back to School Kit its probably
 best to create a personal user account for papers, etc.

 
 I haven't reviewed the document, but this exchange caught my eye.
 The account can assume the role, but only does so when specifically 
 requested by entering a profiled shell or using pfexec.  There's no 
 extra privilege when you're running in, say, bash or ksh.
 
 Please do not recommend a second user account, it makes OpenSolaris 
 appear needlessly complex.  At some point we may alter the RBAC 
 privileges created by default to be somewhat less expansive than they 
 are right now, but presently the behavior that results is what is 
 expected for a single-user system, which is that the user can administer 
 his own system.
 
 Dave
___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss


Re: [indiana-discuss] REVIEW System Admin. Guide for the Back to School Kit

2008-08-05 Thread Kathy Slattery

Brian,

Thanks for the suggestions.

From: (William) Brian Leonard [EMAIL PROTECTED]

Hi Kathy:

Is the intent to keep this command line focused? In several cases there 
are GUIs you can work with for:

* Managing services
* Managing processes
* Shutting down the system
* Verifying device driver support

I've changed some of the procedures to use GUIs, but probably not enough
of them. I'll work on adding more GUI coverage after the 8/8 release.


Other notes:

How to Stop a Program:
 In this case, look for the bash process for pts/2 which has a process 
 ID of 689.
For me it's pts/3 and the process id will always differ. Also, the ps 
command by itself is pretty useless. I generally use ps -ef | grep 
'some string'

I've re-written this step. I'll send out a copy tomorrow. Please
tell me if it still doesn't work.


I would also echo the sentiments of others to use pfexec instead of 
becoming superuser. It's much safer.

It's definitely simpler since you don't need a password, 
but I can't see that it's safer since it gives you equivalent
abilities to mess up your installation. I must be missing something.


 Note that the Server type should be IMAP Mail Server
Why are you assuming this is the case? You're probably better off just 
listing resources on how to configure Thunderbird to connect to popular 
mail servers, such as Yahoo!, gmail, etc.

My test of Yahoo! showed that it just worked without any
tweaking, but I'll see what I can do about the others.


   In addition to 
 the system user account,
 you should create a user account and ZFS file system for your personal 
 files that can be managed
 by delegating ZFS administration permissions, such as creating a file 
 system snapshot.
Interesting. Why do we recommend creating a 2nd user account? I'm new to 
OpenSolaris, but this is the first I've heard of this.

 http://blogs.sun.com/timf/resource/README.zfs-auto-backup.txt
Consider pointing them to Tim's blog on this subject instead: 
http://blogs.sun.com/timf/entry/zfs_automatic_for_the_people


Cindy - I'm going to leave these to you.

 mount -F smbfs //solarsystem/tmp /mnt
Before you can mount a SMB client you need to first enable the service 
via the GUI or the command line (svcadm enable network/smb/client)


Cathleen - This one is yours.

 Shut down the system.
Shouldn't the first suggestion be the System  Shutdown menu? And from 
the command line, shouldn't we recommend shutdown over init 5?


This one I just changed this morning. Right now I suggest 
1) System - Shut Down
2) init 5
3) for emergencies only - uadmin 2 6

Using init instead of shutdown seems more appropriate to me on
a laptop. There is no point in sending out broadcast messages
and after a quick test, shutdown doesn't seem to work. In the
past the our docs have suggest shutdown for servers and init for
stand-alone systems. With shutdown 0 not working right on
my laptop, I'm very hesitant to add it to the doc. Please
tell me if your experience with 2008.05 are different.

-Kathy



Kathy Slattery wrote:
 I have been leading a group of writers working on a
 companion to the Getting Started Guide. The idea
 is to document some useful procedures to help configure
 an OpenSolaris laptop after the OS is installed.

 Please take a look at a review draft of the
 OpenSolaris 2008.05 System Administration Guide
 (OSadminguide.pdf) at:

 http://www.opensolaris.org/os/project/indiana/files/

 We have been working on this book for a couple of weeks,
 so we haven't had time to complete all sections or polish
 the content yet, but the current content should give you an idea of
 what we have decided to cover. In particular, the chapter about
 Useful Commands has not been worked on yet. Also, the links to
 docs.sun.com aren't working.

 I need to deliver this book for the Back To School Kit before August 8th,
 so please send me comments by COB on Wednesday 8/6.  We will be
 developing this book further after the 8th for the 2008.11 release,
 so there will be more time for comments later. For now:

 1) send any corrections to me or to the alias if discussion is needed
 2) tell me about any procedures that we should add
 3) please give me suggestions for a better book title

 Many thanks for your time and comments.

 -Kathy
 --

 This message posted from opensolaris.org

 ___
 indiana-discuss mailing list
 indiana-discuss@opensolaris.org
 http://mail.opensolaris.org/mailman/listinfo/indiana-discuss
   

-- 
(William) Brian Leonard
Technology Evangelist
408.404.6884
http://weblogs.java.net/blog/bleonard



___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss


Re: [indiana-discuss] REVIEW System Admin. Guide for the Back to School Kit

2008-08-02 Thread Kathy Slattery
Sorry everyone for the duplicate postings. The system generated a message
when I hit the Post Message button and I didn't realize that it had succeeded
in posting the message. Next time I will check before reposting.

-Kathy
--

This message posted from opensolaris.org

___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss


Re: [indiana-discuss] REVIEW System Admin. Guide for the Back to School Kit

2008-08-02 Thread Mike Gerdts
On Fri, Aug 1, 2008 at 11:21 PM, Kathy Slattery [EMAIL PROTECTED] wrote:
 Mike,

 Please see my comments below:

 On Fri, Aug 1, 2008 at 5:39 PM, Kathy Slattery
 [EMAIL PROTECTED] wrote:
  1) send any corrections to me or to the alias if
 discussion is needed

 Page 10: kill -9 pid should only be used if kill
 pid doesn't
 work. Those that subscribe to the kill -9
 philosophy are likely to
 be the same ones that suggest pulling the power cord
 (and battery, if
 applicable) to shut down a system.  It works, but it
 doesn't allow
 things to come down cleanly.

 The reason that I used kill -9 in this case was that kill didn't work.
 I could change the procedure to use kill and then add a note
 suggesting that they use -9 if kill doesn't work. Would that be better?

That would probably be better.

 Page 25:
 - Quotas only affect data written after compression
 is enabled.
 - Based upon failures that I've seen on sparc with
 live upgrade and
 manually tweaking compression, I think that
 compressed / may not work
 (I may be wrong).  If so, this should be noted.


 OK, I'll get someone to give it a try.

Be sure that you try pkg image-update et. al. or (better) confirm
whether it is intended to be supported or not.

  2) tell me about any procedures that we should add

 As others mentioned, pkg.  beadm and grub probably
 belong nearby.

 Will pointers to the coverage in the Getting Started guide
 be enough? or do we need more? We had some GRUB
 procedures in an earlier working copy, but none of them
 worked right, so we cut them. Is there something in
 specific you'd like to see?

I guess I'm not sure of the role of the two documents.  I'll have to
look around a bit more to see if I have some suggestions on how this
would make most sense.

 Compatibility with pkgadd


 Do you want us to tell them how to run pkgadd?
 With the new packaging system, we were staying away
 from mentioning pkgadd. Are there useful packages
 that you could add to an OpenSolaris system?

Studio 11, needed for ON development is a key one.  If I were bringing
this into an existing Solaris environment I may have my own or third
party packages to install.

 Multi-boot configuration with Windows, Linux.  Major
 bonus points for
 any tips for sharing data between OS's in a
 multi-boot configuration
 without network storage.


 Multi-boot is covered in the Getting Started Guide.
 Again, do we need more pointers?

I'll look...


 I knew the sharing data question was going to come up.
 Unfortunately, I'm not sure that I can get fully tested
 procedure ready by Wednesday, but if I can't we will
 get something in as soon as possible.

Quite understandable.

-- 
Mike Gerdts
http://mgerdts.blogspot.com/
___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss


[indiana-discuss] REVIEW System Admin. Guide for the Back to School Kit

2008-08-01 Thread Kathy Slattery
I have been leading a group of writers working on a
companion to the Getting Started Guide. The idea
is to document some useful procedures to help configure
an OpenSolaris laptop after the OS is installed.

Please take a look at a review draft of the
OpenSolaris 2008.05 System Administration Guide
(OSadminguide.pdf) at:

http://www.opensolaris.org/os/project/indiana/files/

We have been working on this book for a couple of weeks,
so we haven't had time to complete all sections or polish
the content yet, but the current content should give you an idea of
what we have decided to cover. In particular, the chapter about
Useful Commands has not been worked on yet. Also, the links to
docs.sun.com aren't working.

I need to deliver this book for the Back To School Kit before August 8th,
so please send me comments by COB on Wednesday 8/6.  We will be
developing this book further after the 8th for the 2008.11 release,
so there will be more time for comments later. For now:

1) send any corrections to me or to the alias if discussion is needed
2) tell me about any procedures that we should add
3) please give me suggestions for a better book title

Many thanks for your time and comments.

-Kathy
--

This message posted from opensolaris.org

___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss


Re: [indiana-discuss] REVIEW System Admin. Guide for the Back to School Kit

2008-08-01 Thread W. Wayne Liauh
Hi Kathy,

Many portions of the pdf file are not displayed, showing only empty spaces.  I 
am running build 94.  While this problem should be solved b/f 2008.11, I was 
wondering whether it would be possible to experiment a different pdf driver or 
different pdf export option(s)? Similar problems are also experienced in other 
Userguides.
--

This message posted from opensolaris.org

___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss


Re: [indiana-discuss] REVIEW System Admin. Guide for the Back to School Kit

2008-08-01 Thread Mike Gerdts
On Fri, Aug 1, 2008 at 5:39 PM, Kathy Slattery [EMAIL PROTECTED] wrote:
 1) send any corrections to me or to the alias if discussion is needed

Page 10: kill -9 pid should only be used if kill pid doesn't
work. Those that subscribe to the kill -9 philosophy are likely to
be the same ones that suggest pulling the power cord (and battery, if
applicable) to shut down a system.  It works, but it doesn't allow
things to come down cleanly.

Page 25:
- Quotas only affect data written after compression is enabled.
- Based upon failures that I've seen on sparc with live upgrade and
manually tweaking compression, I think that compressed / may not work
(I may be wrong).  If so, this should be noted.

Page 35:
- The dladm output looks contrived.  Why would the link bge0 (implying
Broadcom hardware) claim to be device e1000g0 (implying Intel
hardware)?
- Suggestions as to strategies for getting a network driver onto a
system that is missing the network driver may be useful.  This
question seems to have come up from time to time on the lists.

 2) tell me about any procedures that we should add

As others mentioned, pkg.  beadm and grub probably belong nearby.

Compatibility with pkgadd

Multi-boot configuration with Windows, Linux.  Major bonus points for
any tips for sharing data between OS's in a multi-boot configuration
without network storage.


-- 
Mike Gerdts
http://mgerdts.blogspot.com/
___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss


Re: [indiana-discuss] REVIEW System Admin. Guide for the Back to School Kit

2008-08-01 Thread Kathy Slattery
Glynn,

Thanks for the quick input. See my comments below.

 On 2/08/2008, at 10:17 AM, Kathy Slattery wrote:

 
 A couple of comments based on an initial read -
 
   - 'How to start a Program'
 The use of program seems a little strange, perhaps
  it should be
 'how to start a service'

OK, that makes sense.

 No mention of pfexec? Given that this is one of the
  major features
of 2008.05, it seems a pity not to mention it.

I'll see what I can do.

 - It would be great to detail how to connect to an
 encrypted network
 (WEP/WPA) through use of the dladm create-secobj
  command.

I'll let Steff Brucker work on this one.

 - No mention of IPS/packagemanager?

That is covered in the Getting Started Guide. Obviously I
should add some pointers or something. Would a
specific entry in the Overview tables do, or should 
I create something more?

-Kathy
--

This message posted from opensolaris.org

___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss


Re: [indiana-discuss] REVIEW System Admin. Guide for the Back to School Kit

2008-08-01 Thread Kathy Slattery
Mike,

Please see my comments below:

 On Fri, Aug 1, 2008 at 5:39 PM, Kathy Slattery
 [EMAIL PROTECTED] wrote:
  1) send any corrections to me or to the alias if
 discussion is needed
 
 Page 10: kill -9 pid should only be used if kill
 pid doesn't
 work. Those that subscribe to the kill -9
 philosophy are likely to
 be the same ones that suggest pulling the power cord
 (and battery, if
 applicable) to shut down a system.  It works, but it
 doesn't allow
 things to come down cleanly.

The reason that I used kill -9 in this case was that kill didn't work.
I could change the procedure to use kill and then add a note
suggesting that they use -9 if kill doesn't work. Would that be better?

 
 Page 25:
 - Quotas only affect data written after compression
 is enabled.
 - Based upon failures that I've seen on sparc with
 live upgrade and
 manually tweaking compression, I think that
 compressed / may not work
 (I may be wrong).  If so, this should be noted.


OK, I'll get someone to give it a try. 

 
 Page 35:
 - The dladm output looks contrived.  Why would the
 link bge0 (implying
 Broadcom hardware) claim to be device e1000g0
 (implying Intel
 hardware)?

We had some confusion about the device names, so
there is probably some examples that were not cleaned
up properly. Thanks for noticing it.

 - Suggestions as to strategies for getting a network
 driver onto a
 system that is missing the network driver may be
 useful.  This
 question seems to have come up from time to time on
 the lists.

OK, I'll see what we can dig up.

 
  2) tell me about any procedures that we should add
 
 As others mentioned, pkg.  beadm and grub probably
 belong nearby.

Will pointers to the coverage in the Getting Started guide
be enough? or do we need more? We had some GRUB
procedures in an earlier working copy, but none of them
worked right, so we cut them. Is there something in
specific you'd like to see?

 
 Compatibility with pkgadd
 

Do you want us to tell them how to run pkgadd?
With the new packaging system, we were staying away
from mentioning pkgadd. Are there useful packages
that you could add to an OpenSolaris system?

 Multi-boot configuration with Windows, Linux.  Major
 bonus points for
 any tips for sharing data between OS's in a
 multi-boot configuration
 without network storage.
 

Multi-boot is covered in the Getting Started Guide.
Again, do we need more pointers? 

I knew the sharing data question was going to come up.
Unfortunately, I'm not sure that I can get fully tested
procedure ready by Wednesday, but if I can't we will
get something in as soon as possible.

Thanks for the comments.

-Kathy
--

This message posted from opensolaris.org

___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss


Re: [indiana-discuss] REVIEW System Admin. Guide for the Back to School Kit

2008-08-01 Thread Richard Elling
W. Wayne Liauh wrote:
 Hi Kathy,

 Many portions of the pdf file are not displayed, showing only empty spaces.  
 I am running build 94.  While this problem should be solved b/f 2008.11, I 
 was wondering whether it would be possible to experiment a different pdf 
 driver or different pdf export option(s)? Similar problems are also 
 experienced in other Userguides.
   

This is not a PDF problem, it is a freetype font problem which
was introduced with freetype 2.3.6 in b93 and should be fixed in
b95 or b96.
http://bugs.opensolaris.org/bugdatabase/view_bug.do?bug_id=6723656
http://bugs.opensolaris.org/bugdatabase/view_bug.do?bug_id=6712820

 -- richard

___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss