# Configuration ##### **Instalation** Copy the plugin in the plugin directory of agent or distributing by file collections. Same with the config files. The execution from the agent will be similar to this, but using the paths where the plugin and confs are installed. ```bash module_plugin "\powershell.exe" -file C:\'\pandora_citrix.ps1' -perf C:\'\counters_data.txt' -serv C:\'\services.txt’ -inc C:\'\counters_inc.txt' 2> error.log ``` If we want no monitor any perf counter or only a specific type, would have to carry out these executions: - Only with generic\_data counters: ``` module_plugin "\powershell.exe" -file C:\'\pandora_citrix.ps1' -perf C:\'\counters_data.txt' -serv C:\'\services.txt' 2> error.log ``` - Only with generic\_inc counters: ``` module_plugin "\powershell.exe" -file C:\'\pandora_ citrix.ps1' -perf none -serv C:\'\services.txt' -inc C:\'\counters_inc.txt'' 2> error.log ``` - Without counters: ```bash module_plugin "\powershell.exe" -file C:\'\pandora_ citrix.ps1' -perf none -serv C:\'\services.txt' 2> error.log ``` - With counters and without services: ```bash module_plugin "\powershell.exe" -file C:\'\pandora_ citrix.ps1' -perf C:\'\counters_data.txt' -inc C:\'\counters_inc.txt' 2> error.log ``` **Configuration** First of all we have enabled the plugin execution from powershell For this, we must run this command in a powershell terminal: ```powershell set-executionPolicy -Scope Process -ExecutionPolicy Bypass ``` or ```powershell set-executionPolicy RemoteSigned ``` If we run the plugin from the terminal and returns the information correctly, but if you execute it in from Pandora agent and returns no results, and in debug mode tells us that remote\_signed not enabled, we should add the next module to be activated within the execution of the agent. This, you have to add only the first time, then stay enabled and we won´t have problems. ```powershell module_begin module_name Remote_signed module_type generic_data_string module_exec powershell.exe –command set-executionPolicy -Scope Process -ExecutionPolicy bypass module_end ``` or ```powershell module_begin module_name Remote_signed module_type generic_data_string module_exec powershell.exe -command set-executionPolicy RemoteSigned module_end ``` As we noted in the plugin implementation, it is accompanied by two or three configuration files, one with the name of the services and another two as the name of the performance counters to be monitored. At one we indicate the counters that we can see as generic\_data type and in the second we will use the incremental type (generic\_data\_inc). In the event that the incremental type is not used should not be added at runtime. Each service, each performance counter should be on one line and if If you do not want monitor any counter or service, delete it from the list. **Configuration files examples** *Services.txt* ```powershell Citrix Independent Management Architecture Citrix XML Citrix XTE Server Citrix CPU Utilization Management/Resource Management Citrix CPU Utilization Management/User Session sync Citrix CPU Utilization Management/CPU Rebalancer Services states Citrix Print Manager Citrix Virtual Memory Optimization Citrix MF COM Remote Desktop Services/Terminal Services Citrix WMI Citrix Client Network Citrix Streaming/Citrix Streaming Helper Server Netlogon Remote Procedure Call (RPC) Workstation Print Spooler ``` *Counters\_data.txt* ```powershell \Processor(*)\% Processor Time \System\Processor Queue Length \Memory\Available Bytes \Memory\Pages /sec \Paging File\% Usage \PhysicalDisk(_Total)\% Free Space \LogicalDisk(_Total)\% Free Space \LogicalDisk(_Total)\% Disk Time \PhysicalDisk(_Total)\Current Disk Queue Length \LogicalDisk(_Total)\Current Disk Queue Length \LogicalDisk(_Total)\ Avg. Disk Sec/Read \LogicalDisk(_Total)\ Avg. Disk Sec/Write \LogicalDisk(_Total)\ Avg. Disk Sec/Transfer \PhysicalDisk(_Total)\ Avg. Disk Sec/Read \PhysicalDisk(_Total)\ Avg. Disk Sec/Write \PhysicalDisk(_Total)\ Avg. Disk Sec/Transfer \Citrix MetaFrame Presentation Server\Application Resolution Time (ms) \Citrix MetaFrame Presentation Server\DataStore Connection Failure \Citrix MetaFrame Presentation Server\Number of busy XML threads \Citrix MetaFrame Presentation Server\Resolution WorkItem Queue Ready Count \Citrix MetaFrame Presentation Server\WorkItem Queue Ready Count \Citrix Licensing\Citrix Licensing - License Server Connection Failure \Citrix Licensing\Citrix Licensing - Last Recorded License Check - Out Response Time \Process(ImaSrv)\Private Bytes ```