Hi Frank, sorry I didn't respond sooner, I didn't catch your email
until just now. Here are my comments:
A general comment: Some of your statements made it pretty clear to me
that you haven't been playing around with the webstack admin tools or
NetBeans 6 in build 79 or 79a (for example, you say you need to
install NetBeans 6 and the PHP and Ruby plugins, which isn't the
case). Please test your documentation against the features that are
there to make sure it's accurate.
Page 4
- The picture showing database support should include Java DB, as we
have strong support for it in NB and it is also a Sun-supported
database that meets a definite set of needs for our developers
Page 5
- You only mention PostgreSQL. Should probably mention all or none of
the databases by name. If you want one, MySQL would be my first
choice.
- For SXDE 01/08, NetBeans is already installed. JDK 5 is also there.
So I think it's confusing to say you will need these
- You tell people to go to Services tab and register Apache Web
Server, but before you do that, you need to do All Applications ->
Developer Tools -> Web Stack Admin -> Initialize Web Stack, and then
do Web Stack Admin -> Start Apache2/MySQL Servers
- You don't need to do manual configuration of Apache. Run Find
Server and after about a minute it will find the Apache Server and
set everything correctly
- You should provide instructions on how to set permissions, e.g. "su
root" and then "chmod a+w /var/apache2/2.2/htdocs"
Page 11
- You can enable debug directly from the Web Stack Admin menu without
having to edit the ini file. Choose Web Stack Admin -> Options and
select the PHP tab and set the checkbox for "PHP Debugger". This tab
also lets you directly edit the ini file by clicking on "Advanced
Configuration"
Page 12
- PHP plugin *is* available with Solaris, see All
Applications->Developer Tools->NetBeans PHP IDE 6.0
Page 14
- You don't need to start Apache Web server using svcadm, it's
available through the web stack admin tools
Page 16
- You should provide instructions on how to make the Ruby gem
repository writeable ("su root" and "chmod -R a+w
/var/ruby/1.8/gem_home"), and how to install Ruby on Rails
(Tools->Gems, then install Ruby on Rails, making *sure* you install
Ruby on Rails 1.x rather than 2.x). Also, note you can install Rails
directly from NetBeans, rather than from the command line.
Page 18
- NetBeans 6.0 on Solaris *comes* with Ruby support, you don't need to
install it via the plugin manager.
Page 20
- The PostgreSQL driver is *not* pre-installed with NetBeans Ruby
support. You need to install the postgres-pr Ruby gem using the Gem
Manager
- When using PostgreSQL with JRuby (not native Ruby), you need to edit
the database.yml file and uncomment the lines that start with "host"
and "port", otherwise Ruby access to PostgreSQL will fail
Page 22
- We do not *support* all the databases you list. We have users using
them. The official list of database drivers that we test and support
can be found at http://wiki.netbeans.org/DatabasesAndDrivers.
- Initial setup of PostgreSQL is quite easy in 01/08:
* su root
* svcadm enable postgresql:version_)82
That's it. This automatically sets up the data directory and
initializes the database as part of starting the service.
Page 24
- The default password for Postgres is an empty password, not 'postgres'
Page 26
- *Please* don't guide users towards "Design Query". This
functionality is limited and somewhat broken. Just have them use
"Execute Command..." and work with the straight SQL editor
Page 27
- I recommend putting MySQL ahead of PostgreSQL given it's import in
the AMP stack and our recent acquisition.
- Please just have people start MySQL from the webstack tool menu, no
point bothering them with svcadm. At a minimum, put the svcadm
instructions second, not first.
Page 28
- You should indicate that the default user/password for MySQL is
"root/<empty>", and that there is no database name available
initially.
- Change "like PostgreSQL" to "like MySQL"
- "Updating the D" should be "Updating the DB"
Page 35
- Why don't you point to the Wiki page I set up for NB and Solaris, at
http://wiki.netbeans.org/NetBeansAndSolarisHowTos. Nothing there yet,
but there will be in time for the release (although your doc has
covered a lot of it, thanks!)
David
On Jan 25, 2008 9:04 PM, Frank Jennings <Frank.Jennings at sun.com> wrote:
> Hello everyone,
> I'm Frank from the Solaris Developer IP group. I'm collecting Web Stack
> specific information for publishing in NetBeans site.
> Please visit the following link:
>
> http://www.jennings.in/wstack/NB_WebStack_Draft2.pdf
>
> for a PDF containing information on getting started with NetBeans for
> Web App. development. The information and instructions are specific to
> Web Stack available through SXDE 1/08. It is not a marketing doc or a
> Web Stack-NB reference manual. It is just a quick start guide that
> NetBeans community will need to consider using NetBeans on Solaris for
> web development.
>
> The document is targeted for existing NetBeans users and web application
> developers.
>
> Please review the document and send me any information that needs to be
> included in this guide. The final guide will be available on NetBeans
> wiki site post SXDE 1/08.
>
> (Re-sending the mail as my earlier mail bounced back due to the large
> PDF (~2MB)).
>
> Regards
> Frank J
>
> _______________________________________________
>
>
> webstack-discuss mailing list
> webstack-discuss at opensolaris.org
> http://mail.opensolaris.org/mailman/listinfo/webstack-discuss
>
--
David W. Van Couvering
http://davidvancouvering.blogspot.com
