The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

agni - commandline access to the PApp!Agni System.

SYNOPSIS

   Usage: /opt/bin/agni ...

      --file <file>                 write output to file or read input from file
      --daemon                      go into daemon mode
      -i | --interval <seconds>     sleep interval for daemon mode
      --export-path path            write path to file (or stdout)
      --import-path path            import path from file
      --import-ignore-type gid      on import, ignore these attributes

      --load-image <file>           load a saved backup file <file>
      --save-image <file>           save a backup file <file>
      --clear-database              delete all objects and paths

      --force                       force import even on gidseq mismatches

      --gar                         starts garbagecollector

      --paths                       show paths
      --newpath <path>              creates a new path
      
      -e | --exec-cmd path command  executes a command as defined in util::cmdline
                                    path specifies the path to the object.

DESCRIPTION

agni works as a shell interface to the PApp!Agni System.

OPTIONS

--file file

write output to file or read input from file

Daemon Mode

--daemon

go into daemon mode

-i | --interval seconds

sleep interval for daemon mode

Handling ex/import of data from a specific path

--export-path path

write path to file (or stdout)

--import-path path

import path from file

--import-ignore-type gid

on import, ignore all attributes of the given type (they will not be imported). this only ignores the attributes - the corresponding type object will be imported if present.

Handling whole images for backup purposes

--load-image file

load a saved backup file file

--save-image file

save a backup file file

--force

import objects even if there is a gidseq mismatch

--gar

starts garbagecollector

--paths

show paths

--newpath path

creates a new Bpath

-e, --exec-cmd path command

executes a command as defined in util::cmdline path specifies the path to the object.

 agni -e root/agni/ help (-v)

gives you a list of available commands.

EXAMPLES

Exporting Data from your applications data path

        agni --file /tmp/config.xml --export-path root/agni/staging/data/

After executing this command you can find a dump of all the objects from the agni-path root/agni/staging/data/ (don't forget the trailing slash!) in the file /tmp/config.xml. Beware though: agni applications usually reside in separate paths from their data!

Importing Data to an application path

        agni --file /tmp/config.xml --import-path root/agni/staging/data/

This command imports the data that we previously exported back into agni with the same path information.

Exporting whole images for backup purposes

        agni --save-image /backuppath/backup.xml

This exports a complete backup of the running system to an image file /backuppath/backup.xml.

Please take into account that some distributions clear their tmp directories after a reboot and thereby render /tmp an unwise choice for the backup directory!

Importing the previously created backup

        agni --load-image /backuppath/backup.xml

This command imports the previously saved image into agni, overwriting all existing data.

Executing a command inside agni

        agni -e root/agni/staging/data/ call ra/settings::class ra_upgrade

This command calls a method in object ra/settings::class, agni-path root/agni/staging/data/ called ra_upgrade. Use this feature with caution!

To give the method call arguments simply write them on the command line:

        agni -e root/agni/staging/nethype_data/ call mercury_nethype/report::own_summary summary 0 2141167600

This calls the summary method on the report::own_summary object with the two arguments 0 and 2141167600 (unix timestamps btw.).

COPYRIGHT

Copyright (C) 2003,2004 nethype GmbH, Franz-Werfel-Str. 11, 74078 Heilbronn.

This Program is part of the PApp!Agni Distribution. Usage requires a valid license.

AUTHOR

Marc Lehmann <marc@nethype.de>, Marco Maisenhelder <marco@nethype.de>, http://www.nethype.de/agni