wiki:Installing
Last modified 4 months ago Last modified on 12/20/13 00:58:38

Installing Publican source on Fedora 19+ or RHEL 6

NOTE: These procedure assume you have set-up your RPM packaging environment, if you haven't please read Creating Package How To before beginning.

  1. Install wkhtmltopdf and its QT dependency. On a 64-bit Fedora 19 system, run:
    $ wget http://jfearn.fedorapeople.org/wkhtmltopdf/f19/x86_64/wkhtmltopdf-0.10.0_rc2-8.fc19.x86_64.rpm
    $ wget http://jfearn.fedorapeople.org/wkhtmltopdf/f19/x86_64/wkhtmltopdf-qt-4.8.0-6.git20111107.fc19.x86_64.rpm
    $ sudo yum localinstall --nogpgcheck wkhtmltopdf-0.10.0_rc2-8.fc19.x86_64.rpm wkhtmltopdf-qt-4.8.0-6.git20111107.fc19.x86_64.rpm
    
  2. Checkout the source:
    $ git clone git://git.fedorahosted.org/publican.git 
    
    Alternatively, if you have an account in the Fedora Account System (FAS) and have commit rights to Publican:
    $ git clone ssh://git.fedorahosted.org/git/publican.git 
    
  3. Change into the directory that holds the Publican trunk:
    $ cd publican
    
  4. Read the README
  5. Install build dependencies. Run:
    $ sudo yum-builddep publican.spec
    
    Note: On a newly-installed system, this command installs over 100 packages. If you already have a recent version of Publican installed on the system, you already have most of these packages.
  6. Set up the Publican build script. Run:
    $ perl ./Build.PL
    
  7. Build and install Publican:
    $ ./Build local
    
    Note: this step uses sudo to install the rpm.

Upgrading to a new development version

  1. Change into the publican directory that you previously checked out and clean up existing temporary files:
    $ ./Build realclean
    
  2. Download the latest version of the source:
    $ git pull
    
  3. Set up the Publican build script:
    $ perl ./Build.PL
    
  4. Build and install Publican:
    $ ./Build local
    
    Note: when you run ./Build local, you might see the following warning:
    Warning: Build.PL has been altered.  You may need to run 'perl Build.PL' again.
    

If you see this warning, run ./Build realclean, then run perl Build.PL, and then run ./Build local again.

Downgrading your installation

To revert to the stable version of publican, run:

$ sudo yum downgrade publican