Motivos para sacar paquetes de actualización

Esta es la lista de lanzamientos de menor importancia de cpg1.5.x y la razón por la que han salido. Tiene el propósito de explicar por qué deberías actualizar lo antes posible la versión estable más reciente, si estás ejecutando una versión antigua.

Como puedes ver, el equipo de desarrollo está constantemente arreglando los errores y mejorando Coppermine. Todo software no trivial contiene errores, por lo que no hay garantía de que la versión que actualmente es la más reciente sea la versión final que se publicará en la serie cpg1.5.x. Es absolutamente vital que actualizaces tan pronto como sean liberados los nuevos paquetes.

Log de cambios (Changelog)

Los detalles sobre los cambios que entraron en un paquete se puede encontrar en el fichero de cambios (changelog) que viene en él. Puedes encontrarlo en el directorio raíz del paquete de Coppermine. Tiene la información sobre idiomas adicionales y la fecha y hora de la solución de problemas.

Es un archivo de texto sin formato que se puede leer con cualquier editor - en Windows es suficiente el Bloc de notas.

Actualizar desde las versiones cpg1.0,1.1,1.2.x or 1.3.x a cpg1.5.x

No se sporta la actualización directa de cpg1.0, cpg1.1, cpg1.2.x o cpg1.3.x a cpg1.5.x - si todavía tienes una versión tan antigua, tendrás que actualizar en dos fases (desde su versión a cpg1.4.x y luego a cpg1.5.x)

Actualizar desde cpg1.4.x a cpg1.5.x

• Plugins

  Los plugins creados para cpg1.4.x por lo general no se pueden ejecutar en cpg1.5.x, así que los tendrás que desactivar mientras está aún en marcha la versión 1.4.x (antes de iniciar la actualización). Algunas de las características que han sido un complemento en un plugin para cpg1.4.x entraron en el núcleo de cpg1.5.x, por lo que puede que no necesites los plugins. La manera más segura para cerciorarse de que no interfieran es desactivando todos los plugins

• Temas personalizados

  Si has creado un tema personalizado, aplica los cambios que se introdujeron en la estructura de los temas al tuyo - mira en la guía de actualizaciones de temas. Por favor, ten en cuenta que algunos de los temas que venían con Coppermine ya no están en el paquete cpg1.5.x. Sin embargo están disponibles como descargas separadas.

• Archivos de idioma

  No puedes utilizar los archivos de idioma de las versiones anteriores de Coppermine como primer idioma (el idioma que usarás como administrador) - asegúrate de que sólo tienes los archivos de idioma que vienen con este paquete dentro de la carpeta lang (borra o renombra todos los archivos de versiones anteriores dentro de la carpeta lang).
  Si necesitas utilizar un idioma para el que no se ha traducido cpg1.5.x, puedes intentar usar el archivo de idioma de cpg1.4.x. Sin embargo debes tener ciertas precauciones:
  • Las frases de cpg1.5.x que no existen en el antiguo archivo de idioma continuarán sin traducir o se mostrarán en inglés
  • No puedes administrar Coppermine usando un archivo de idioma antiguo - el administrador tiene que utilizar un archivo de idioma específico para cpg1.5.x
  • Eres libre de intentar usar los archivos antiguos de idiomas; sin embargo cuando se produzcan problemas o mensajes de error, cambia a inglés de Estados Unidos (US-English) y comprueba si el problema desaparece. No pidas soporte del uso de archivos obsoletos de idioma.

• Cifrado de contraseñas

  En cpg1.3.x, las contraseñas de los usuarios se almacenaban como texto plano dentro de la base de datos. Esto cambió en cpg1.4.x - a partir de esta versión se cifran las contraseñas antes de almacenarlas. Sin embargo, había una opción para aquellos que actualizaron desde cpg1.3.x a cpg1.4.x en que se permitía saltarse el paso de encriptar las contraseñas. En cpg1.5.x, el almacenamiento de las contraseñas como texto ya no es una opción. Si estás utilizando una galería que actualizaste desde cpg1.3.x a cpg1.4.x y ahora actualizas a cpg1.5.x, el proceso de actualización automáticamente cifrará todas las contraseñas de los usuarios (incluido la propia cuenta de administrador). No tienes que hacer nada al respecto - el programa de actualización lo hará automáticamente.

• Mostrar FAQ

  La opción para mostrar una página de preguntas frecuentes a los usuarios finales (marcando la opción de configuración correspondiente) que existía en cpg1.3.x y cpg1.4.x se ha eliminado de cpg1.5.x, porque casi no se usaba y sólo añadía carga de trabajo adicional a los traductores. Si eres de los pocos que utilizan las FAQ en el menú de navegación Coppermine, puedes crear fácilmente una página personalizada con el encabezado y el pie de Coppermine y mostrar tus propias FAQ en ella.

• Archivos obsoletos

  Elimina los archivos obsoletos de las versiones anteriores de Coppermine que ya no existen en cpg1.5.x.
  Es sobre todo una precaución para asegurarte de que tu galería no contiene errores de versiones no actualizadas que permitirían a un atacante explotar las debilidades en las versiones anteriores. Para saber qué archivos hay que eliminar manualmente, echa un vistazo a la salida en la parte inferior de la pantalla de actualización (http://tudominio.tld/tu_carpeta_coppermine/update.php) - el programa de actualización intentará borrar los archivos por tí, pero en la mayoría de configuraciones del servidor Web no tiene permiso para hacerlo, así que tendrás que eliminar manualmente los archivos mediante una aplicación FTP. Otra forma de averiguar los archivos que deben ser borrados es la página de comprobación de versión (versioncheck) - los archivos programados para el borrado salen allí también - pero la comprobación de versiones no intenta eliminar estos archivos.

• Modo seguro

  Si tu servidor web se ejecuta en modo seguro y has habilitado "SILLY_SAFE_MODE" en el fichero include/config.inc.php, tendrás que ir a la configuración de Coppermine después de realizar los pasos mencionados y permitir "silly safe mode" allí, porque la entrada en include/config.inc.php ya no se tendrá en cuenta en cpg1.5.x. El ajuste "silly_safe_mode" ha pasado a ser una opción de configuración.

Actualizar desde versiones cpg1.5.x to a la más reciente

No hay ningún paso extra que debas seguir cuando actualizas de una versión anterior de cpg1.5.x a la versión más reciente de esa familia. Basta seguir las instrucciones descritas anteriormente en pasos necesarios para realizar al actualizar Coppermine (de cualquier versión).

Qué hace

• Comprueba la autorización de quien accede a este script
• Ejecuta las consultas en la base de datos mysql que están en el archivo sql/update.sql (sustituyendo el prefijo genérico del nombre de la tabla por el que elegiste en la instalación inicial)
• Elimina algunos archivos que estaban en Coppermine en las versiones anteriores. Sólo se eliminan archivos innecesarios y no afecta a tus archivos personalizados, por lo que no hay razón para preocuparse.
• Convierte las contraseñas de texto plano, cifrándolas: en versiones anteriores de Coppermine había una opción para permitir que las contraseñas de los usuarios se almacenaran como texto en la base de datos. En cpg1.5.x no se admite esa posibilidad. Por lo tanto (si no estás usando ya las contraseñas encriptadas), las contraseñas guardadas en la base de datos serán codificadas durante la actualización.

Propósito

El proceso realizará la actualización de base de datos por tí después de haber reemplazado manualmente el archivo sql. La actualización no detectará si hay disponible una nueva versión de Coppermine, ni descargará nada desde el sitio web de Coppermine. El nivel de automatización no es tan avanzado (aún).

Para conocer las nuevas versiones de Coppermine o saber si hay actualizaciones de mantenimiento, consulta las Novedades en coppermine-gallery.net.

Permisos de ejecución

El script de actualización solía estar accesible públicamente en las versiones de Coppermine anteriores a cpg1.5.x , esto es, todo el mundo era capaz de ejecutarlo. Si bien esto era bueno para dar soporte (cualquiera era capaz de ejecutar la actualización cuando un usuario pedía ayuda, si era obvio que no lo había hecho), cabía una pequeña posibilidad de que en algún momento pudiera ser un riesgo para la seguridad. Por eso los miembros del equipo de desarrollo decidieron proteger este script, y que no pudiera ser ejecutado por cualquier visitante - a partir de cpg1.5x hay que proporcionar credenciales de administrador. Hay cuatro maneras diferentes:

• Si ya has iniciado sesión como administrador y ejecutas el programa de actualización desde el vínculo en el menú de administración de Coppermine se debe ejecutar sin más - usa la autenticación "normal" por cookies que utiliza toda la galería Coppermine
• Si no estás conectado como administrador, o si llamas a los componentes básicos de Coppermine antes de haber ejecutado este script (por lo general cuando actualizas versiones 'mayores' de Coppermine) te pedirá las credenciales - introduce los detalles de la cuenta de administrador que configuraste la primera vez que instalaste
• Si has olvidado en tercer lugar puedes dar tus credenciales en mySQL, también los que usaste al hacer la primera instalación. Si tampoco te acuerdas descarga include/config.inc.php de tu servidor web y edítalo: allí deben estar. Si han cambiado, el equipo de soporte de tu servidor web debe ser capaz de ayudarte a recuperarlas.
• Por último, si todo falla, hay una alternantiva para saltarte la autenticación: descarga el archivo (update.php) de tu servidor web, encuentra la línea que dice // define('SKIP_AUTHENTICATION', true);, y sustituyela por define('SKIP_AUTHENTICATION', true);. Guarda los cambios y sube el fichero a tu servidor web, sobreescribiendo el que existe en el servidor. Recuerda restaurar el archivo, tal como estaba, después de haber realizado la actualización con éxito.

¿Cuándo hay que ejecutar la actualización?

Tienes que ejecutar el programa de actualización cada vez que cambies la versión o la sub-versión de mantenimiento, es decir, cada vez que se cambie el archivo sql/update.sql.

No importa ejecutar el script de actualización varias veces, así que si dudas vuelve a ejecutar.

What it does

The script "versioncheck" is meant for two purposes:

• If you have upgraded from a previous version, you should perform versioncheck to see if your upgrade worked as expected
• Use versioncheck to make sure that your coppermine version is up-to-date

This script goes through the files on your webserver and tries to determine if the local file versions on your webserver are the identical to the ones at the repository of http://coppermine-gallery.net. Files that do not match are displayed and are the files you should update as well.

Compared to previous versions, the versioncheck page has been re-designed for cpg1.5.x both in terms of visuals as well as functionality.

First run

When run for the first time, you will see the option screen first. For a start, default options should be OK, so just submit the form. The script will then determine the coppermine version you're currently running, an try to look up the XML file on the coppermine repository that corresponds to your version. If successfull, it will compare all files that exist on your server against the most recent files that are recommended to use (trying to obtain that data from the repository). Subsequently, you should see a list of folders and files that are supposed to exist on your server and an explanation if the file versions you have are the most recent. For details how to interpret the output, read on.

Options

There is a small number of options available on the versioncheck page that should be pretty self-explanatory:

• Display output

  Determines wether the full output with formatting is used, or only a reduced plain-text output
  • Full-screen
    Use this by default. It will display as much detail as possible and has a nicer layout
  • Text-only
    If a supporter asks you to post your versioncheck-output, switch to this options, so you can easily copy the output and paste it into your posting on the coppermine support board. Only do so if a supporter explicitely asks for it! Another potential use for the text-only output is resources-consumption: if you suffer from time-outs, try using the plain-text option, as it consumes slightly less resources.

• Only show potential errors

  If you have no idea what all the output is supposed to mean or if a supporter asks for it, you might want to tick this option to only display the folders/files that have issues.

• Hide images

  When enabling this option, the many graphical resources that come with coppermine (i.e. all the icons and other images) are not being taken into account for display on the versioncheck page - a filter is being applied. Use this option to make the output less cluttered: images usually are not security-sensitive, so if you're only concerned about files that have an impact on security, you can safely hide the images.

• Don't check for modified files

  This filter will hide the column "modified" from being displayed and will result in a slightly less cluttered output. The check for modified files will not be performed when the script is being run. Only enable this option if you have performance issues with the script or if all your files are being reported as modified.

• Do not connect to the online repository

  If you check this option, the versioncheck script will not attempt to connect to the online repository and use the local XML file instead. Only use this option if connecting to the online repository doesn't work for you (e.g. if you're on an intranet and your server doesn't have internet access). The main drawback of not connecting to the online repository is the fact that you won't know about possible updates and most recent releases, so you better find the cause for your inability to connect to the online repository.
  During the development stage (between releases), the online repository usually is not being updated frequently, so only if you're using SVN checkouts (i.e. if you're a developer), you should tick this option.

The options screen lets you configure the versioncheck, or rather what is being displayed. The options aren't saved anywhere, so you will have to adjust them each time you run versioncheck. The default options should be OK for most users - only change them if you have good reasons to do so.

Version comparison

There is a lot of information packed into a small space. Here's an example of a possible output and what the output means:

• Path

  The folder- and file name

• Missing

  If nothing is being displayed in this column, the folder/file exists on your server. If this is not the case (i.e. the folder/file does not exist on your server or is inaccessible), the column "Missing" will be populated with the result of this first, basic check.
  Note: there are some folders/files that are mandatory to have; others are optional. Anyway, if you perform a fresh install or upgrade, you should make sure to upload all folders/files. You can then later delete some of the optional files if you want, although this doesn't save much webspace.
  If a file is missing, all other steps that are next in the loop will not be performed - a missing file can't have a version number or similar. If versioncheck complains about missing files, use your FTP app to review if they are actually missing or inaccessible. If they are missing, re-upload them. If they are inaccessible, you will have to assign the needed permissions.
  Some files that existed in older versions might have gotten removed later. Those that might be a possible security issue will be displayed with the word "removed" in the "missing"-column. If you come across such a file, use your FTP-app to remove the file that versioncheck output complains about. Leaving the file where it is (ignoring the suggestion given by versioncheck) might pose a security risk and therefore is not recommended.

• Permissions

  Displays the permissions assigned to the folder/file. For some folders, write permissions are needed, while for others read permissions are enough. If the permission level of a folder is good, the result will be displayed together with a remark (in brackets) like "OK" (may differ in your language). Using a script like versioncheck to actually check permissions on folders works OK, while it may or may not work very well on files. This being said, you should mostly be concerned about folders that don't have sufficient permissions. If files are being reported to have an improper set of permissions assigned, don't be to alarmed if the rest of your gallery is working just fine.
  If permissions on folders need reviewing, read up the permissions section of the docs and do as suggested there.

• Version

  The version of the file on your server. If it is identical to the version indicated in the repository, you should see an "OK". If you're running an oudated version on your server you should get a fresh package and perform an upgrade.
  Note: folders don't have version numbers, nor do binary files (like graphics) have one, that's why the column "Version" displays "n/a" for folders and binary files. Only files that contain textual content can have a version number, so don't be alarmed by the many "n/a (OK)"-messages.

• Revision

  The revision of the file on your server. If it is identical to the revision indicated in the XML repository, you should see an "OK". If you're running an oudated revision on your server you should get a fresh package and perform an upgrade.
  Revisions are related to the versions - usually, if your version is OK, your revision should be OK as well. Only if you perform checkouts from the subversion repository, the revisions may "act up".
  The same thing that applies to version numbers applies to revisions as well: only textual files can have revision numbers - folders and binary files don't have a revision number.
  Confused? You don't have to: usually, you can safely ignore revisions - if you want to find out about what revisions are being used for, read the details on the subversion page.

• Modified

  If a file is accessible and the version and revision numbers match, the versioncheck script attempts to perform a check wether the file has been modified, compared to the original that comes with the coppermine package. This check is being performed by taking into account the MD5-hashes of the original file and your copy.
  When performing a fresh install or upgrade, there should be no modified files. If they are being displayed as modified, there are several possible reasons:
  • You deliberately modified the file (e.g. by applying a custom modification to it). In this case, it's OK to ignore the warning in the "Modified"-column and continue
  • Your file has not been transfered fully to the webserver. If this is the case, try to re-upload the file from your client to the server. If this doesn't help, your package might have gotten corrupt. Re-download a fresh one from the coppermine download section, un-archive it and re-upload the file. Make sure that your FTP app is configured to actually overwrite existing files
  • You have used an improper FTP-mode to transfer the file to your webserver. Using FTP apps, you can transfer files in binary or ASCII-mode. Most up-to-date FTP clients have a feature that will automatically select the proper FTP-mode for each file. If this is not the case, try the manual appoach and explicitely specify the FTP-mode for your file uploads.
  • Your webhost is injecting code into each file. Many free webspace providers (so-called "freehosts") do this to inject advertisments into your files. There's little you can do then except signing up with paid webhosting or ignoring the "Modified"-warning and hoping that things will work anyway.
  The output of the column "modified" can be filtered by enabling the option Don't check for modified files. This will result in a slightly increased performance of the versioncheck script.

• Comment

  The comment-column contains a short recommendation about what is supposedly wrong and what you should do to fix this. No comments usually means that everything is OK.

• Repository link

  The link to the SVN repository (web SVN) is meant as an additional feature for power-users and developers. Read the subversion repository instructions to find out more. If everything is fine, you don't have to worry about the link anyway.

Things that could go wrong using versioncheck

As the actions performed by the versioncheck script are complex, there are several things that can go wrong, depending on your webserver setup:

• No connection to the online XML repository
  If your server resides behind a proxy or a web filter that requires authentication or doesn't have internet connection at all (e.g. on a company's intranet), the versioncheck script may not be able to connect to the online XML repository. Use the corresponding option to keep the script from trying. The caveats mentioned in the options section applies.
• I get a white page, or a page without actual content
  The script probably times out, as it consumes huge resources. You'll have to live without versioncheck then on your server setup, unless the server is yours to configure, so you can assign more memory and execution time to the script.
• I get an error message
  Error messages like Fatal error: Maximum execution time of 60 seconds exceeded in /path/to/webroot/coppermine_folder/include/versioncheck.inc.php on line 276 are an indicator for the script consuming too many resources on your server. Try disabling some output options. If this doesn't help, you simply can not run the versioncheck script on your server.

Versioncheck is being provided as a courtesy to end users. As there are several factors that have an impact on it, it may or may not work on your server setup. If the versioncheck tool does nothing at all, this is probably the case for you - you don't have to be alarmed in this case: just make sure to keep your coppermine install up-to-date, preferably by enabling the config option "Display news from coppermine-gallery.net". Only if individual issues are being reported by the version check tool (i.e. only if some lines contain a remark in the comments column), you should be alarmed and take a closer look.

Wrong expectations

To some this may sound trivial, for others it might be an important piece of information: naturally, files that you have not replaced during the upgrading process (e.g. anycontent.php) will show as outdated in versioncheck's output. This is of course to be expected. It doesn't hurt if you performed the upgrade exactly as suggested, as the files you're supposed to keep during that process don't actually contain code that needs updating. As an example, anycontent.php doesn't actually contain code at all (at least the file that comes with coppermine out of the box). It can contain custom code if you decide to use it. For details on the usage of anycontent.php, refer to the section "Using anycontent.php".

The versioncheck tool doesn't actually download newer file versions from the internet - it just checks the files you have on your server against a list of most recent files. The versioncheck tool doesn't check nor sanitize your site against hacking.