News

Documentation

(English version)

¡Saludos!

Luego de ocho largos meses trabajando en traducción, edición y revisión, me place anunciarles que el equipo de Traducción al español (compuesto por George Alpízar y esta servidora) del departamento de Documentación de cPanel ha terminado de publicar la documentación en español de cPanel y WHM, versión 11.28. (¡Qué emoción!)

¡Fueron muchos documentos! (Sobre 600 para WHM SOLAMENTE.) Así que hicimos lo que cualquier persona que trata de comerse un elefante haría: comerlo de bocado en bocado. El projecto de traducción se dividió en tres partes: the cPanel User Guidela Guía del usuario de cPanel (publicada en marzo 2011); la Guía de instalación (publicada en mayo 2011) y, finalmente, la Guía del usuario de WHM, que acabamos de publicar esta semana (agosto 2011).

George y yo nos dividimos la traducción, y revisamos y editamos el trabajo del otro (como trabajan los buenos escritores técnicos y traductores). Pero otro trabajo que tuvimos que añadirle a la lista de tareas fue la creación de nuestro propio diccionario en español de terminología de cPanel. Aunque usamos algunos diccionarios inglés-español en formato de libro y formato web, les debe sorprender de que no hay muchos diccionarios técnicos inglés-español disponibles. Por ende, tuvimos que juntar todos los recursos a nuestra disposición y establecer una hoja de cálculo (spreadsheet, en buen boricua) con los términos más usados. Hubo muchos casos en los que los diferentes recursos tenían definiciones diferentes para los mismos términos, así que tuvimos que ponernos de acuerdo en cuanto al mejor término para usar en esa situación. También, hubo ocasiones en donde decidimos mantener la palabra en inglés en nuestra traducción. Por ejemplo, utilizamos la palabra spam en vez de usar "correo no deseado", que no es una frase común.

Al final, trabajar con cPanel para ayudar a nuestros clientes hispanohablantes ha sido una experiencia maravillosa. Esperamos que estos documentos les asistan en entender y utilizar nuestro producto con mayor provecho.

George y yo también queremos darle unas ¡¡GRACIAS!! bien merecidas al excelente Marlon Sánchez y al resto del equipo de Soporte Técnico en español por asistirnos con la revisión técnica del texto traducido. Su aportación nos ayudó a adaptar un texto que traducimos con motivación hacia la perfección léxica a uno más orientado para una audiencia con experiencia técnica.

Próximamente, nuestros proyectos de traducción incluyen la documentación para la versión 11.30 de cPanel y WHM y la revisión del local en español de la interfaz de cPanel.

Agradecemos (y les pedimos humildemente) su retroalimentación (feedback, ya saben...). Así que si tienen comentarios o sugerencias sobre la documentación en español, pulsen el botón rojo titulado Feedback o visiten feedback.docs.cpanel.net (en inglés).

Hasta la próxima,
Rosalma Arcelay
Escritora técnica profesional de cPanel

Materiales relacionados:
Episodio 15 de Podcast: ¡Guía del usuario de cPanel en español!

(Versión en español)

Howdy!

After eight months of toiling, translating, editing, and re-editing, I am proud to say that the cPanel Spanish translation team (which is composed of George Alpízar and myself) has completed the publication of the cPanel & WHM 11.28 documentation in Spanish!

There were a lot of documents! (Over 600 for WHM ALONE.) So we did what any person would do when trying to eat an elephant: do it one piece at a time. The translation project was divided into three parts: the cPanel User Guide, published in March 2011; the Installation Guide, published in May 2011; and then, finally, the WHM User Guide, published just this week (August 2011).

George and I split the translation between us, and revised and edited each other's work (as any good technical writer and translator would do). Among all this, we had to take upon another task: establish our own Spanish cPanel terminology dictionary. While we did use a few English-Spanish online and print dictionaries, you'll be surprised to know that there aren't that many technical English-Spanish dictionaries. As a result, we pooled whatever resources we could find and established a spreadsheet with frequently used terms. During our research, we often encountered different translations for the same word, so we had to come to a consensus regarding which was the best term to use for that situation. Likewise, there were instances when we decided that maintaining the term in English would be better for our customers instead of using a more obscure translation. For instance, we agreed that keeping the word spam in English would be more appropriate for our translation, instead of using a more obscure Spanish term.

All in all, it has been a wonderful experience working with cPanel to help out our Spanish-speaking clients. We hope our translation will assist them in better understanding how to use our product. Our future translation projects include the cPanel & WHM 11.30 documentation , as well as the revision of the cPanel Spanish locale interface.

George and I would like to also offer a special ¡¡GRACIAS!! to Marlon Sánchez and the rest of the Spanish Tech Support team for their assistance in the technical revision of the Spanish text. Their input helped us adapt some of the language and terminology in the translated work to a more tech-savvy audience.

We appreciate (and humbly request) your feedback, so if you have any comments regarding the Spanish documentation, hit the red Feedback button shown on the right side of any of our documents, or visit feedback.docs.cpanel.net.

Until the next post,
Rosie Arcelay
Bilingual Technical Writer for cPanel

Related materials:
Podcast Episode 15: cPanel Guide in Spanish!


Choosing the right limits is critical for stable, efficient shared hosting. Quite often there is a desire to set limits very low, so that any time customer's site hits those limits, the site would be throttled. The reality is that the cost of handing customer complaints, customer dissatisfaction, and the resulting churn, can outweigh the benefit of routinely adhering to strict limits. It’s important to strike good balance so that the limits are high enough that the majority of customers are unaffected, yet low enough to prevent system abuse without issue.

The CloudLinux OS comes with the ability to set CPU, Memory and concurrent connection limits. Those limits are critical for achieving stability in shared hosting environments.

CPU Limit controls the amount of CPU resources available for php/cgi scripts for the given account and is set by the smaller of two parameters: % of total CPU capacity (cpu) or number of CPU cores (ncpu) available to a given customer. The defaults are as follows:

ncpu=1

cpu=25%

Which means: customers are limited to the smaller of 1 core or 25% of total CPUs.

On 4, 8 or, 16 core servers it would mean that max usage per customer would be 1 core.

On a 2-core server it would mean ½ of a core per customer.

For single CPU servers this would mean ¼ of a core per customer.

This limit gives enough power for a customer's site to run fast, yet makes sure that if a customer starts to abuse the system, there are plenty of CPU resources left for others. CPU limit will prevent a single site from using more CPU resources then it was allocated. Interestingly enough, the majority of IO intensive applications are also CPU intensive, so CPU restriction alone can reduce IO issues as well.

VIRTUAL MEMORY Limit controls the total amount of virtual memory available for applications running within an account. By default, each customer is limited to 1GB of virtual memory. If a user application tries to use more than that such application will fail, as it hasn't been able to allocate memory. This usually shows up as error 500 (Internal Server Error) in a visitor’s browser.

The memory limit is the sum of virtual memory used by all applications in the account. It is important to note that we are limiting virtual, not physical memory. Multiple processes often share physical memory but don't share virtual memory. As a result you need to allocate much more virtual memory than physical memory. This is why it is important to leave virtual memory limits high enough.

ENTRY PROCESSES (Concurrent Connections) Limits the number of concurrent connections and cron jobs that an account can have at any one time. 

Each time someone connects to Apache, a connection is used up. There are a limited number of slots in Apache web server for these connections (specified by MaxClients). It is set to 150 by default but often increased to 1000 or more on shared hosting servers. While connections are quickly served for static pages, dynamic pages take their time. 

CPU throttling can cause such pages to take even longer to serve, tying up even more slots. Once all slots are used up, apache will not serve any new requests until existing requests are processed, bringing the whole server down. To prevent this issue we added another parameter that limits the number of concurrent connections a site can have. The default is 20. If a site has more than 20 concurrent connections to dynamic pages any further request will receive a 508 error (resource limit reached.)

It is important to note that concurrent connections are not the same as concurrent users. The majority of applications such as blogs, forums, etc., consider a user to be someone who visited a page within past 15-30 minutes. So, 300 concurrent users on the forum might mean only 5-6 concurrent Apache connections.

Adjusting Limits

By default, limits are optimized for servers with 50-5000 accounts and require no tuning. Yet, often there are just a couple of bad neighbors on a server that you might want to fence a bit more tightly. Sometimes you would want to adjust limits if some site is having an issue. The customer might be willing to pay more, or you feel that the customer deserves to be able to burst a bit higher, as he isn’t causing problems for the server. First, let’s figure out if the issue is related to limits imposed by CloudLinux: 

If a site is slow, check if the site is hitting CPU limit. You can do that by running the lvetop utility, which will show real time results. Alternatively, you can check max CPU usage for the site via LVE Manager available via the WHM interface. If you see the site hitting CPU limit, the slowness of the site is caused by CloudLinux limits. Be careful adjusting CPU limit values. Adjusting them in small increments is recommended. You don't want to overload the whole server.  

CloudLinux.png

If the site is responding with a 508 error, the site is hitting concurrent connection limits. I always recommend checking lvetop/LVE Manager for CPU as well. If the user is hitting both concurrent connection limits and CPU limits, you might not want to adjust concurrent connections as it will not help and can cause server overload. In this case, increasing CPU might be a better solution as requests would get processed faster, and there will be a smaller number of concurrent connections for the site.

On the other hand, if a site is hitting concurrent connection limits, but not hitting CPU limit, you might want to increase max number of entry processes. As before, make sure you adjust the limit in small increments. The site might be hitting MySQL or IO hard, and the only thing stopping your server from being overloaded is the concurrent connections limit.

Memory limits are the trickiest. Visitors will get an error 500 (Internal Server Error) when the site hits the memory limit. This error might mean something is wrong with the script, with server settings, or it might be due to memory limits. Differentiating is easy; just go to LVE Manager and do a search “By Fault” and select memory. If you see that the site displayed in the search results it means that the memory limit was hit by that site. If you don't see it there the issue lies elsewhere. 

 
 
 
 

Summary

Starting with version 11.30, cPanel & WHM version numbers will consist of 4 segments. The fourth segment reflects minor patches known as the build ID, which is an automatically incrementing number.

Details

Last summer, we modified the cPanel & WHM version number scheme. Building upon those modifications in version 11.30, we are including a fourth segment to indicate the build ID. You may have noticed that the first 11.29 build released to our EDGE tier used this convention. Minor patches to a versioned release will result in an increment of the build ID. These patches will only include critical changes such as compatibility maintenance and security fixes.

We will update the cPanel & WHM version number documentation to reflect the new scheme shortly. In the meantime, here is what you need to know.

Changes to the version number

  • The first and second segments still represent the parent and major values. (These are unchanged.)
  • The third segment no longer consists of an auto-incremented build ID number. It now represents a milestone—a group of changes to cPanel & WHM that will include new features and bug fixes.
  • The fourth segment is the auto-incrementing build ID. This value is relative to the milestone. When the milestone is achieved, the third segment will be incremented and the build ID will reset to 0.

For example, in version 11.29.1.4:

  • "11" is the parent number.
  • "29" is the major version number. 
  • "1" is the cPanel & WHM milestone.
  • "4" is the build ID leading up to the completion of the milestone.

This version number would be reported in the cPanel & WHM user interfaces as “11.29.1 (build 4).”

How we release bug fixes

When we discover critical issues after publishing a version of cPanel & WHM, we will fix them and back port the fix. In some circumstances, we may need to rebuild all currently published milestones.

Example

Consider a scenario in which these are the most recently published tiers of cPanel & WHM:

EDGE

11.30.1.5

CURRENT

11.30.1.5

RELEASE

11.30.0.8

STABLE

11.30.0.8

If we found a critical issue that affected both the 11.30.0 and 11.30.1 milestone releases, then we would backport the fix to, and republish, 11.30.1 and 11.30.0. By contrast, an issue that only impacts the 11.30.1 release would result in a new build of 11.30.1 only.

We will queue non-critical issues for delivery in a future milestone build.

Backwards compatibility for version numbers

Version 11.30 will also provide backwards-compatible (3-segment) renditions of the new cPanel & WHM version numbers. This should help ease the transition for third-party applications that integrate with cPanel & WHM.

However, since these renditions will be limited, we strongly encourage third-party developers to update their products for compatibility with the new version format.

 The Documentation and Integration Team at cPanel are very pleased to announce the publication of the new and improved SDK documentation.  We’d like to take a moment to thank all of you, our customers, for your patience throughout this process. We are confident you will find the end product well worth the wait.

Essentially, rather than splitting the documentation into relevant web-accessible directories, we've compiled all of the SDK documents into a single, visible web directory. This change will allow us to locate and manage documents much more easily, which translates to faster updates for you! We've also created a comprehensive landing page so you can access links to all relevant documentation from a single location. We hope this feature will help you find information more quickly and easily. 
 
Along with a total reorganization, we've also cleaned up several existing documents. As a result, we believe the information is communicated more clearly and the overall legibility of the document is much improved. We hope you'll agree!  
 
 
If you have any requests, comments, or complaints, please don't hesitate to let us know. Simply click the red feedback button on the right-hand side of the screen.  
 
Again, we are optimistic that each and every one of you will benefit from the tireless effort we have put into this project. Enjoy!