summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorramon <ramongomez@us.es>2012-02-26 10:43:47 +0000
committerramon <ramongomez@us.es>2012-02-26 10:43:47 +0000
commit91aaf03b7d426a13bdcb6f60a0deaf0be480211b (patch)
tree560391e299823ce58ca8ba6618d75c23caf82ff4 /doc
parent905ea9e42f91303f30c18df3c53db74dae14d23f (diff)
Versión 1.0.3, #499: Integrar versión 1.0.3 en rama principal.
git-svn-id: https://opengnsys.es/svn/trunk@2695 a21b9725-9963-47de-94b9-378ad31fedc9
Diffstat (limited to 'doc')
-rw-r--r--doc/CHANGELOG.es.txt38
-rw-r--r--doc/INSTALL.en.txt100
-rw-r--r--doc/INSTALL.es.txt23
-rw-r--r--doc/README.en.txt67
-rw-r--r--doc/VERSION.txt2
5 files changed, 219 insertions, 11 deletions
diff --git a/doc/CHANGELOG.es.txt b/doc/CHANGELOG.es.txt
index 6054a8af..8b1e6525 100644
--- a/doc/CHANGELOG.es.txt
+++ b/doc/CHANGELOG.es.txt
@@ -2,6 +2,44 @@ LISTA DE CAMBIOS CHANGELOG.es.ext
========================================
+Lista de cambios incluidos en OpenGnSys 1.0.3
+---------------------------------------------
+
+Tickets resueltos en módulo OpenGnSys Cloning Engine:
+#92 ogGetFsType detecta identificador de partición no sistema de archivos
+#469 Definir fichero de configuración para el motor de clonación
+#470 Implementar mejoras en script updateCache
+#471 Test de rendimiento de sistemas de archivos en contenedor de imágenes local y remoto (duplicado de #468)
+#472 Librería PostConf permite habilitar la desactivación del chkdisk tras clonación en Windows
+#481 Script sendFileMcast del repositorio sin mbuffer
+#482 Script de inicio mountrepo.sh no reconoce variable "ogprotocol"
+
+Tickets resueltos en módulo OpenGnSys Client:
+#440 Restauración con Partclone muy lenta
+#456 Seguridad: ogclient en modo usuario monta el repositorio con permisos de escritura
+#460 Cliente ogLive 11.10 (tarea)
+#466 Comando iniciar sobre sistema Linux bloqueado por Browswer
+#468 Sistema de archivos de la caché en Ext4
+#477 Mejorar la internacionalización del cliente (inglés, en especial)
+
+Tickets resueltos en módulo OpenGnSys Web Admin Console:
+#376 Menú para el Browser en equipos sin menú asignados con valores por defecto (se solucionará en #411)
+#454 Buscador de equipos para la interfaz de administración web (mejora)
+#475 Consola web comando->restaurar habilitar restauración directa (sin cache) por Multicast y Unicast (mejora)
+#483 Completar la internacionalización de la consola web (los 3 idiomas iniciales)
+#485 Cambio en la cantidad de registros a mostrar en colas de acciones
+#486 Frames dinámicos en el interfaz Web
+#487 Tamaño de select dinámico en Gestión Avanzada Arranque y Reubicador de equipos
+#492 Mejoras en páginas principal de acceso (mejora)
+
+Tickets resueltos en módulo OpenGnSys Installer:
+#504 instalador: error al instalar servidor DHCP en Ubuntu 10.04.4
+
+Tickets genéricos resueltos:
+#498 Traducción al inglés de ficheros de documentación
+#499 Integración de OpenGnSys 1.0.3 en rama principal
+
+
Lista de cambios incluidos en OpenGnSys 1.0.2a (versión de mantenimiento)
----------------------------------------------
diff --git a/doc/INSTALL.en.txt b/doc/INSTALL.en.txt
new file mode 100644
index 00000000..3bf0b26f
--- /dev/null
+++ b/doc/INSTALL.en.txt
@@ -0,0 +1,100 @@
+
+OpenGnSys Server Installation v. 1.0.3
+======================================
+
+
+Notes
+-----
+
+It is assumed OpenGnSys Server will be installed in a GNU/Linux distro, Ubuntu 10.04 Server LTS or later, Linux Mint 12 or later, Debian 6 or later.
+
+
+Installation Methods
+--------------------
+
+There are three basic ways OpenGnSys installation:
+
+ Installation script. Which uses Subversion to download the application.
+ Starting from a tar.gz This application is now complete.
+ Installation step by step manual. It is obvious the installation script and install each component.
+
+
+1. Download the Installation Script
+
+OpenGnSys installation is done by running the installation script opengnsys_installer.sh, which can be downloaded directly from http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh
+
+1.1. Download the script. Examples with various tools:
+
+ Download with wget.
+ wget http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh
+ Download with curl.
+ curl http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh > opengnsys_installer.sh
+ Download with a web browser. Click on the link http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh and save the file as opengnsys_installer.sh
+
+1.2. Or, installation from tar.gz.
+
+ If we do not have access to Subversion, we will have to download the package tgz from the web. Access to http://www.opengnsys.es/browser/tags and load it on a server temporary directory.
+
+ Descompress the file:
+ tar xvzf opengnsys-version.tar.gz
+
+ Change to the installer directory:
+ cd opengnsys/installer
+
+
+2. Basic Configuration
+
+ For security reasons, it is very important modify defaults users and passwords to access to the system. For this, edit the installation file opengnsys_installer.sh and change the values of configuration variables:
+ MYSQL_ROOT_PASSWORD - MySQL root user password.
+ OPENGNSYS_DB_USER - OpenGnSys access user and OpenGnSys super-user.
+ OPENGNSYS_DB_PASSWD - User password.
+ OPENGNSYS_CLIENT_PASSWD - Password for client access to remote services.
+
+
+3. Installation process.
+
+The installation script must be run as root:
+
+ sudo bash opengnsys_installer.sh
+
+
+4. Check the configuration files.
+
+Init Configuration
+ /opt/opengnsys/etc/ogAdmServer.cfg - OpenGnSys Server config file
+ /opt/opengnsys/etc/ogAdmRepo.cfg - OpenGnSys Repository config file
+ /opt/opengnsys/etc/ogAdmAgent.cfg - OpenGnSys Agent config file
+ /opt/opengnsys/client/etc/ogAdmClient.cfg - OpenGnSys Client config file
+ /opt/opengnsys/www/controlacceso.php - OpenGnSys Web Admin Console config file
+
+Configure DHCP server, insert clients data and restart the service.
+
+Access as Administrador in Web Admin Console.
+ Use the user and password set in the installer to access to database (variables OPENGNSYS_DB_USER and OPENGNSYS_DB_PASSWD).
+ Check the default organizaed configuration and default user.
+ Access as user in Web Admin Console.
+ Use the user and password configured as administrador in the Organizational Unit.
+ Check the server IP in section "Servidores->Servidor OpenGnSys (Default)".
+ If you change the configuration, you must to restart the server: sudo /etc/init.d/opengnsys restart
+
+
+Updating OpenGnSys
+------------------
+
+Run opengnsys_update.sh script as "root" to update all OpenGnSys components from the Subversion repository:
+
+ sudo bash /opt/opengnsys/lib/opengnsys_update.sh
+
+Follow the instructions.
+
+
+Uninstalling OpenGnSys
+----------------------
+
+Run opengnsys_uninstall.sh script as "root" to uninstall all OpenGnSys components:
+
+ sudo bash /opt/opengnsys/lib/opengnsys_uninstall.sh
+
+Follow the instructions.
+
+
diff --git a/doc/INSTALL.es.txt b/doc/INSTALL.es.txt
index 52ed63b8..3d8a05f1 100644
--- a/doc/INSTALL.es.txt
+++ b/doc/INSTALL.es.txt
@@ -1,16 +1,16 @@
-Instalación de OpenGnSys Server v 1.0.1
+Instalación de OpenGnSys Server v 1.0.3
=======================================
Notas iniciales
---------------
-Se presupone que el servidor de OpenGnSys va a ser instalado en una distribución del sistema operativo Ubuntu Linux a partir de la versión 9.04.
+Se presupone que el servidor de OpenGnSys va a ser instalado en una distribución del sistema operativo Ubuntu Linux a partir de la versión 9.04 (también ha sido probado en sistemas Debian 6 y Linux Mint 12).
El serividor debe tener acceso a Internet para descargar los paquetes necesarios, el rpositorio código y el cliente preconfigurado.
Requisitos mínimos de almacenamiento:
- 350 MB en el directorio /tmp (solo durante la instalación)
-- 300 MB en el directorio /var/lib/tftpboot
+- 300 MB en el directorio /var/lib/tftpboot (o /srv en sistemas Debian)
- 50 MB en el directorio de instalación /opt/opengnsys
- Estimar la capacidad necesaria para el repositorio de imágenes en /opt/opengnsys/images
@@ -18,27 +18,31 @@ Requisitos mínimos de almacenamiento:
Instalación
-----------
-La instalación de OpenGnSys se realiza ejecutando el script de instalación opengnsys_installer.sh, el cual puede obtenerse descomprimiendo el fichero de la versión opengnsys-Version.tar.gz o descargándolo directamente de la dirección: http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt
+La instalación de OpenGnSys se realiza ejecutando el script de instalación opengnsys_installer.sh, el cual puede obtenerse descomprimiendo el fichero de la versión opengnsys-Version.tar.gz o descargándolo directamente de la dirección: http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh
Ejemplos de descompresión del programa:
- tar xvzf opengnsys-1.0.1.tar.gz
+ tar xvzf opengnsys-1.0.3.tar.gz
cd opengnsys/installer
-
Ejemplos de descarga con varias herramientas:
* Descargar con wget.
- wget http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt -O opengnsys_installer.sh
+ wget http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh -O opengnsys_installer.sh
* Descargar con curl.
- curl http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt > opengnsys_installer.sh
+ curl http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh > opengnsys_installer.sh
+
+Como medida de seguridad, resulta muy importante modificar los usuarios y claves por defecto de acceso al sistema. Para ello, editar el fichero de instalación opengnsys_installer.sh y modificar los valores de las variables de configuración:
+ MYSQL_ROOT_PASSWORD - clave del usuario root de MySQL.
+ OPENGNSYS_DB_USER - usuario de acceso y super-administrador de OpenGnSys.
+ OPENGNSYS_DB_PASSWD - clave del usuario.
+ OPENGNSYS_CLIENT_PASSWD - clave de acceso del cliente a servicios remotos.
El script debe ser ejecutado como usuario root:
sudo bash opengnsys_installer.sh
-
Se realizan los siguientes procesos:
* Obtenener los parámetros básicos de la red.
* Comprobar los paquetes instalados.
@@ -54,7 +58,6 @@ Se realizan los siguientes procesos:
* Descargar la imagen inicial de OpenGnSys Client.
* Configuración básica de los serviciios de OpenGnSys a partir de los parámetros de red.
-
Una vez finalizada la ejecución del instalador, puede empezarse a trabajar con el sistema:
* Configurar DHCP.
* Añadir datos en la consola de administración.
diff --git a/doc/README.en.txt b/doc/README.en.txt
new file mode 100644
index 00000000..149b600f
--- /dev/null
+++ b/doc/README.en.txt
@@ -0,0 +1,67 @@
+
+The OpenGnSys Project README
+================================
+
+OpenGnSys (pronounced Open Genesis) is based on a modular architecture separated in different service layers which allows its implementation in several educational and organizational IT environments, both in a centralized or distributed way. The main system management is carried out by means of a simple web interface which supports delegated administration. OpenGnSys is also suitable for isolated environments, being able to work under network failure conditions (offline mode).
+
+
+Architecture
+------------
+
+From the point of view of clients, OpenGnSys Project is constituted by a set of separate modules in different layers of services.
+
+ * The bottom layer is responsible for direct access to client devices and motor functions of cloning.
+ * An intermediate layer consisting of a set of tools to perform complex tasks and environment customization.
+ * Management module consists of a simple and intuitive web interface that allows common tasks to manage software distribution to clients.
+
+Overall, OpenGnSys is a modular system that integrates a set of interrelated components and can be adapted to a variety of work settings possible. These components consist of standard services (file servers, web, database, DHCP, PXE, ...) and custom-developed tools for the project (cloning engine, console web, browser ad hoc, management demons repository and server, ...) which in combination offer everything OpenGnSys system.
+
+ * OpenGnSys Server
+ Basic service cloning system (DHCP, NFS/Samba, PXE, database, etc..) Necessary for the boot process and initial configuration of the clients.
+
+ * OpenGnSys Administrator
+ Centralized management web console (web pages, web services, etc.) with support for delegated administration, allowing control of all system components.
+
+ * OpenGnSys Repository Manager
+ Manager repository of images for each of the administrative units defined in the module OpenGnSys Administrator. There may be one or more modules depending on the model of the organization defined.
+
+ * OpenGnSys Client Agent
+ Executing agent of orders in the client, which integrates the following features:
+ - Graphical interface to select options predefined by the administrator.
+ - Interactive execution of Cloning Engine functions in administrator mode.
+ - Execution of the tasks sent from the OpenGnSys Administrator module.
+
+ * OpenGnSys Clonning Engine
+ Motor function libraries cloning, installation and startup of the client operating systems.
+
+ * OpenGnSys Installer
+ Software installation, upgrade and removal system which includes the settings generator, the clients boot generator, the component package builder, etc.
+
+
+Scenarios
+---------
+
+OpenGnSys is a modular system that can be used in different scenarios within an Institution, both educational and organizational.
+
+ * Educational Scenarios: OpenGnSys can lend support to some of the educational settings defined by the Working Group-Net Teaching RedIRIS.
+
+ - Classroom teaching: allowing the management and implementation of software installation on the computers of teachers, with ability to customize the settings according to user requirements.
+ - Classroom teaching ICT Classrooms: implementing methods independent support for PCs of students and teachers.
+ - Self-learning ICT Classrooms: methods of deployment computers for students, grouped according to the needs identified for each position or for each user profile.
+
+ * Organizational Scenarios: The project can be implemented to provide support in other settings defined in an Institution, such as:
+
+ - Information Services.
+ - Helpdesk for employment computers.
+ - Servers Deployment in Data Center.
+
+
+Origins
+
+OpenGnSys born in May 2009 after the Working Groups RedIRIS held in Malaga as an effort to integrate several projects in development:
+
+ * Brutalix, University of Zaragoza
+ * Entorno Avanzado de Clonación (EAC), University of Málaga.
+ * Web Hidra Interface, University of Seville.
+
+
diff --git a/doc/VERSION.txt b/doc/VERSION.txt
index 1ccdeba1..a0448f42 100644
--- a/doc/VERSION.txt
+++ b/doc/VERSION.txt
@@ -1 +1 @@
-OpenGnSys 1.0.2a
+OpenGnSys 1.0.3