bcfg2-admin pull tracebacks and sparse documentation

[m4z <[email protected]…>]

(This is version 1.0.1)

When called without or with too few arguments, bcfg2-admin pull cries.

chaos:~ # bcfg2-admin pull
Traceback (most recent call last):
  File "/usr/local/bin/bcfg2-admin", line 78, in <module>
    main()
  File "/usr/local/bin/bcfg2-admin", line 70, in main
    mode(args[1:])
  File "/usr/local/lib/python2.6/site-packages/Bcfg2/Server/Admin/Pull.py", line 46, in __call__
    self.PullEntry(gargs[0], gargs[1], gargs[f5e4281313ff9004be488e420f90d5fe413bb5c1] (SVN r2))
IndexError: list index out of range

chaos:~ # bcfg2-admin pull chaos
Traceback (most recent call last):
  File "/usr/local/bin/bcfg2-admin", line 78, in <module>
    main()
  File "/usr/local/bin/bcfg2-admin", line 70, in main
    mode(args[1:])
  File "/usr/local/lib/python2.6/site-packages/Bcfg2/Server/Admin/Pull.py", line 46, in __call__
    self.PullEntry(gargs[0], gargs[1], gargs[f5e4281313ff9004be488e420f90d5fe413bb5c1] (SVN r2))
IndexError: list index out of range

chaos:~ # bcfg2-admin pull chaos foo
Traceback (most recent call last):
  File "/usr/local/bin/bcfg2-admin", line 78, in <module>
    main()
  File "/usr/local/bin/bcfg2-admin", line 70, in main
    mode(args[1:])
  File "/usr/local/lib/python2.6/site-packages/Bcfg2/Server/Admin/Pull.py", line 46, in __call__
    self.PullEntry(gargs[0], gargs[1], gargs[f5e4281313ff9004be488e420f90d5fe413bb5c1] (SVN r2))
IndexError: list index out of range

chaos:~ # bcfg2-admin pull i have no clue
Unable to build entry. Do you have a statistics plugin enabled?

It would be nice if it displayed required parameters and an usage example instead.

The last is also true for the man page: If I wear my newbie hat, I have no idea what <entry-type> and <entry-name> could be. There are examples in QuickStart2 that helped me figure it out, but it would be nice not to have to rely on a machine with internet access.

[m4z <…>]

Somewhat related...

Another doc issue with [QuickStart2]: It is (afaik) the only place where an example usage of "bcfg2-admin pull" is used, and it is mentioned that the items are "pulled out of the statistics", but there is no explanation that statistics need to be explicitly enabled or how to do so.

So, for completeness:

• add "Statistics" to the "Plugins" line of bcfg2.conf and restart the server

• after a client has run (for example, with "bcfg2 -enqv"), the server has all the clients data and you can use "bcfg2-admin pull <client-name> <entry-type> <entry-name>" (like in the example in [QuickStart2]).

Because I didn't have the time to look into it yet, I'm still a bit clueless about what entry-types are possible - will pulling an entry-type "Package" create a Package entry somewhere? Will it not work at all?

Also, bcfg2-admin pull should be a bit more verbose.

chaos:~ # bcfg2-admin pull someclient.example.org Package python-devel
Got wrong numbers of matching generators for entry:[]

Does this mean I'm using it wrong (because you can't pull Package entries OR because in this one case something is wrong with the package) or something I didn't cause is wrong?

[m4z <…>]

Replying to m4z <[email protected]…>:

So, for completeness:

• add "Statistics" to the "Plugins" line of bcfg2.conf and restart the server
  

• after a client has run (for example, with "bcfg2 -enqv"), the server has all the clients data and you can use "bcfg2-admin pull <client-name> <entry-type> <entry-name>" (like in the example in [QuickStart2]).

That is wrong, mea culpa. Now that I have a way to push stuff with solj's help, I'll try to update/expand the docs about the Stats/Reports? and Pulling over the next few weeks.

[m4z <…>]

Another thing: bcfg-admin pull only seems to work *after* you have at least one version of the config in your repository. So for example in cases where you have no direct ssh/scp option between server and client and want to include your client on the server, pull does not help you. You still have to get the (initial) configs to the server somehow.

A quick hack *might* be to create the directory structure and an empty/short file on the server and then pull the real config, but I have not tested this. (Only creating the directory structure does not work).

[solj]

It looks like this is fixed in trunk:

[[email protected]] ~ # bcfg2-admin pull
Integrate configuration information from clients into the server repository

bcfg2-admin pull [-v] [-f][-I] [-s]<client> <entry type> <entry name>

[[email protected]] ~ # bcfg2-admin pull test
Integrate configuration information from clients into the server repository

bcfg2-admin pull [-v] [-f][-I] [-s]<client> <entry type> <entry name>

[Thomashinc]

test, test, simply test )