diff --git a/pandora_agents/win32/ChangeLog b/pandora_agents/win32/ChangeLog index 5383ca394d..3461fae86e 100644 --- a/pandora_agents/win32/ChangeLog +++ b/pandora_agents/win32/ChangeLog @@ -1,3 +1,9 @@ +2006-07-05 Esteban Sanchez + + * bin/README.txt: Added to repository. + + * pandora.h: Service name renamed. + 2006-07-05 Esteban Sanchez * windows/pandora_wmi.cc: Removed unnecessary debug. Check the service state on isRunningService () @@ -23,8 +29,6 @@ * modules/pandora_module_list.cc: Removed use of namespace and use a explicit specification. - * Changelog: Renamed to ChangeLog. - 2006-07-04 Esteban Sanchez * windows/pandora_wmi.*, windows/pandora_windows_info.*, windows/wmi/disphelper.*, diff --git a/pandora_agents/win32/bin/README.txt b/pandora_agents/win32/bin/README.txt new file mode 100644 index 0000000000..380ac4e7bc --- /dev/null +++ b/pandora_agents/win32/bin/README.txt @@ -0,0 +1,85 @@ +==== WARNING ==== + +This binary files should only be used in testing and not in a stable system. We are +not responsable of the damage it can provoke. + +==== WARNING ==== + + +== Pre-installation == + +Before running or installation of Pandora Windows agent, you must create the +configuration directory and extract the PandoraBin.zip file into it. + +It does not matter where it is installled, because Pandora Agent will +adapt to any local directory. This directory should have this content: + +\pandora_agent.conf :: Pandora Windows Agent main configuration +\key\ :: Directory which holds the private and public key files +\key\id_dsa :: Private key to access the Pandora server using SSH +\key\id_dsa.pub :: Public key to access the Pandora server using SSH + +Optionally, it could have: + +\utils\ :: Directory where the user could put misc utils to use + whith modules exec type. I.e. UNIX-like tools (cut, + grep, etc...) + +== Installation == + +Notice: At this moment, the installation of the Pandora Windows Agent must + be done manually. + +To install the Pandora Windows Agent execute this sentence in a Windows command +line: + + PandoraAgent.exe --install + +The Agent will be installed into the Windows services system. You can check it +on Control Panel -> Administrative tools -> Services. + +To run the Agent open the "Services" dialog (Control Panel -> Administrative +tools-> Services), search the "Pandora Agent" service and run it clicking the +play button. + +To stop the service, open the "Services" dialog, search the "Pandora Agent" and +click the stop button. + +To uninstall the Pandora Windows Agent, execute this sentence in a Windows +command line: + + PandoraAgent.exe --uninstall + + +== Output == + +You can check the Pandora Windows Agent output in the +C:\Pandora\pandora-debug.dbg file, that is a plain text file and includes info +about the execution flow of the Agent. + + +== Configuration files == + + * pandora_agent.conf + + This file is a list of keys/values pairs. Here is an example of this file. + + # Begin of pandora_agent.conf example + # The comments begin with the '#' character + # IP of the Pandora server + server_ip 192.168.50.1 + # Remote path to copy the data + server_path /opt/pandora/data_in/ + # Local path to the temporal directory + temporal "C:\temp files" + # Interval between executions (in minutes) + interval 5 + # Name of the agent + agent_name antiriad + # End of pandora_agent.conf example + + * id_dsa, id_dsa.pub + + These files must be generated using SSH utils and the Pandora server must + be configured to allow accessing the Pandora user ("pandora" by default) + using this pair of public/private keys. diff --git a/pandora_agents/win32/pandora.h b/pandora_agents/win32/pandora.h index b6f50dd5be..8e204d3eef 100644 --- a/pandora_agents/win32/pandora.h +++ b/pandora_agents/win32/pandora.h @@ -44,7 +44,7 @@ namespace Pandora { static const HKEY hkey = HKEY_LOCAL_MACHINE; const char * const name = "PandoraService"; const char * const display_name = "Pandora service"; - const char * const description = "The Pandora agents service"; + const char * const description = "The Pandora Agent service"; void setPandoraInstallDir (string dir); string getPandoraInstallDir ();