Archive

Archive for April, 2011

Start Chamilo Rapid on localhost

April 23, 2011 1 comment

Quite easy to start Chamilo Rapid on your own computer with OpenOffice.org v3 installed:

soffice -nologo -nofirststartwizard -headless -norestore -invisible “-accept=socket,host=localhost,port=2002,tcpNoDelay=1;urp;”

Then just go into your portal admin page and configure the Chamilo Rapid as localhost on port 2002 and save. This will make the PPT import button appear in your learning paths screen.

If you’d like to leave this running on your server, you should write a proper init.d script, but if you’re in a hurry on a non-critical server, you can always use screen on any recent Linux server and launch the line above, then use CTRL+a, CTRL+d to unlog yourself from the screen’d terminal without shutting down the service.

Poner su logo en la cabecera de Chamilo classic

April 21, 2011 9 comments

Cambiar el logo encima de su portal de Chamilo es muy fácil. Para ir al punto, no analizaré aquí los aspectos importantes del estilo visual global de su campus, pero es importante mencionar una sola cosa: si quiere usar su propio logo, es una buena idea hacer una copia del estilo que más les gusta.

Para este primer etapa, simplemente tiene que copiar la carpeta del estilo que más le gusta en una nueva carpeta. Por ejemplo, si su institución se llama AEB Consultores, hacer una copia de la carpeta main/css/chamilo como main/css/aeb.

A partir de ahí, puede empezar a trabajar su logo. La idea, para minimizar el esfuerzo (obviamente se pueden obtener resultados mucho mejores con más esfuerzo), es de usar el logo actual como base, y redimensionar su logo en base a esto.

En la carpeta main/css/aeb/images, encontrará un imagen llamado header-logo.png.

Logo por omisión del campus de Chamilo

Logo del estilo "main/css/chamilo"

Este imagen es el que se usa actualmente como logo. Abralo con un editor de imagenes. Recomendamos la herramienta de software libre GIMP. Al abrir, se presentan datos importantes en el título de la ventana.

Chamilo logo in Gimp

The Chamilo logo as viewed by Gimp

Vemos que:

  • el tamaño de este logo es de 260×84 pixeles. Es decir 260 pixeles de ancho por 84 pixeles de alto.
  • el fondo es transparente
  • existe una parte superior vacía (no se aprovecha de los 84 pixeles)

Si queremos evitar esfuerzos, tenemos que cumplir con lo siguiente:

  • nuestro logo tiene que estar en un marco de 84 pixeles de alto
  • tiene que tener el mismo nmobre de fichero (header-logo.png)
  • tiene que estar en una carpeta copia de main/css/chamilo
  • tiene que usar un máximo de 70 pixeles de alto sobre los 84 pixeles del marco, y
  • el fondo del imagen para los 14 pixeles superiores tiene que ser transparente (simplemente porque aparecerá un texto en este area y así evitamos jugadas de estilos para soporte de múltiples navegadores)

Abramos nuestro logo con Gimp (CTRL+O)

Logo personal en Gimp

Logo personal original

Cortemoslo (con la herramienta de corte o SHIFT+C, seleccionar zona y hacer clic en el medio) para evitar espacio blanco alrededor.

Logo recortado

Logo recortado

Guardemos esta primera versión (CTRL+SHIFT+S) con nombre “header-logo.png” ya que servirá para aplastar al logo por omisión de Chamilo que se llama así.

Ahora redimensionamos el imagen de forma proporcional para que tenga un alto máximo de 70 pixeles: Mení Imagen -> Escalar la imagen… -> Altura: 70 -> Tab -> Escalar.

Nuestro imagen (quizás de calidad un poco menor) tiene el buen tamaño. Ahora tenemos que ampliar el lienzo para que el lienzo total sea de 84 pixeles, con el logo en la parte inferior: Imagen -> Tamaño del lienzo -> Quitar el eslabón de relación e indicar 84 en Altura -> reubicar el logo hacia abajo. Redimensionar.

Redimension de lienzo

Redimension de lienzo

Guardar el imagen como header-logo.png (confirmar el mensaje de confirmación sobre los limitantes del formato PNG) y… ya tenemos nuestro logo.

Ahora remplazamos (via SFTP por ejemplo) el logo de Chamilo dentro de la carpeta main/css/aeb/images/

Dentro de su campus Chamilo, ir a Aministración -> Parámetros de configuración -> Hojas de estilo -> Seleccionar AEB y guardar.

Felicidades!

Memcache(d) to store PHP sessions

April 18, 2011 4 comments

Edit: as of July 2014, there is a recent article discussing the use of php5-memcache instead of php5-memcache to store sessions on this blog.

There are many posts around on the web about using memcached to store sessions data on high-availability servers, but few actually cover the whole topic and there are some elements that I thought might be of interest in the form of a quick recap.

Memcached allows you to store frequently-used data in memory (RAM). This saves a lot of disk reads & writes and, considering disk accesses are one of the slowest elements in the software processing chain, it might vastly improve your server’s response time (your mileage may vary depending on your specific configuration). This is practical to save commonly-used variables or blocks/pages of data, but can also be used to store users sessions.

Furthermore, the system can be used to share one memcached instance between various servers, making it much easier to distribute your web servers (in high availability, redundancy and load balancing configurations), making PHP connect to the shared memcached server to save or read its session data.

Because the system in its entirety relies on available memory, and while it is acceptable to loose some data in the case of some computable data (which can be recomputed in case of lack of space in memory to store that data), it is important to note that session data must offer one of two security measures to work properly: (1) provide enough RAM space to cover all simultaneous sessions at all times or (2) provide an alternative storage system where the sessions can still be stored somewhere *out* of the available RAM space. This last point is discussed in more detail in this article.

php-memcache vs php-memcached

First of all, at the server level, we’re only talking about memcached. php-memcached is reportedly more efficient than php-memcache and overcomes some of its limitations. There is a comparison of both on the php-memcached’s Google Code page, but more importantly there are a lot of comments on the web that let you get an idea of what it’s all about. In short, php-memcached is more recent and tend to be more efficient (apparently). The second comment on a Stackoverflow question on the topic of memcache points out a series of elements that are implemented only by php-memcached.

php-memcache vs php-memcached for PHP sessions

The memcached PHP extension *probably* has a more complete implementation too.

For some reason (which I haven’t been able to figure out just yet), on a standard PHP5.2 (Ubuntu LTS 10.04) installation, the php-memcached module doesn’t really work out for handling sessions (at least the “memcached” session.save_handler doesn’t seem to be recognized), provoking response times of around 30 seconds (probably the timeout limit) which do *not* manage the session data. As such, you can still use the memcached on a server and connect to it using the php-memcache extension (use “memcache” instead of “memcached” in your session.save_handler, although I will have to check whether it is possible to use php-memcached with the “memcache” save handler). In my experience, session.save_handler=”memcached” just doesn’t work. This, however, should have been the right way, as indicated in the PHP documentation for the memcached module.

So, in my case I had two servers, one hosting the web server (66.55.44.38), another hosting the database server (66.55.44.34). Because the database server had more RAM free to use than the web server, I decided to use the database server as my memcached server, and configure my VirtualHosts to use this server. I called my servers “cpw” and “cpdb” internally (defined in /etc/hosts of each server), so my VirtualHosts included these lines:

  # Memcache
php_value session.save_handler “memcache”
php_value session.save_path “cpdb:11211”
php_value memcache.hash_strategy “consistent”

On the database server, I installed memcached (sudo apt-get install memcached) and did the only *necessary* change in /etc/memcached.conf (the rest is up to you):

-l 66.55.44.34

Note that this is the server’s own IP, and it is deemed dangerous to have a public IP there, as it can then be used by others as their memcached server, so you should definitely have some firewall rules in place to avoid non-personal servers to access this IP (at least through MemCache’s port 11211).

I should also add that Kai Seidler’s article on memcached has proven useful in the elaboration of this short article and that, as always, PHP’s documentation has been very useful.

Memcached sessions handling shortcomings

The inner workings of memcached imply that any session data is in fact saved into the RAM, which also means it is highly volatile and relies highly on the RAM available on the memcached server. If your RAM space is filled with existing sessions and you need more, you will have to plan for an alternative storage resource for those sessions getting over the allowed space. This is something that is proposed in an article about memcached by Dawn Rossi. Of course, if you are looking for a quick solution to storing sessions into memcached when no more RAM is available, you can look for a file-based RDBMS or a non-SQL DB system. Memcachedb seem to be one of them.

phpMemCacheAdmin

Once you get your system setup, you might want to see how efficient it is. To do just that, download and install phpMemCacheAdmin on one of your servers. It’s pretty much downloading and uncompressing into the right web folder (standalone PHP application).

If you have a setup similar to mine above, don’t forget to go to Configuration settings and change the default 127.0.0.1 to your MemCached server’s public IP.

This is an article in constant rebuild, so please don’t hesitate to comment, I’ll include your input if useful.

%d bloggers like this: