katello August 2011

katello@lists.fedorahosted.org

18 participants
9 discussions

Question on CLI usage - is there a wiki?
by Cliff Perry 29 Aug '11

29 Aug '11

I installed katello-cli but basic functions do not seem to work. Am I missing something obvious? :) I couldn't see any wiki instructions for usage. [root@dhcp77-198 ~]# rpm -qa | grep -i katello katello-0.1.70-1.git.24.0024b38.el6.noarch katello-cli-0.1.5-1.git.15.654a7df.el6.noarch [root@dhcp77-198 ~]# katello ping error: Missing credentials and unable to authenticate using Kerberos (more in the log file) [root@dhcp77-198 ~]# Thanks, Cliff

2 1

New sysvinit script: katello-jobs
by Lukas Zapletal 23 Aug '11

23 Aug '11

Hello, there is new sysvinit script katello-jobs in the Katello release 0.1.66-1. Keep this service up and running from now on, otherwise your CLI or UI can hang! For more info see: https://fedorahosted.org/katello/wiki/KatelloJobs == Service katello-jobs == The service is for executing background processes (synchronizations, promotions). If the service is not running, katello CLI and UI could possibly hang. === How to start it === {{{ service katello-jobs start }}} === How to configure it === See the {{{/etc/sysconfig/katello}}} configuration file: {{{ # number of katello-job service background workers #KATELLO_JOB_WORKERS=1 # additional katello-job service options for delayed_jobs #KATELLO_JOB_WORKERS=-m -p katello }}} === How to monitor it === See the {{{/var/log/katello/}}} directory: * jobs-startup.log -- startup daemon messages * production_delayed_jobs.log -- individual logs from workers Installation wiki page has been updated as well. -- Later, Lukas "lzap" Zapletal

4 10

No initdb command in katello startup script
by Lukas Zapletal 23 Aug '11

23 Aug '11

Hello, if you see this error: # service katello initdb Usage: /etc/init.d/katello {start|stop|restart|status} Please make sure you are not using version 0.1.65-1. The init script in this version is incorrect, because the RPM was not packaged correctly. Upgrade to the latest version (0.1.66-1+). -- Later, Lukas "lzap" Zapletal

2 2

Identity in Katello and Conductor
by Jan Provazník 19 Aug '11

19 Aug '11

Hi, there are two things we need for sharing user identity in Katello and Conductor: 1) Single sign on for Katello and Conductor: Simplest solution is using 2 legged oauth as proposed in a mail before (katello already uses this for accessing pulp and candlepin). In short: auth is done on application level by sharing secret token, provider app trusts consumer app that consumer already authenticated the user which it passes to provider. This solution should be pretty easy to implement. If this is not acceptable for some reason, we could consider using some central auth service (CAS). 2) Authenticate against same external service in Katello and Conductor: Katello and Conductor should support authentication against external auth service (AD, LDAP, IPA, maybe more). It makes sense to use same auth framework in both apps so we will be able to support same authentication methods. Katello is far before conductor in authentication, it uses warden and supports various auth strategies for it (LDAP, SSO over http headers, certificates). I heard there was some talk about switching to Omniauth, but I didn't find it on mailing list. So there are two options here: 1) conductor switches to warden - this shouldn't be so difficult as we can copy from Katello :). Also Omniauth is not packaged in Fedora, Warden is. 2) both Katello and Conductor switch to Omniauth. I'm not sure if this is required or optional step, Ken: you suggested switching to Omniauth, could you please reply with your opinion about warden/omniauth (or point me to older discussion)? Jan

7 13

Katello katello-0.1.61-1 installs to /usr/share/katello
by Lukas Zapletal 15 Aug '11

15 Aug '11

Hello, Since we do not provide any arch dependent code, we have changed the installation directory from /usr/lib64/katello to /usr/share/katello. Please update your scripts or environment variables, if you have any. It also means the reset dbs script is now located at: # /usr/share/katello/script/katello-reset-dbs Sorry for the intrusive change. Thanks. -- Later, Lukas "lzap" Zapletal

2 3

Screencast - How foreman can help provisioning your hosts
by Ohad Levy 14 Aug '11

14 Aug '11

http://www.youtube.com/watch?v=vqmsaQbY5Jw

1 0

Nice way to reset katello database
by Lukas Zapletal 10 Aug '11

10 Aug '11

Hi, in the current master we have a new script for cleaning katello, candlepin and pulp database. Please note it completely erase all data and re-initialize databases, after you reply with "yes". You have been warned. It will be available in the katello-0.1.59-1 soon. Example use: # /usr/lib64/katello/script/katello-reset-dbs *********************************************************** THIS SCRIPT WILL ERASE KATELLO / CANDLEPIN / PULP DATABASES *********************************************************** All data from all systems will be erased completely! It is strongly recommended to back up databases: # mongodump --db pulp_database --out - > pulp_database.json # pg_dump -c candlepin > candlepin_db.sql # pg_dump -c katello > katello_db.sql Are you sure you want to proceed (yes/no)? yes Erasing all data... Stopping Katello instance Stopping katello (via systemctl): [ OK ] Stopping Pulp instance Stopping pulp-server (via systemctl): [ OK ] Stopping Candlepin instance Stopping tomcat6: [ OK ] Dropping Pulp database Starting mongod (via systemctl): [ OK ] Initializing Pulp database data model in use matches the current version database migration to version 19 complete Initializing Candlepin database Dropping candlepin database Creating candlepin database Loading candlepin schema ** Skipping configuration file setup Certificates are already present. Waiting for tomcat to restart... Candlepin has been configured. Starting Pulp instance Starting pulp-server (via systemctl): [ OK ] Starting Candlepin instance status: unrecognized service start: unrecognized service Initializing Katello database ** Invoke setup (first_time) ** Invoke db:migrate:reset (first_time) ** Invoke db:drop (first_time) ** Invoke db:load_config (first_time) ** Invoke rails_env (first_time) ** Execute rails_env ** Execute db:load_config ** Execute db:drop ** Invoke db:create (first_time) ** Invoke db:load_config ** Execute db:create ** Invoke db:migrate (first_time) ** Invoke environment (first_time) ** Execute environment ** Execute db:migrate ** Invoke db:schema:dump (first_time) ** Invoke environment ** Execute db:schema:dump ** Execute db:migrate:reset ** Invoke db:seed (first_time) ** Invoke db:abort_if_pending_migrations (first_time) ** Invoke environment ** Execute db:abort_if_pending_migrations ** Execute db:seed ** Execute setup Starting Katello instance Starting katello (via systemctl): [ OK ] -- Later, Lukas "lzap" Zapletal

3 2

Could not find rake-0.9.0.beta.4 in any of the sources
by Lukas Zapletal 09 Aug '11

09 Aug '11

Hello, the current version katello-0.1.57-1.git.12.5461708.fc15.noarch has incorrect Gemfile.lock. The workaround is to: # cd /usr/lib/kalpana # rm -f Gemfile.lock # su katello -s /bin/bash -c "bundle install --local" # service katello restart We are working hard to fix this issue. -- Later, Lukas "lzap" Zapletal

1 0

Katello-Conductor-Factory-Warehouse interaction for 0.4.0 and beyond
by Hugh O. Brock 04 Aug '11

04 Aug '11

Hello all. We've had a lot of good discussion on the Aeolus list [1] about authorization and identity lately, and also about the intersection points of Aeolus and Katello. However I have been slow (sorry!) to suggest and update the requirements and user stories for this integration, and that has left folks asking a lot of questions about the features that are affected by that integration, in particular: * We will eventually need a UI for creating and managing templates, assemblies, and deployables -- where's that gonna go? * Precisely which components have to talk to each other securely in a system where Katello and Conductor work together? * Is there a need for an independent permission system in the Warehouse? What about an independent identity system? * One of the very cool features VCloud has is the ability to take a bunch of applications -- really, VM templates -- and put them in a "Catalog" that an admin can grant or revoke permission on for a set of users. The virtue of the catalog is that it gives admins an easy way to manage, say, "all the financial apps that are approved for production," or "the apps that are in testing this week." We need something like this for Aeolus, but how does it work exactly, and which part of the system owns it? I've been in a lot of meetings this week where we talked about these questions, so I'm going to propose some answers here based on that. There are a ton of unanswered questions as well, and I'm hopeful that Aeolus and Katello folks can help answer them here. (Katello folks, apologies for dumping a mostly-aeolus-centered design doc into your midst, but I thought you guys might want to know what we're thinking about too. Please feel free to comment on either or both lists.) 1. Template design and management ================================= (By "Template," I mean "Image templates, assembly definitions, and deployable definitions") We've had quite a bit of early user feedback asking, in no uncertain terms, for a nice GUI to let users define templates. We removed our nascent template definition UI from Conductor for the 0.3.0 release because it didn't feel right there, which I continue to think was the right idea, but there is clearly a need for such a GUI to exist somewhere. Fortunately, there is another project very close to Aeolus called Katello [2]. Katello's mission in life is allowing users to define bare-metal systems and manage their access to the software that should be provisioned on those systems. As such, it has as a core feature providing a UI for creating "System templates." I believe, and I think the Katello folks agree, that Katello users would benefit from being able to use it to define systems that will run in the cloud, as well as bare-metal systems. From there it's not a big leap to say that Katello users will want to define the entire range of templates that Aeolus can use and understand -- image templates, for stuff that gets built pre-boot; system templates (Katello) or assemblies (Audrey), for stuff that happens to a system post-boot; and application templates (Katello) or deployables (Audrey) for hooking systems together post-boot. Note that the last of these things -- application templates -- are also really useful for the bare-metal world. Given a set of system templates, and the ability to specify a set of systems that work together, it's not a big stretch to think that Katello users will want a way to provision and launch that set of systems -- an application -- either on a set of bare-metal machines, *or* in a cloud provided by Conductor. Of course, it will be some time before the Katello folks can design and build the whole UI for managing all three kinds of Aeolus templates and their interactions and dependencies. However, we don't have to wait for that to happen before we can start thinking about making Conductor and Katello work together. For release 0.4.0, I would think we could get by with the following features: * Katello provides an API that, given a user Katello knows about, will return all the Katello system templates that user has permission to see. (Note that templates in Katello are grouped by "environment," and that a user can have permission on more than one environment, so we'll have to deal with that hierarchy in the API somehow.) * The Aeolus team builds a UI piece in or next to Conductor will allow the user to: * map those templates to a catalog (more about this later) * map non-Katello templates (assemblies/deployables) to a catalog. For now this could be pretty much the same mechanism that our "Suggested Deployable" UI uses now -- store a URL of a deployable to use * Another UI piece, in or next to Conductor, will allow a user to: * map a catalog to a pool * check to see if the templates in that catalog have been built into images that have been pushed to the cloud provider accounts that the pool has access to * ask the Image Factory to build and push any templates that have *not* been built in the available accounts * display the status of the build(s) Somewhere in this process a translation step between the Katello system template and the Factory image template will need to happen. I don't particularly care where that step is. And it's important to note that eventually we will be passing Katello image templates to Factory, not Katello system templates -- hacking up the system template to get an image definition out of it is a temporary first step. I also think that in general, we should not be importing the actual template into a catalog, but rather just importing a reference to it so that we don't have duplicate copies of templates floating around. I'm willing to be argued out of this however. Some folks I talked to on the Katello side wondered if they should be able to tell something on the Aeolus side "Build this thing right now." I'm willing to say Conductor should provide a convenience API to do this, but it's important to note that Katello would need to be able to tell Conductor what pool (and hence what cloud providers) it wants the image built for, and provide a user who is authorized to push images to those providers. (One thing I notice as I write this is that we are going to need to pass user identity around fairly soon to accomplish this, which makes me think a central identity store is probably a firmer requirement for 0.4.0 than I initially thought.) So if we take the above feature list as "good enough" for 0.4.0, what does that tell us about who needs to talk to whom? 2. Secured communications ========================= I said above that we will have some UI in a catalog manager that hits a Katello API to retrieve all the system templates a user is allowed to see. For that to work, we're going to need to be able to give Katello a user; and for that to work, we're going to need a common identity store. Whether any of it is encrypted or not for this go-round is not terribly important I don't think, although of course it will have to be for production. I also said that the catalog manager will need to ask the Factory to build images for a set of cloud provider accounts. So there is going to have to be a channel to do that. However, I do not see anywhere here a user story that would require the catalog manager to act *on behalf of a user*; Conductor has already checked to see if the building user is allowed to build and push to the set of cloud provider accounts for the given pool. So I don't think the Factory needs to know anything about identity -- and, in fact, I don't think it really matters if non-Conductor users call the Factory and ask it to do stuff. Without the cloud provider account credentials, which are locked up in Conductor, there shouldn't be anything the user can do with the Factory that is harmful. Finally, I implied (without really saying so) that Conductor, or the catalog manager wherever that lives, needs to read information about the state of images from the warehouse, and push images to the warehouse. This means there will need to be a channel between the catalog manager and the Warehouse. However, I do not see anywhere here a user story that would require the catalog manager to talk to the Warehouse *on behalf of a user* - the ability to push, update, or launch images is all governed by Conductor's control of the cloud provider account credentials, so I don't think there is any reason for the Warehouse to have a notion of images belonging to users, or any understanding of user identity. Note that THIS IS A BIG CHANGE from what I and others have said in the past, but it does simplify what we have to do in the short term quite a bit. I believe the remaining secured communications -- between Conductor and Deltacloud, Conductor and Audrey, etc. -- are well enough understood that I don't have to discuss them here. So, to sum up: * Conductor (and its catalog manager) and Katello need to share user identity, and fairly soon * Conductor and Factory and Warehouse do not need to share user identity * In fact, Conductor and Katello are the *only* two components in this system that need to share identity. I realize I've just answered my third question above, about whether the Warehouse needs to know anything about authentication or authorization. I believe the answer is no. 3. Catalogs =========== Although my first thought about catalogs as a feature was "I guess we're doing this just because VMWare has them and we need to check the feature complete box," the more we talked about the feature the more I began to see it as a useful thing. Things administrators can do with catalogs: * For now, group image templates into a catalog; eventually, group application templates into a catalog * Connect catalogs to pools, making it possible for users to run the applications in the catalog * Check that the images that the applications in a catalog depend on, have been built for the cloud provider accounts connected to a pool, so that it is possible to launch the applications. * Disconnect catalogs from pools. Maybe, also remove images that are no longer referenced by an application that is connected to a pool. So from a user story perspective, you can imagine that an administrator, on creating or maintaining a pool, would be able to browse catalogs of applications to add to that pool. On adding the catalog to the pool, the admin would be able to check to make sure the images required by the apps in that catalog are built for all the provider accounts the pool has access to. The users of that pool would gain the ability to launch the listed applications. I would like to see the design activity for catalogs, and hopefully UX and wireframes, done soon. It would be really good to have a super-simple (just system templates) implementation by the 0.4.0 release. All right. That was long. I'll be waiting to hear how wrong I am from the assembled multitude. Please be thorough. Thanks, --Hugh [1] aeolus-devel(a)fedorahosted.org [2] http://katello.org -- == Hugh Brock, hbrock(a)redhat.com == == Engineering Manager, Cloud BU == == Aeolus Project: Manage virtual infrastructure across clouds. == == http://aeolusproject.org == "I know that you believe you understand what you think I said, but I’m not sure you realize that what you heard is not what I meant." --Robert McCloskey

7 16

2026

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

katello August 2011