I would like to introduce you to a relatively new tool to your Citrix Cloud Platform management toolbox.
Add Meet the doctor. CCPDoctor or "The Doc", as I like to refer it-is a powerful tool that can highlight potential problems in your Cloud Platform environment.
The Doc works on all major lines of code (the time of writing, 3.0.7, 4.2.1, 4.3, 4.5 and 4.7 will soon be released). It also comes with some sweet features baked into certain annoying administrative tasks a breeze.
I'll be a few core functions and dive look into a really cool feature to cover that all should make life easier for the administrator. It begins to download all of the CCPDoctor utility, unzip, and that the latest, by having Update.
Here are the steps that you get there.
wget http://ccpdoctor.com/CCPDoctor-latest.zip
unzip CCPDoctor-latest.zip
cd CCPDoctor
./CCPDoctor.pl -update
[you’ll need to accept the license agreement before proceeding]
now that we have the latest version of the Doc up and running, I'll walk you through two of the most popular features in CCPDoctor utility. is first used to diagnose potential problems with-in your Cloud Platform deployment. This is achieved by doing the following:
./CCPDoctor.pl -troubleshoot
or use short -t
Issue .:
[root@ms-node] # ./CCPDoctor.pl -t
Cloud Platform doctor [1.12] [Read only] [06-Oct-2015 02:44AM PDT]
log file: / var / log / Cloud / management / CCPDoctor.log
========== verification Cloud Platform management Server version 4.2.1 ==========
OK: No new updates were found CCPDoctor (online version : 1:12 Local version: 1.12)
OK: integration.api.port is zero,
disabled on this system access unauthenticated admin Cloud Platform ... snip ...
ERROR: The configuration file Java process heap -Size below the recommended 8Gb (about half the total memory)
defined as -Xmx2g that will be unstable, go This will lead to slower reactions and the environment is forward when the resources in the cloud has increase.
to fix this, edit and change /etc/cloudstack/management/tomcat6.conf -Xmx2g to -Xmx8g, and add also the parameters -Xms8g
After changing it, they start the Management Service for this to accept ( '# service CloudStack management-stop "then start)
-OR-
Run.' ./CCPDoctor.pl --troubleshoot --fix memory.sh 'or' ./CCPDoctor.pl - troubleshoot --fix all 'next potential problems to fix this (remember, start management service in order for the changes to take effect) automatically
here the output for test OK shows that patterning have passed, warning and error referred Known issues. with eRROR and wARNING cases you will help text explains the problem, impact, and obtained as to rehabilitate. These problems can be set manually and some have an option where the doctor for you automatically can fix. another cool aspect of the auto fix feature is that you tell the doctor can fix a specific issue or have the doctor to fix all the problems it has revealed. Demonstrated below:
./CCPDoctor.pl --troubleshoot --fix memory.sh
or
./CCPDoctor.pl --troubleshoot --fix all
another common use for the physician is to carry out the tuning. Tuning will point common performance enhancements, you could take various setup changes achieved.
./CCPDoctor.pl -tune
... Sample Output ...
WARNING: There are data older than 0 days that could be cleaned up
this cleanup to improve the overall system performance
older data can be cleaned using the following SQL commands:
... snip ...
Please make sure to back up your database to take before the application of
- oR -
Run "./CCPDoctor.pl --tune --fix old_usage.py" or "./CCPDoctor.pl - melody --fix all" to fix them automatically.
In the same manner as troubleshooting designated starting with OK and Warning to see. Warnings are accompanied by helpful text, which will lead to the proposed tuning changes and how they are intended to influence the system. Similar to fix, you can have the doctor fix specific issues or all. There will be some problems, the doctor can not automatically fix, as they could make access to a remote machine configuration file required ... in this case, instructions will help you perform to address the problem.
Now for my favorite feature, because really, if you can automate tasks numbing time-consuming brain, it is a win ... and that's the Collect Logs feature. Not only can the doctor access relevant log files, it can also add database dumps. The real magic occurs when a case ID, including, if it was submitted an incident with assistance. CCPDoctor can automatically log files to upload, and they collect your support case. More "win" icing party add logs can be automatically collected by the system VMs. No more fumbling with passwords and hosts hopping, ssh'ing and scp'ing protocols at intermediate locations to have only compress and upload your own ... one by one. CCPDoctor does so with a few more keystrokes
collect use
Example protocols include .:
./CCPDoctor.pl --collectlogs
or shorthand with
./CCPDoctor .pl -c
[root@ms-node] # ./CCPDoctor.pl --collectlogs
Cloud Platform doctor [1.12]
fileLocation log: / var / log /cloudstack/management/CCPDoctor.log
=============== collecting MS logs ================
OK: No new CCPDoctor updates were (online version: 1.12 Local version: 1.12) found
Please enter your username Citrix: XXXXXX
Please enter your password:
trying to validate the credentials, please wait ... [1945006OK]: have a username and password accepted
OK: saved username and password encrypted in the config.ini
OK: Debugging Tools collection mode is [Normal]
OK: found cloud installation on this system
collecting data from the system subsystem (with df, top, netstat, route, etc.)
data from the database subsystem (using mysqldump) collecting
collecting data from the logs subsystem (management -server.log, catalina.out, access_log, etc.)
compressing /tmp/cloud-bugtool_2015.10.06-02.39.01.HwTk9q/ccp-42-ms. , , Please wait (this may take a while)
OK :. Diagnostic file: /tmp/cloud-bugtool_2015.10.06-02.39.01.HwTk9q.zip
Cleanup ...
Here is an example of a case number and a specific system VM specifies protocols to collect from. After the log collection is completed, your log files will be uploaded and attached to the housing:
./CCPDoctor.pl -collectlogs -case 12345 -collectsvm 25
Cloud Platform Doctor [1.12]
fileLocation log: /var/log/cloudstack/management/CCPDoctor.log
=============== collecting MS logs and logs of SVM ID 25 === =============
OK: No new updates were found CCPDoctor (online version: 1:12 Local version: 1.12)
trying to validate the credentials, please wait ... [1945006OK]: user name and password encrypted from config.ini were checked
collecting cloud.out of example 25
copying file /var/log/cloud.log-20151002, Save as / tmp / svm_25 / _var_log_cloud.log- 20,151,002
... snip ...
Cleanup ...
initiating the upload, please wait ...
Upload of 21 MB now..........11%..........23%..........34%..........46%..........58%..........69%..........81%..........92%.......
OK: now the upload completion ...
OK: .. All done
I recommend to explore these and other features of the utility CCPDoctor
Throwing a look in the help text, accessed to use the / help-flag on the command line to uncover other useful functions. Remember, here at Citrix we can hear feedback about the doctor always interested in good and bad email to ccpdoctor@citrix.com. Happy optimization and safe ride through the clouds!
0 Komentar