[katello-devel] Katello Apache+Thin changes : merged to master (thin remote branch)

Fri Sep 9 23:10:33 UTC 2011

On 09/09/2011 10:20 AM, Brad Buckingham wrote:
> On 09/09/2011 10:13 AM, Cliff Perry wrote:
>> On 09/09/2011 10:03 AM, Brad Buckingham wrote:
>>> Correction to URL below.
>>>
>>> On 09/09/2011 09:55 AM, Brad Buckingham wrote:
>>>> Team,
>>>>
>>>> I have just merged the thin remote branch in to master.  I have also
>>>> created a tag (katello-0.1.79-1) and initiated builds.
>>>>
>>>> With this merge, Katello will now be using the Apache web server and
>>>> Thin app server.  (Apologies in advance for this being a long email...
>>>> :))
>>>>
>>>> The following are a few key notes to be aware of:
>>>>
>>>> Production Environment:
>>>>
>>>> - Access Katello: https://katello.server.com/katello
>>>>      - NOTE: 'katello' added to basepath for the service.  This 
>>>> applies
>>>> to both UI and API requests.
>>>>      - katello requests will now go through Apache web server to 
>>>> any of
>>>> 4 Thin app servers
>>>>      - Apache will round-robin balance the requests sent to Thin 
>>>> servers
>>>>      - Apache will directly service static assets such as images,
>>>> fonts, CSS...etc
>>>>
>>>> - service katello start / service katello stop:
>>>>      - These commands no longer start and stop a 'rails' process.
>>>> Instead, they will start/stop 4 thin
>>>> processes that service the katello requests.
>>>>
>>>> - key configuration file changes:
>>>>      /etc/httpd/conf.d/katello.conf (new)
>>>>      /etc/init.d/katello (updated)
>>>>      /etc/sysconfig/katello (updated)
>>>>
>>>>      /etc/katello/thin.yml (new)
>>>>      /etc/katello/katello.yml (updated - no longer specify ssl here)
>>>>
>>>> - key log file changes:
>>>>      /var/log/katello/thin-log.[pid].log ->  new logs created for thin
>>>> startup
>>>>      /var/lib/katello/tmp/pids/thin.[pid].pid ->  new files containing
>>>> the thin process ids
>>>>      /var/log/httpd/ssl_kt_access_log ->  apache access log for 
>>>> katello
>>>>      /var/log/httpd/ssl_kt_error_log ->  apache error log for katello
>>>>      Debug output continues to go to /var/log/katello/production.log
>>>>
>>>> - There is very little impact to the installation procedure; however,
>>>> refer to the installation wiki for details.  Ref:
>>>> https://fedorahosted.org/katello/wiki/Install
>>>>
>>>> Development Environment
>>>>
>>>> - need to install the rubygem-thin package and update katello package
>>>> (based on katello-0.1.79-1)
>>>>
>>>> - starting katello: refer to:
>>>> https://fedorahosted.org/katello/wiki/Install/GettingupandRunningGIT
>>> Corrected URL:
>>> https://fedorahosted.org/katello/wiki/Install#GettingupandRunningGIT
>>>> - several scripts from src/extras to src/deploy.  this includes things
>>>> like katello-jobs.init, katello.init, katello.conf, thin.yml...etc
>>>>
>>>> - recommended code conventions for UI (to ensure URL prefixing
>>>> continues to work in the future :)):
>>>>      https://fedorahosted.org/katello/wiki/URLCodeConventions
>>>>
>>>> Other notes:
>>>>
>>>> - CLI - in order to support the /katello prefix, it must be specified
>>>> in the client.conf 'path' variable.  This has been updated in GIT;
>>>> however, if you are running from your own version, you will need to
>>>> update it.
>>>>
>>>> - script/rails - this script has been removed.  Developers should
>>>> instead be using script/thin as noted in install wiki.
>>>>
>>>> - scripts/test/fake-system.sh - this script has been removed.
>>>> Instead, we recommend using the new scripts/test/bulk-load-katello.py
>>>> script for generating dummy systems (as well as orgs, providers,
>>>> products and repos)
>>>>
>>>> Known Issues:
>>>>
>>>> - Search is not currently functioning... We are currently working on
>>>> that and should have it resolved soon...
>>>>
>>>> As you begin using Apache and Thin, please watch for any errors that
>>>> may be reported in Firebug or broken links.  In order to support this
>>>> configuration, we did have to change code in several places for things
>>>> like images, fonts, URLs...etc and it is possible that we may have
>>>> inadvertently missed some in order to test you. :)
>>>>
>>>> If there are any questions or concerns, please let us know.
>>>>
>>>>
>>>> thanks,
>>>> Brad&  Mike
>>>>
>>>> _______________________________________________
>>>> katello-devel mailing list
>>>> katello-devel at redhat.com
>>>> https://www.redhat.com/mailman/listinfo/katello-devel
>>> _______________________________________________
>>> katello-devel mailing list
>>> katello-devel at redhat.com
>>> https://www.redhat.com/mailman/listinfo/katello-devel
>>
>> Has the public wiki installation pages changed to reflect this change?
>> or nothing required?
>>
>> Thanks,
>> Cliff
> Hi Cliff,
>
> The public wiki installation page has been updated; however, the 
> changes are very minor in nature.  From a production point of view, 
> the procedure is essentially identical; however, some notes were added 
> to the wiki.
>
> The install page can be found at:
> https://fedorahosted.org/katello/wiki/Install
>
> The initial delta to the page can be viewed at:
> https://fedorahosted.org/katello/wiki/Install?action=diff&version=62
>
> That said, I'm sure we'll be adding more details to the wiki as folks 
> begin using the new configuration.
>
> thanks,
> Brad
>
> _______________________________________________
> katello-devel mailing list
> katello-devel at redhat.com
> https://www.redhat.com/mailman/listinfo/katello-devel

Developers,

As more folks have begun using the new configuration using thin today, 
we found that those using RubyMine were unable to start the application 
within the IDE.  In addition, we found that rails console was no longer 
working.

We have since pushed a couple of small commits to address these issues.  
These commits do impact how a developer will start the application, so 
we have also updated the install wiki to reflect those details.  Ref: 
https://fedorahosted.org/katello/wiki/Install#GettingupandRunningGIT

The 2 commits were:
http://git.fedorahosted.org/git/?p=katello.git;a=commit;h=83ef7a964b553c631c684fc6a1ff828b78c1b204
http://git.fedorahosted.org/git/?p=katello.git;a=commit;h=15131b7d33e74214d658ed131243dd51371b38c6

Summary:

To start Katello using the /katello prefix and the thin app server, we 
recommend the following:
     (Note: use script/rails vs script/thin)

   RAILS_RELATIVE_URL_ROOT=/katello script/rails server thin

Cheers,
Brad