NAME

App::Monupco::dotCloud - monupco.com registration agent for dotCloud / Perl applications

SYNOPSIS

To register your dotCloud Perl application to Monupco do the following:

1) Create a Perl application on dotCloud

2) Add a dependency in your Makefile.PL file

    PREREQ_PM => {
        'App::Monupco::dotCloud' => 0,
        ...
    },

3) Set your userID. You can get it from https://monupco-otb.rhcloud.com/profiles/mine/

    dotcloud var set <app name> MONUPCO_USER_ID=UserID

4) Enable the registration script in your postinstall hook. **Note:** If you are using an "approot" your `postinstall` script should be in the directory pointed by the "approot" directive of your `dotcloud.yml`. For more information about `postinstall` turn to http://docs.dotcloud.com/guides/postinstall/.

If a file named `postinstall` doesn't already exist, create it and add the following:

        #!/bin/sh
        /home/dotcloud/perl5/lib/perl5/App/Monupco/dotCloud.pm

5) Make `postinstall` executable

        chmod a+x postinstall

6) Then push your application to dotCloud

    dotcloud push <app name>

7) If everything goes well you should see something like:

        19:55:10 [www.0] Running postinstall script...
        19:55:13 [www.0] response:200
        19:55:13 [www.0] Monupco: Success, registered/updated application with id 34

That's it, you can now check your application statistics at <http://monupco.com>

DESCRIPTION

This module compiles a list of locally installed Perl distributions and sends it to http://monupco.com where you check your application statistic and available updates.

AUTHOR

Alexander Todorov, <atodorov()otb.bg>

COPYRIGHT AND LICENSE

 Copyright (c) 2012, Alexander Todorov <atodorov()otb.bg>

 This module is free software and is published under the same terms as Perl itself.