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

2008-08-01 Thread Glynn Foster

On 2/08/2008, at 10:17 AM, 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/

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'

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

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

- No mention of IPS/packagemanager?


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


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

2008-08-01 Thread Alan Coopersmith
Glynn Foster wrote:
   - No mention of pfexec? Given that this is one of the major features
 of 2008.05, it seems a pity not to mention it.

And examples like those given in the Configuring Network Settings sections
would seem to be better given using pfexec than telling people to su to root
when they can't actually do that in the default configuration (as is noted
about 10 pages later).

The note about root's shell reminds me we still need chsh, since it implies
the only way to change root's shell is vi /etc/passwd.

In the finding CIFS shares section, wouldn't it be better to call it the
Nautilus file browser instead of the Sun Java(TM) Desktop System file
browser?   I thought most JDS branding was gone in 2008.05.

Under how to shut down a system, what about the Shutdown entry in the GNOME
menu?

-- 
-Alan Coopersmith-   [EMAIL PROTECTED]
 Sun Microsystems, Inc. - X Window System Engineering

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


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

2008-08-01 Thread Glynn Foster

On 2/08/2008, at 11:09 AM, Alan Coopersmith wrote:
 In the finding CIFS shares section, wouldn't it be better to call it  
 the
 Nautilus file browser instead of the Sun Java(TM) Desktop System  
 file
 browser?   I thought most JDS branding was gone in 2008.05.

I'd probably not even use Nautilus, since it isn't even a term used on  
the desktop - perhaps just GNOME file browser, or desktop file browser.


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


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

2008-08-01 Thread James Cornell
Glynn Foster wrote:
 On 2/08/2008, at 11:09 AM, Alan Coopersmith wrote:
   
 In the finding CIFS shares section, wouldn't it be better to call it  
 the
 Nautilus file browser instead of the Sun Java(TM) Desktop System  
 file
 browser?   I thought most JDS branding was gone in 2008.05.
 

 I'd probably not even use Nautilus, since it isn't even a term used on  
 the desktop - perhaps just GNOME file browser, or desktop file browser.


 Glynn
 ___
 indiana-discuss mailing list
 indiana-discuss@opensolaris.org
 http://mail.opensolaris.org/mailman/listinfo/indiana-discuss
   
I think it's actually GNOME File Manager.

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


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

2008-08-01 Thread Stephanie Brucker
Thanks for responding to this so quickly. I can answer one of your 
questions, Glynn. See below.

- Steff


Glynn Foster wrote:

snippage

 A couple of comments based on an initial read -

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

The table at the end of the Network Configuration section has a link to 
documentation for the WiFi commands. Unfortunately, the links are not 
live yet. So you wouldn't know that the link to a whole section of CLI 
WiFi commands also goes to instructions for creating a WEP key with 
dladm create-secobj.

I'm not sure that this SAG guide would need a duplicate procedure for 
creating a WEP key. I'd leave that up to Kathy. I'm certainly open to 
creating a specific link to the procedure for secure communications 
through WEP in the table at the end of the Network Configuration section.
___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss


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

2008-08-01 Thread Glynn Foster

On 2/08/2008, at 11:29 AM, Stephanie Brucker wrote:

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

 The table at the end of the Network Configuration section has a link  
 to documentation for the WiFi commands. Unfortunately, the links are  
 not live yet. So you wouldn't know that the link to a whole section  
 of CLI WiFi commands also goes to instructions for creating a WEP  
 key with dladm create-secobj.

 I'm not sure that this SAG guide would need a duplicate procedure  
 for creating a WEP key. I'd leave that up to Kathy. I'm certainly  
 open to creating a specific link to the procedure for secure  
 communications through WEP in the table at the end of the Network  
 Configuration section.

I assume you're trying to document some of the common use cases that  
someone new to OpenSolaris would go through - I would have thought  
encrypted wifi networks were common enough to include.


Glynn

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


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

2008-08-01 Thread Cindy Swearingen
Hi Glynn,

Sorry to be a dolt, but what's the strategy behind using pfexec if
the OpenSolaris installation goes through the trouble of setting
up root as a role?

I also noticed that the secondary user account that the OpenSolaris
install creates also has root privileges as a role. 

So, why aren't we using the roles?

In previous Solaris versions, we recommended setting up roles
and using them, and not using pfexec manually.

Since I'm late to this party, please feel free set me straight.

Regards,

Cindy

- Original Message -
From: Glynn Foster [EMAIL PROTECTED]
Date: Friday, August 1, 2008 4:57 pm
Subject: Re: [docs-discuss] REVIEW System Admin. Guide for the Back to School 
Kit
To: Kathy Slattery [EMAIL PROTECTED]
Cc: indiana-discuss@opensolaris.org, [EMAIL PROTECTED]

 On 2/08/2008, at 10:17 AM, 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/
 
 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'
 
   - No mention of pfexec? Given that this is one of the major features
 of 2008.05, it seems a pity not to mention it.
 
   - It would be great to detail how to connect to an encrypted network
 (WEP/WPA) through use of the dladm create-secobj command.
 
 - No mention of IPS/packagemanager?
 
 
 Glynn
 ___
 docs-discuss mailing list
 [EMAIL PROTECTED]
___
indiana-discuss mailing list
indiana-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/indiana-discuss