From alan.mcclellan at sun.com Mon Nov 2 10:16:52 2009 From: alan.mcclellan at sun.com (alan mcclellan) Date: Mon, 02 Nov 2009 10:16:52 PST Subject: [docs-discuss] docs community site traffic In-Reply-To: <1468126953.131249330175651.JavaMail.Twebapp@sf-app1> Message-ID: <912748108.81257185844162.JavaMail.Twebapp@sf-app1> Here's a quick roll-up of October traffic to various documentation-related sites. http://spreadsheets.google.com/pub?key=pzCosgzxVSeXF2GqxVJmQWw&single=true&gid=14&output=html I'll try to get some more detailed daily unique visitor info and pass along. I'm also checking to make sure we can still get traffic data on the new xwiki site. -- This message posted from opensolaris.org From euan at potensol.com Mon Nov 2 22:59:30 2009 From: euan at potensol.com (Euan Thoms) Date: Mon, 02 Nov 2009 22:59:30 PST Subject: [docs-discuss] scp no-clobber option?? Message-ID: <1703544952.151257231600685.JavaMail.Twebapp@sf-app1> Is there an option for no-clobber (does not overwrite existing files) in the command scp? "man scp" doesn' t reveal anything. I got one hit in google which indicated that there was but perhaps that was the GNU version of scp. -- This message posted from opensolaris.org From alan.mcclellan at sun.com Fri Nov 6 10:35:39 2009 From: alan.mcclellan at sun.com (alan mcclellan) Date: Fri, 06 Nov 2009 10:35:39 PST Subject: [docs-discuss] wiki docs collaboration area Message-ID: <1081301397.381257532569888.JavaMail.Twebapp@sf-app1> Now that the docs community is running on a wiki, I would like to set up a collaboration area similar to the how tos and guides pages that have been hosted by the fine folks on the genunix site (e.g., http://wiki.genunix.org/wiki/index.php/HOWTOs_and_Guides). I'm thinking generally that we'll want pages for the following: * Wish list...a page where users can list things they want documentation help with. * Dev list...a page that shows what folks are working on and status (so that don't have collisions with people duplicating effort). * Templates...a page that provides basic elements of the kind of docs we want help with. For example, for a how to procedure, we can lay out an outline of required and optional elements that would make these consistent one to another (which ultimately makes it easier for users coming to the site for help). * "How to" aggregation/toc" page....a page that lists the procedures that have actually been written. (I need to prove to myself we can do this, but I'm hoping we can use labels and automate the collection of these links on a single page.) Would appreciate any inputs on this effort. I'll start assembling some of these pages as time allows. -alan -- This message posted from opensolaris.org From rheilke at dragonhearth.com Tue Nov 10 15:08:29 2009 From: rheilke at dragonhearth.com (Rainer Heilke) Date: Tue, 10 Nov 2009 15:08:29 -0800 Subject: [docs-discuss] scp no-clobber option?? In-Reply-To: <1703544952.151257231600685.JavaMail.Twebapp@sf-app1> References: <1703544952.151257231600685.JavaMail.Twebapp@sf-app1> Message-ID: <4AF9F26D.5050807@dragonhearth.com> Sorry, I've looked for something like this several times myself, but never found anything. What I tend to do now is scp everything to a new directory, and then mv -i it to the final spot. Does nothing to conserve disk space or network traffic, though... Rainer Euan Thoms wrote: > Is there an option for no-clobber (does not overwrite existing files) in the command scp? "man scp" doesn' t reveal anything. I got one hit in google which indicated that there was but perhaps that was the GNU version of scp. From Alan.McClellan at Sun.COM Wed Nov 11 07:33:03 2009 From: Alan.McClellan at Sun.COM (alan mcclellan) Date: Wed, 11 Nov 2009 08:33:03 -0700 Subject: [docs-discuss] scp no-clobber option?? In-Reply-To: <4AF9F26D.5050807@dragonhearth.com> References: <1703544952.151257231600685.JavaMail.Twebapp@sf-app1> <4AF9F26D.5050807@dragonhearth.com> Message-ID: <4AFAD92F.9070900@sun.com> Does rsync do what you want (update only the modified files)? -alan Rainer Heilke wrote: > Sorry, I've looked for something like this several times myself, but > never found anything. > > What I tend to do now is scp everything to a new directory, and then > mv -i it to the final spot. Does nothing to conserve disk space or > network traffic, though... > > Rainer > > Euan Thoms wrote: >> Is there an option for no-clobber (does not overwrite existing files) >> in the command scp? "man scp" doesn' t reveal anything. I got one hit >> in google which indicated that there was but perhaps that was the GNU >> version of scp. > > _______________________________________________ > docs-discuss mailing list > docs-discuss at opensolaris.org From elowe8 at yahoo.com Wed Nov 11 07:46:39 2009 From: elowe8 at yahoo.com (Eric Lowe) Date: Wed, 11 Nov 2009 07:46:39 -0800 (PST) Subject: [docs-discuss] scp no-clobber option?? In-Reply-To: <4AFAD92F.9070900@sun.com> References: <1703544952.151257231600685.JavaMail.Twebapp@sf-app1> <4AF9F26D.5050807@dragonhearth.com> <4AFAD92F.9070900@sun.com> Message-ID: <418464.77040.qm@web111016.mail.gq1.yahoo.com> It sounds like you want the semantics of rsync -a. See the rsync man page for instructions on using ssh as the transport, I have done this before and it works wonderfully. - Eric ----- Original Message ---- From: alan mcclellan To: Rainer Heilke Cc: docs-discuss at opensolaris.org; Euan Thoms Sent: Wed, November 11, 2009 9:33:03 AM Subject: Re: [docs-discuss] scp no-clobber option?? Does rsync do what you want (update only the modified files)? -alan Rainer Heilke wrote: > Sorry, I've looked for something like this several times myself, but never found anything. > > What I tend to do now is scp everything to a new directory, and then mv -i it to the final spot. Does nothing to conserve disk space or network traffic, though... > > Rainer > > Euan Thoms wrote: >> Is there an option for no-clobber (does not overwrite existing files) in the command scp? "man scp" doesn' t reveal anything. I got one hit in google which indicated that there was but perhaps that was the GNU version of scp. > > _______________________________________________ > docs-discuss mailing list > docs-discuss at opensolaris.org _______________________________________________ docs-discuss mailing list docs-discuss at opensolaris.org From rheilke at dragonhearth.com Wed Nov 11 09:40:39 2009 From: rheilke at dragonhearth.com (Rainer Heilke) Date: Wed, 11 Nov 2009 09:40:39 -0800 Subject: [docs-discuss] scp no-clobber option?? In-Reply-To: <4AFAD92F.9070900@sun.com> References: <1703544952.151257231600685.JavaMail.Twebapp@sf-app1> <4AF9F26D.5050807@dragonhearth.com> <4AFAD92F.9070900@sun.com> Message-ID: <4AFAF717.8000102@dragonhearth.com> Actually, yes. I always forget about it, as it's just a little more complicated and I've not tried it. But yes, one guy where I used to work swore by it, using it all the time for just this reason. Good catch. Rainer alan mcclellan wrote: > Does rsync do what you want (update only the modified files)? > > -alan > > Rainer Heilke wrote: >> Sorry, I've looked for something like this several times myself, but >> never found anything. >> >> What I tend to do now is scp everything to a new directory, and then >> mv -i it to the final spot. Does nothing to conserve disk space or >> network traffic, though... >> >> Rainer >> >> Euan Thoms wrote: >>> Is there an option for no-clobber (does not overwrite existing files) >>> in the command scp? "man scp" doesn' t reveal anything. I got one hit >>> in google which indicated that there was but perhaps that was the GNU >>> version of scp. From alan.mcclellan at sun.com Fri Nov 13 12:42:59 2009 From: alan.mcclellan at sun.com (alan mcclellan) Date: Fri, 13 Nov 2009 12:42:59 PST Subject: [docs-discuss] wiki docs collaboration area In-Reply-To: <1081301397.381257532569888.JavaMail.Twebapp@sf-app1> Message-ID: <867134666.321258145009849.JavaMail.Twebapp@sf-app1> So, I've been able to get started on some of this work. I've made the most progress on a "How To" template that I think can serve as a starting place for any procedural documentation. Please take a look and let me know if any inputs: http://hub.opensolaris.org/bin/view/Community+Group+documentation/How+To+Template Note, there are some issues with the current xwiki implementation that is preventing the macros from displaying correctly. To see how the macros should look, you can use the following URL (which adds a reference to a style sheet that is under developement): http://hub.opensolaris.org/bin/view/Community+Group+documentation/How+To+Template?skin=toucan I'll post links to other pages when they're ready. -alan -- This message posted from opensolaris.org From alan.mcclellan at sun.com Tue Nov 17 13:20:47 2009 From: alan.mcclellan at sun.com (alan.mcclellan at sun.com) Date: Tue, 17 Nov 2009 13:20:47 -0800 (PST) Subject: [docs-discuss] Dividing content into multiple chapters. Message-ID: <200911172120.nAHLKlIw003036@sf-app2.opensolaris.org> Author: Alan McClellan Repository: /hg/indiana/GSG Latest revision: 5fa14c5d6af7db7bfc8949e8e100e3dea12882e3 Total changesets: 1 Log message: Dividing content into multiple chapters. Files: create: exploringosol.xml From alan.mcclellan at sun.com Tue Nov 17 13:20:48 2009 From: alan.mcclellan at sun.com (alan.mcclellan at sun.com) Date: Tue, 17 Nov 2009 13:20:48 -0800 (PST) Subject: [docs-discuss] Adding a discrete book file for the chapter 1 / Live CD deliverable. Message-ID: <200911172120.nAHLKmVI003049@sf-app2.opensolaris.org> Author: Alan McClellan Repository: /hg/indiana/GSG Latest revision: 90b2e3895d8a79af3535de360626a9b11bd45ba0 Total changesets: 1 Log message: Adding a discrete book file for the chapter 1 / Live CD deliverable. Files: create: GETSTARTCD.book From robert.buj at gmail.com Tue Nov 17 18:32:50 2009 From: robert.buj at gmail.com (Robert Buj Gelonch) Date: Tue, 17 Nov 2009 18:32:50 PST Subject: [docs-discuss] OS2009.06 - IPS (DOC) - Issues Message-ID: <699858675.551258511600520.JavaMail.Twebapp@sf-app1> Hi All, I'm currently translating "OpenSolaris 2009.06 Image Packaging System Guide" into catalan language by using openCTI tool. I think that I have found various issues on original documentation: [b]1st issue[/b] is located in chapter: "Advanced IPS commads", section:"Overview of pkg.depot server", table:"5.8-pkg.depotd(1M) options". Missing arguments at 1st row (Option) on "pkg.depotd(1M) options" table. --writable-root [b]path[/b] --ssl-key-file [b]source[/b] --ssl-dialog [b]type[/b] --ssl-cert-file [b]source[/b] [1] http://dlc.sun.com/osol/docs/content/2009.06/IMGPACKAGESYS/depot_server.html [b]2nd issue[/b]: Terminology: pkg(1) Comand reference [b]bad[/b]: Does not attempt to contact the image's [b]authorities[/b] to retrieve their [b]catalogs[/b]. [b]suggested[/b]: Does not attempt to contact the image's [b]publishers[/b] to retrieve their [b]catalogues[/b]. [b]cause[/b]: Terminology was changed on OS2009.06, authority term has to be changed with publisher term. catalog [en_US] -> catalogue [EN_GB] [2]: http://dlc.sun.com/osol/docs/content/2009.06/IMGPACKAGESYS/gentextid-2539.html [b]3rd Issue[/b]: IPS FAQ: Inconsistency [b]Source[/b]: "Use the Package Manager (which is the Graphical User Interface for IPS) to install packages from the command line." [b]Inconsistency[/b]: Package Manager is a GUI client of IPS. pkg(1) is a CLI client of IPS. [b]4th Issue[/b]: IPS-FAQ: Doubt What is the meaning of (jo_todo)? [b]Source[/b]: "See the {4}Package Manager{5} section or Working With Packages section (jo_todo) for information." [b]Idea[/b]: Is job to do? Regards, Robert -- This message posted from opensolaris.org From Jyothi.Srinath at Sun.COM Wed Nov 18 08:28:16 2009 From: Jyothi.Srinath at Sun.COM (Jyothi Srinath) Date: Wed, 18 Nov 2009 08:28:16 -0800 Subject: [docs-discuss] OS2009.06 - IPS (DOC) - Issues In-Reply-To: <699858675.551258511600520.JavaMail.Twebapp@sf-app1> References: <699858675.551258511600520.JavaMail.Twebapp@sf-app1> Message-ID: <4B0420A0.9090400@Sun.COM> On 11/17/09 18:32, Robert Buj Gelonch wrote: > Hi All, > > I'm currently translating "OpenSolaris 2009.06 Image Packaging System Guide" into catalan language by using openCTI tool. > > I think that I have found various issues on original documentation: > > [b]1st issue[/b] is located in chapter: "Advanced IPS commads", section:"Overview of pkg.depot server", table:"5.8-pkg.depotd(1M) options". Missing arguments at 1st row (Option) on "pkg.depotd(1M) options" table. > > --writable-root [b]path[/b] > --ssl-key-file [b]source[/b] > --ssl-dialog [b]type[/b] > --ssl-cert-file [b]source[/b] > > [1] http://dlc.sun.com/osol/docs/content/2009.06/IMGPACKAGESYS/depot_server.html > > [b]2nd issue[/b]: Terminology: pkg(1) Comand reference > > [b]bad[/b]: Does not attempt to contact the image's [b]authorities[/b] to retrieve their [b]catalogs[/b]. > [b]suggested[/b]: Does not attempt to contact the image's [b]publishers[/b] to retrieve their [b]catalogues[/b]. > [b]cause[/b]: Terminology was changed on OS2009.06, authority term has to be changed with publisher term. > catalog [en_US] -> catalogue [EN_GB] > > [2]: http://dlc.sun.com/osol/docs/content/2009.06/IMGPACKAGESYS/gentextid-2539.html > > [b]3rd Issue[/b]: IPS FAQ: Inconsistency > > [b]Source[/b]: "Use the Package Manager (which is the Graphical User Interface for IPS) to install packages from the command line." > [b]Inconsistency[/b]: Package Manager is a GUI client of IPS. pkg(1) is a CLI client of IPS. > > [b]4th Issue[/b]: IPS-FAQ: Doubt > > What is the meaning of (jo_todo)? > > [b]Source[/b]: "See the {4}Package Manager{5} section or Working With Packages section (jo_todo) for information." > [b]Idea[/b]: Is job to do? > > Regards, > > Robert > Hi Robert, I am the writer for the IPS USer Guide. Thanks for pointing out some of the errors in the document. I will correct them as I update the doc for 2010.03. Also, are you looking at the xml file for translation? The last couple of issues are probably under "Writer Remarks", which does not show up in the final doc. Can you see the "Writer Remarks" tag? These should not be translated. Thanks, Jyothi From alan.mcclellan at sun.com Thu Nov 19 09:37:20 2009 From: alan.mcclellan at sun.com (alan.mcclellan at sun.com) Date: Thu, 19 Nov 2009 09:37:20 -0800 (PST) Subject: [docs-discuss] Initial commit of source files necessary to create introductory Getting Started HTML files for Live CD. Message-ID: <200911191737.nAJHbK8R023124@sf-app2.opensolaris.org> Author: Alan McClellan Repository: /hg/indiana/GSG-LiveCD Latest revision: c9ce10dc8f6136ccd8d91df8da03a8a16765d1e8 Total changesets: 1 Log message: Initial commit of source files necessary to create introductory Getting Started HTML files for Live CD. Files: create: GETSTARTCD.book create: abstract.xml create: exploringosol.xml create: fr-legal.xml create: fr-other-trademarks.xml create: js/1p.js create: legal.xml create: other-trademarks.xml create: sun-trademarks.xml From frank.allan at sun.com Mon Nov 23 19:58:39 2009 From: frank.allan at sun.com (Frank Allan) Date: Mon, 23 Nov 2009 19:58:39 PST Subject: [docs-discuss] [osol-help] SPARC auto install CD won't boot Message-ID: <382473014.581259035150015.JavaMail.Twebapp@sf-app1> I have been able to setup an AI server and successfully install onto a V210 without any x86 involvement at all. You need to get the bootablr SPARC image from http://alexeremin.blogspot.com/2009/11/opensolaris-sparc-snv125-livecd.html which allows you to install build 125 on SPARC, then download the repository isos (nearly 8Gb in total) and setup the just installed machine as a depot server. You can then update this machine from itself and can also set it up as an AI server. There are some (old) AI setup docs included in the OpenSolaris docs available for download from the Sun Download Centre (20090715) and they provide enough information to setup a DHCP server and an AI server and client. The next challenge is finding docs which explain the process needed to configure client manifests so that the Automated Install can include things like: - turn off nwam and use static addressing - enable root login instead of it being a role - automatically setup a mirrored root disk - configure the hostname to be something other than 'opensolaris' i.e. all the things that you can currently do easily with JET or Jumpstart, and would really like to do in a corporate environment. So far I have had no luck with any of this, so I have to resort to manually changing all these after the system has been installed - bearable for one or two systems, but a big PITA when you have a number of systems to configure. Hopefully the availability of a bootable AI SPARC image will coincide with some tools to allow reasonable customization of client services. Cheers Frank -- This message posted from opensolaris.org