pen load balancer [PSARC/2008/339 FastTrack timeout 05/29/2008]

[John Fischer]

All,

Jia has provided updated materials (the updated proposal
is attached).  The updated case materials also includes
updated man pages.  The external site will be automatically
updated soon.

Thanks,

John



On Tue, 2008-06-03 at 08:26, Darren J Moffat wrote:
> Jia Ni wrote:
> >> My understanding from the above reference is that the pen program 
> >> itself does NOT read the /etc/pen.cf file by default (it does take -f 
> >> argument).   In this case I highly recommend that the pen 
> >> configuration be via SMF properties able to be set per instance of 
> >> svc:/network/pen/ or at least that there is a per instance property 
> >> for specifying the config file location.
> > Sorry. I am not quite understand the meaning of "specifying config file 
> > location"?
> > Usually, smf instance don't take any arguments and it's config file is 
> > fixed somewhere. Do you mean I should set the each instance of pen 
> > config file in a separate place? Eg, "pen.http.conf" for http, 
> > "pen.ftp.conf" for ftp ...?
> 
> Two choices either use SMF properties for all of the configuration 
> options of pen - this is the idea case.  Or create a smaller set of SMF 
> properties including one that gives the location of a pen.cf file, the 
> method script would use that property to find pen.cf instead of being 
> hardcoded to /etc/pen.cf as it would in the original spec.
> 
> -- 
> Darren J Moffat
-------------- next part --------------
Summary
=======
	Pen[1] is a tool designed to do load balance for "simple" tcp based
	protocols such as http or smtp.
	
	It allows several servers to appear as one to the outside and
	automatically detects servers that are down and distributes clients
	among the available servers. This gives high availability and scalable
	performance.

	pen-0.17.2 will be integrated into the SFW consolidation as part of this
	proposal, and will be installed as SUNWpen.

	This project requests a minor release binding.

Discussion
==========

	In OpenSolaris, the public interface to start and stop pen will be SMF
	and the service will be named:

		svc:/network/pen:default

	In order to start pen by SMF, two SMF properties must be set:

		pen/listenport and pen/servers 

	Other properties can be set optionally. Each SMF property has a
	corresponding command line option. These properties are explained in
	the "SMF PROPERTIES" section of the pen(1) manual page. Users can
	easily change these properties and start pen with different
	configurations.

	Note that users can still start pen from command line for other
	purposes which are not supported by the SMF service (eg., foreground
	or debug mode).

Dependencies
============

	OpenSSL (snv_84 version 0.9.8a)

Interfaces
==========

	Exported Interfaces		Classification	Comment
	-------------------		--------------	-------
	SUNWpen				Uncommitted	Package
	/usr/bin/pen			Uncommitted	Command
	/usr/bin/mergelogs		Uncommitted	Command
	/usr/bin/penctl			Uncommitted	Command
	/usr/bin/penlog			Uncommitted	Command
	/usr/bin/penlogd		Uncommitted	Command
	/usr/share/doc/pen/		Uncommitted	Pen documents

	Imported Interfaces
	-------------------
	NAME		STABILITY		NOTES
	OpenSSL		External/Volatile	PSARC/2003/500

Reference Documents
===================
	[1] http://siag.nu/pen

	RFE ID# 6674372 for pen