Starman-ModCluster

 view release on metacpan or  search on metacpan

MANIFEST  view on Meta::CPAN

Changes
Makefile.PL
MANIFEST
README
t/Starman-ModCluster.t
lib/Starman/ModCluster.pm
lib/Starman/Server/ModCluster.pm
lib/Plack/Handler/Starman/ModCluster.pm
bin/starman-modcluster
META.yml                                 Module YAML meta-data (added by MakeMaker)
META.json                                Module JSON meta-data (added by MakeMaker)

Makefile.PL  view on Meta::CPAN

use 5.008_001;
use ExtUtils::MakeMaker;
# See lib/ExtUtils/MakeMaker.pm for details of how to influence
# the contents of the Makefile that is written.
WriteMakefile(
    NAME              => 'Starman::ModCluster',
    VERSION_FROM      => 'lib/Starman/ModCluster.pm', # finds $VERSION
    EXE_FILES		  => ['bin/starman-modcluster'],
    PREREQ_PM         => {
    	'Net::MCMP' => 0,
 		'Starman'	=> 0,
 		'IO::Socket::Multicast' => 0,
 		'IPC::Shareable' => 0,
 #		'Config::General' => 0,
    }, # e.g., Module::Name => 1.1
    ($] >= 5.008 ?     ## Add these new keywords supported since 5.008
      (ABSTRACT_FROM  => 'lib/Starman/ModCluster.pm', # retrieve abstract from module
       AUTHOR         => 'Roman Jurkov <winfinit@cpan.org>') : ()),

bin/starman-modcluster  view on Meta::CPAN

WARN
}

$runner->set_options(argv => \@argv);
$runner->run;

__END__

=head1 NAME

starman-modcluster - Starman launcher with mod_cluster support

=head1 SYNOPSIS

  starman-modcluster --mc-node-name=MyApp1 --mc-uri=http://127.0.0.1:6666 --mc-context="/myapp" --mc-alias="myapp1" --mc-host=127.0.0.1 

=head1 OPTIONS

=over 4

=item --mc-uri (required)

	--mc-uri http://modclusterserver1.example.com:6666,http://modclusterserver2.example.com:6666
	
mod_cluster address

bin/starman-modcluster  view on Meta::CPAN

Max time httpd will wait for the backend connection. (Defaults to 0, no timeout)

=item --mc-debug (optional)

	--mc-debug 1

Display L<Net::MCMP> debug information, and show configuration options of mod_cluster in the logs.

=item Other Options

Other options are available as described in L<starman> and L<plackup>

=back

Starman::ModCluster passes through other options given to L<Starman> and L<Plack::Runner>, the
common backend that L<starmna> and L<plackup> uses, so the most options explained in
C<plackup -h> such as C<--access-log> or C<--daemonize> works fine in
starman-modcluster too.

=cut

=back

=head1 SEE ALSO

L<starman> L<Starman> L<plackup>

=cut

lib/Plack/Handler/Starman/ModCluster.pm  view on Meta::CPAN

Plack::Handler::Starman::ModCluster - Plack adapter Starman::ModCluster

=head1 SYNOPSIS

  plackup -s Starman::ModCluster --mc-node-name=myapp1 --mc-uri=http://127.0.0.1:6666 --mc-context="/myapp" --mc-alias="localhost" --mc-host=127.0.0.1


=head1 DESCRIPTION

This handler exists for the C<plackup> compatibility. Essentially,
C<plackup -s Starman::ModCluster> is equivalent to C<starman-modcluster --preload-app>,
because the C<starman-modcluster> executable delay loads the application by
default. See L<starman-modcluster> for more details.

=head1 AUTHOR

Roman Jurkov

=head1 SEE ALSO

L<Starman::ModCluster>

=cut

lib/Starman/ModCluster.pm  view on Meta::CPAN

=for stopwords

=head1 NAME

Starman::ModCluster - mod_cluster extension to Starman web server

=head1 SYNOPSIS

  # Run app.psgi with the default settings
  > starman-modcluster --mc-uri=http://127.0.0.1:6666 --mc-context="/app" --mc-alias="localhost" --mc-host=127.0.0.1

Read more options and configurations by running `perldoc starman-modcluster` (lower-case s).

=head1 DESCRIPTION

Starman::ModCluster is an extension to a Starman web server that allows an application to register with
mod_cluster (httpd module), and that permits one to have dynamic load balancing.

=over 4

=item UNIX only

This server does not support Win32.

=back

=head1 OPTIONS	

For launcher and all of the options please refer to L<starman-modcluster>

=head1 SUPPORT

Please report all bugs via github at
https://github.com/winfinit/Starman-ModCluster/issues

=head1 AUTHOR

Roman Jurkov E<lt>winfinit@cpan.orgE<gt>

lib/Starman/Server/ModCluster.pm  view on Meta::CPAN

=for stopwords

=head1 NAME

Starman::Server::ModCluster - extension to Starman::Server that registers pre_server_close_hook and 
pre_loop_hook of Net::Server to register and remove node from a cluster.


=head1 DESCRIPTION

This module is not intended to use directly. It should be used via L<starman-modcluster> command


=head1 SEE ALSO

L<starman-modcluster> L<Starman>

=head1 AUTHOR

Roman Jurkov, E<lt>winfinit@cpan.org<gt>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2014- by Roman Jurkov

This library is free software; you can redistribute it and/or modify