Prerequisitos para la instalación

1. Un computador con procesador de 64 bits de la familia x86 (hay imágenes de versiones anteriores a la 4.9 para procesadores de 32 bits).

2. Componentes básicos para la instalación en un medio que pueda acceder. Es decir en uno de los siguientes:

   • USB: Puede descargar una imagen de https://adJ.pasosdeJesus.org/pub/AprendiendoDeJesus por ejemplo con el programa ftp de OpenBSD:

         ftp -C https://adJ.pasosdeJesus.org/pub/AprendiendoDeJesus/AprendiendoDeJesus6.8-amd64.usb
     

     o bien con el programa wget:

         wget -c https://adJ.pasosdeJesus.org/pub/AprendiendoDeJesus/AprendiendoDeJesus6.8-amd64.usb
     

     Usando estas formas podrá reanudar la transferencia en caso de que se interrumpa. Otra posibilidad que tiene que puede acelerar la descarga, pero sin posibilidad de reanudar en caso de que se interrumpa, es emplear el programa rsync:

         rsync -vz rsync://ftp.pasosdeJesus.org/AprendiendoDeJesus/AprendiendoDeJesus6.8-amd64.usb .
     

     Note que hay un punto al final, que indica que el destino de la copia es el directorio actual. Si desea ver que otros archivos hay en el mismo directorio de esa imagen ISO utilice:

         rsync -vz rsync://ftp.pasosdeJesus.org/AprendiendoDeJesus/
     

     Utilice la imagen descargada para grabarla en una memoria USB y arrancar con esta. Para grabar la imagen en una memoria desde adJ o desde Linux utilice dd. Si por ejemplo en adJ la USB es /dev/sd2c (verifique dispositivo con dmesg y remplace):

     doas dd if=AprendiendoDeJesus-6.8-amd64.usb of=/dev/sd2c bs=1M

     Este proceso puede ser demorado, puede ver el progreso con

     doas pkill -SIGINFO dd

   • Imagen CDROM. Aunque con esta no podrá instalar en modo UEFI, sino únicamente en modo CSM (que desde varias configuraciones UEFI se llama modo Legacy). También la encuentra en https://adJ.pasosdeJesus.org/pub/AprendiendoDeJesus y puede quemarla en un DVD con algún programa que soporte quemar imágenes ISO de otros sistemas operativos (por ejemplo con Brasero desde Linux).

   • O bien partición ext2 (de Linux), ffs (de OpenBSD) o FAT (de DOS y Windows) con juegos de instalación.

   • O bien conexión a Internet o una Intranet con una tarjeta de red (el disco de instalación NO soporta PPP ni SLIP) y un espejo del servidor FTP o HTTP que se pueda acceder rápidamente desde su computador.

   Aunque es posible realizar la descarga de los medios de instalación recomendamos donar para apoyar los proyectos OpenBSD y adJ. La estructura del CD oficial de OpenBSD tiene derechos de reproducción restrictivos —sólo la estructura, las fuentes son de libre redistribución en su mayoría cubiertas por la licencia BSD. Por esto en caso de comprar CDs oficiales cómprelos sólo a los desarrolladores o a redistribuidores autorizados. En el caso de OpenBSD ver http://www.openbsd.org y en el caso de adJ ver https://aprendiendo.pasosdeJesus.org.

3. Contar con hardware soportado. La mayoría de componentes típicos son soportados, aunque hay excepciones (especialmente hay dificultad con varias tarjetas de red inalámbrica) por lo que antes de comprar se recomienda consultar la lista completa de los dispositivos para procesadores amd64 que son soportados en: http://www.openbsd.org/amd64.html.

4. Una partición primaria de al menos 13GB en un disco duro, Si planea comprar un computador con otro sistema operativo puede solicitarle al vendedor que le deje disponible una partición con estas características. Durante la instalación podrá asignar a esta partición el tipo OpenBSD (A6), podrá dividirla en etiquetas que son como subparticiones lógicas sólo visibles en OpenBSD (e.g para /, /home y /var) sobre cada una de las cuales podrá emplear el sistema de archivos de OpenBSD (FFS2 - Enhanced Fast File System o ufs en terminología Linux). También podrá montar particiones de otros sistemas operativos, por ejemplo ext2 está bien soportado, o tener un sistema dual (ver ).

   Si en su computador no tiene una partición disponible, puede intentar cambiar el tamaño de una existente para liberar espacio y crear una nueva (sacando copia de respaldo antes de estas operaciones). Si una de las particiones tiene sistema FAT o FAT32 puede usar fips. Si la partición que desea redimensionar tiene formato ext2fs (Linux) puede usar parted o resize2fs. En el caso de particiones NTFS (Windows recientes) puede usar ntfsresize desde un sistema Linux o arrancando con un disquete como PAUD, o bien si prefiere utilidades gráficas para reparticionar puede arrancar desde un pequeño CD de rescate como RIP o por ejemplo con un CD instalador de Ubuntu.

5. Leer la fe de erratas que incluye soluciones a eventuales problemas que tendrá durante la instalación o cuando concluya junto con soluciones: http://aprendiendo.pasosdejesus.org/?id=AdJ+6.8+-+Aprendiendo+de+Jesus+6.8

Ayudas para la instalación

Es muy recomendable consultar guía de instalación de OpenBSD.

Si tiene la USB o el DVD oficial, configure su UEFI para que arranque por este y reinicie[4].

Recuerde que si usará el DVD debe dejar su UEFI en modo CSM o Legacy. Tenga en cuenta que aún con USB de arranque el modo UEFI de algunos computadores no permite el arranque de OpenBSD/adJ en modo seguro – Secure Boot (ver por ejemplo https://dhobsd.defensor.info/instalar-adj-6-8b1-en-un-portatil-lenovo-e490.html) en tal caso puede deshabilitar ese modo desde la configuración UEFI (puede intentar rehabilitarlo después de que este operando su OpenBSD/adJ siguiendo las instrucciones de http://daemonforums.org/showthread.php?t=9559). También podría encontrar UEFIs que no permiten el arranque de OpenBSD/adJ desde USB (por ejemplo si está virtualizando con QEMU y el UEFI OVMF o como se reporta con algunos computadores en https://marc.info/?l=openbsd-misc&m=159039904132502&w=2) y en tales casos configure el UEFI en modo CSM o Legacy (esto será posible siempre que no haya otros sistemas operativos ya instalados que tengan modo UEFI).

La USB contiene un sistema OpenBSD mínimo que detectará automáticamente el hardware y lo guiará en el proceso de instalación. Si había creado con anterioridad la partición primaria para OpenBSD seguramente no tendrá inconveniente en esta instalación, basta que tenga en cuenta algunas diferencias entre Linux y OpenBSD:

Instalación y configuración del sistema base

Arranque por el medio de instalación, su prompt será algo como

    boot>
    

Si no arranca de inmediato el medio de instalación intente con

    boot> boot bsd.rd

Una vez pueda iniciar un medio con un instalador, el sistema reconocerá las partes de su computador y esperará algunas respuestas de su parte, como si desea instalar, actualizar o iniciar un intérprete de órdenes para rescatar un sistema:

También podrá elegir distribución del teclado, por ejemplo el teclado típico con "ñ" y junto a esta un "{" corresponde a "es". El instalador a continuación le permitirá configurar dispositivo de red que usará, clave para la cuenta root y detalles para el inicio del sistema entre los cuales es importante que confirme el uso de xdm, la zona horaria (por defecto America/Bogota) y que cree una cuenta del sistema (en este ejemplo servidor) que posteriormente podrá configurar como cuenta de usuario administrador (sshd es un servicio que permite operación remota con ssh, ntpd permite sincronizar reloj con servidores para esto, X-Window es el entorno gráfico, xdm es el programa que tras iniciar el entorno gráfico le permite autenticarse).

En las capturas de pantalla de ejemplo hay un sólo disco duro que se usará completo para OpenBSD, es decir tendrá una sola partición del BIOS que abarca todo el disco. De no usarse completo el instalador ingresará al programa fdisk que le permitirá especificar la partición del BIOS que destinará para OpenBSD (en fdisk la orden "h" le presentará una breve ayuda).

Tras definir el área del disco dedicada a OpenBSD podrá definir etiquetas o subparticiones para el área de OpenBSD con el programa disklabel. Aunque hay un modo de autolocalización de las subparticiones se recomienda que cree su propio esquema de subparticiones dejando al menos 10GB para la partición donde estará /usr/local y al menos 1.2GB para /var. La orden "h" en disklabel presenta una breve ayuda. En el ejemplo siguiente se crean 4 subparticiones, la primera (a) siempre debe ser para el sistema raíz (/), la segunda (b) siempre debe ser área de intercambio o swap (es indispensable tenerla o podrá tener problemas de memoria posteriormente con algunas aplicaciones), la partición c representa la partición del BIOS completa y no debe tocarse, la tercera (d) corresponderá a /home y la cuarta (e) a /var[5]. Note que con este esquema los programas y sus datos estáticos (típicos de los directorios /bin, /sbin y /usr quedarán en la subpartición a. Los datos de usuario típicamente en /home quedarán en la subpartición d, y los datos variables de los programas (e.g páginas web, bases de datos, bitácoras) típicos de /var quedarán en la subpartición e.

Note que de cada subpartición debe especificar desplazamiento (i.e sector en el que comienza) y tamaño (i.e cantidad de sectores que ocupa). Tenga en cuenta que un sector es de 512bytes, así que aproximadamente 2’000.000 de sectores corresponden a 1GB. En el ejemplo anterior / es de aproximadamente 10GB, la partición de intercambio es de 500MB, /home de 1GB y /var aproximadamente de 2.1GB.

Después de elegir subparticiones el instalador formateará las subparticiones. Después podrá especificar la ruta donde están los juegos de instalación (en el caso de la distribución Aprendiendo de Jesús es /) y elegir los que instalará. Podrá elegir entre:

la instalación de los componentes indispensables (base68 y etc68) requiere cerca de 100MB, y la instalación de todos requiere alrededor de 300MB.

Una vez se instalen el kernel genérico (/bsd) y los componentes que eligió el instalador preparará el directorio /dev de dispositivos y cambiará la partición de OpenBSD para que pueda arrancar el sistema en caso de que sea la partición activa[6]. Puede entonces apagar con la orden halt -p, retirar el CD y volver a iniciar para entrar al sistema instalado. Si tienes problemas para ingresar a OpenBSD puede arrancar con el CD de instalación y cuando este comenzando a cargar expulsarlo para quedar en la linea de espera:

    boot>
          

En la que puede teclear boot hd0a:bsd

Si en su computador usa otro sistema operativo, ejecute el programa de configuración de algún administrador de arranque para asegurarse de permitir elegir OpenBSD o el otro o los otros sistemas que tenga (e.g GRUB o LILO si también usa Linux ver , XOSL si usa Windows 95/98/ME. Si usa Windows NT o XP puede ser con el manejador de arranque de ese sistema ver , si usa Windows Vista, 7, 8, 8.1 y 10 puede ser con EasyBCD).

Una vez ingrese verá xdm como se presenta a continuación (siempre y cuando haya elegido iniciarlo durante la instalación y mientras su tarjeta gráfico y monitor sean autodetectados).

Instalación del resto de adJ

Tras instalar el sistema base y reiniciar su computador, puede ingresar a la cuenta del usuario administrador que creó y puede completar la instalación ejecutando desde una terminal:

    /inst-adJ.sh

Note que la J es mayúscula (en sistemas tipo Unix los nombres de archivos y programas son sensibles a la capitalización).

Este procedimiento permite instalar y actualizar adJ, así que puede ejecutarlo cuantas veces lo requiera para completar la instalación o una actualización. El archivo de ordenes /inst-adJ.sh lo guiará en la instalación del resto del sistema con preguntas típicamente de si o no, como se presenta en las siguientes capturas de pantalla de ejemplo:

adJ puede configurar por defecto 2 imágenes cifradas, una para almacenar bases de datos de PostgreSQL (directorio /var/postgresql) y otra para almacenar copias de respaldo de la base de datos y otros datos que usted requiera (directorio /var/www/resbase). Cada una de estas imágenes tienen asociadas claves para cifrar y descifrar, estas claves debe suministrarlas típicamente durante el arranque o posteriormente ejecutando:

    /etc/init.d/montaencpos
    /etc/init.d/montaencres

El servidor web nginx será configurado con SSL por lo que debe dar detalles para el certificado como se presenta en la siguiente captura de pantalla.

Después es recomendable que consulte man afterboot que incluye una lista de chequeo de cosas por hacer después de la instalación https://man.openbsd.org/afterboot.

Inicio del sistema

El arranque se realiza de acuerdo al archivo /etc/rc (que no debe modificarse), este archivo en particular lee variables definidas por el usuario en /etc/rc.conf.local donde puede especificar que servicios desea iniciar durante el arranque. Un servicio es un programa que se mantiene en operación mientras el computador está encendido, esperando conexiones o requerimientos de programas o de otros servicios para atenderlos, por ejemplo un servidor web es un servicio (que responde a requerimientos de páginas web en cualquier momento que un usuario las realice). /etc/rc también iniciará los servicios típicos del sistema y algunos proveídos por paquetes y después ejecutará /etc/rc.local.

En el archivo /etc/rc.conf.local pueden definirse variables asociadas a servicios (puede verse el listado de variables posibles para el sistema base en /etc/rc.conf), si el valor de una variable es NO el servicio relacionado no se activa, mientras que otro valor activa el servicio y es pasado como parámetro (si no se desean parámetros adicionales puede simplemente asignarse ""). Por ejemplo para iniciar XDM en cada arranque:

    xdm_flags=""
    

Los servicios proveídos por paquetes que son iniciados se especifican en la variable pkg_scripts, que se define en el archivo /etc/rc.conf.local. Los servicios tanto del sistema base como de paquetes típicamente tiene un archivo en el directorio /etc/rc.d. Estos archivos de ordenes pueden ejecutarse con una de las siguientes opciones (llamadas acciones):

Otra forma de manejar servicios y sus variables (especificadas en /etc/rc.conf.local) es con rcctl. Esta herramienta maneja cada servicio con 5 variables que indican como ejecutarlo: class (clase de login con la que inicia), flags (opciones para iniciarlo), status (estado habilitado o no), timeout (tiempo de espera para arranque), user (usuario que lo inicia).

Veamos ejemplos de su uso:

En adJ el archivo de ordenes /etc/rc.local además de poder contener acciones por realizar en el arranque, permite reiniciar servicios que se hayan detenido. Por esto tras detener un servicio (bien intencionalmente o por error) puede ejecutar este archivo de ordenes para reiniciarlo con:

    doas sh /etc/rc.local
          

Configuración de Xorg

Si durante la instalación eligió usar X-Window y xdm, e instaló los juegos de instalación de X-Window (i.e xbase68, xfont68, xserv68, xshare68), y si su tarjeta fue correctamente configurada, al arrancar iniciará en el ambiente gráfico.

Xorg puede también leer la configuración de su tarjeta de video, monitor, teclado y ratón del archivo /etc/X11/xorg.conf, por lo que este es el archivo que debe generar y configurar en caso de que la autodetección de Xorg no opere con su hardware.

Si no logra ingresar al modo gráfico revise la bitácora de errores del servidor X-Window con:

    doas less /var/log/Xorg.0.log

y edite el archivo de configuración, siguiendo las instrucciones de

    man xorg.conf 

hasta lograr que opere, puede editar por ejemplo con:

    doas mg /etc/X11/xorg.conf

Una vez le funciona (entra a modo gráfico del cual puede salir con Ctrl-Alt-BackSpace) ejecutando

    doas xdm
    

Si persisten sus dificultades, puede buscar en Internet una configuración correcta o solicitar el archivo de configuración a alguien que le funcione o enviar la bitácora /var/log/Xorg.0.log a un grupo de usuarios. Unos cambios que suelen funcionar son:

1. Si en la bitácora /var/log/Xorg.0.log se recomienda, agregar

       machdep.allowaperture=2
   

   o bien

       machdep.allowaperture=1
   

   hágalo en /etc/sysctl.conf, según lo recomendado en la bitácora.

   Elegir un monitor y editar el archivo para quitar el comentario que deja en la frecuencia horizontal –es decir el símbolo # al comienzo de la línea.

2. Escoger vesa como controlador y tarjeta de video.

3. En casos extremos puede comenzar con un archivo de configuración típico como el que se presenta a continuación (para teclado en español, tarjeta de video que soporta VESA, y un monitor que no requiere especificar rangos):

   Section "ServerLayout" Identifier "X.org Configured" Screen 0 "Screen0" 0 0 InputDevice "Mouse0" "CorePointer" InputDevice "Keyboard0" "CoreKeyboard" EndSection

   Section "Files" # RgbPath "/usr/X11R6/share/X11/rgb" # ModulePath "/usr/X11R6/lib/modules" FontPath "/usr/X11R6/lib/X11/fonts/misc/" FontPath "/usr/X11R6/lib/X11/fonts/TTF/" FontPath "/usr/X11R6/lib/X11/fonts/Type1/" FontPath "/usr/X11R6/lib/X11/fonts/CID/" FontPath "/usr/X11R6/lib/X11/fonts/75dpi/" FontPath "/usr/X11R6/lib/X11/fonts/100dpi/" FontPath "/usr/local/lib/X11/fonts/local/" FontPath "/usr/local/lib/X11/fonts/Speedo/" FontPath "/usr/local/lib/X11/fonts/TrueType/" FontPath "/usr/local/lib/X11/fonts/freefont/" EndSection

   Section "Module" Load "dbe" Load "freetype" EndSection

   Section "InputDevice" Identifier "Keyboard0" Driver "kbd" Option "XkbLayout" "es" # Si el teclado fuera latinoamericano en vez de "es" usar "latam" Option "XkbModel" "pc105" EndSection

   Section "InputDevice" Identifier "Mouse0" Driver "mouse" Option "Protocol" "wsmouse" Option "Device" "/dev/wsmouse" # Si es serial usar protocolo "Microsoft" y dispositivo "/dev/tty00" Option "ZAxisMapping" "4 5" EndSection

   Section "Monitor" # HorizSync 30.0 - 70.0 # VertRefresh 50.0 - 90.0 # Puede funcionar quitar el comentario en HorizSync (vea /var/log/Xorg.0.log) Identifier "Monitor0" Option "DPMS" EndSection

   Section "Device" Identifier "Card0" Driver "vesa # BusID"PCI:0:1:0" EndSection

   Section "Screen"
   Identifier "Screen0" Device "Card0" Monitor "Monitor0" DefaultDepth 16 SubSection "Display" Viewport 0 0 Depth 1 EndSubSection SubSection "Display" Viewport 0 0 Depth 4 EndSubSection SubSection "Display" Viewport 0 0 Depth 8 EndSubSection SubSection "Display" Viewport 0 0 Depth 15 EndSubSection SubSection "Display" Viewport 0 0 Depth 16 Modes "1024x768" EndSubSection SubSection "Display" Viewport 0 0 Depth 24 EndSubSection EndSection

En este ejemplo mire que en la sección del monitor, la línea HorizSync está comentada (el símbolo # al comienzo de la línea) por lo que no se usa ese parámetro de configuración. De funcionar en su caso este archivo iniciara en 1024 x 768 con colores de 16 bits, porque la profundidad de color por defecto especificada es esa (DefaultDepth 16) y el primer modo indica esa resolución (Modes "1024x768").

Algunas tarjetas antiguas no son soportadas por Xorg pero si por el servidor XFree86 3.3.6, que podrá encontrar en versiones de OpenBSD anteriores a 3.7. Este último emplea normalmente el archivo de configuración /etc/XF86Config que puede generarse con ayuda de XF86Setup o bien en modo texto con xf86config3.

Para la configuración del ratón tenga en cuenta que los ratones PS/2 y USB se usan con el protocolo wsmouse, dispositivo /dev/wsmouse, mientas que diversos ratones seriales emplean el protocolo Microsoft y uno de los dispositivos seriales /dev/tty00 o /dev/tty01.

Una vez logre configurar Xorg puede activar el administrador de vistas XDM permanentemente agregando la siguiente línea al archivo /etc/rc.conf.local (créelo si no existe):

    xenodm_flags="" 

    cp font/vga.pcf /usr/X11R6/lib/X11/fonts/misc
    compress /usr/X11R6/lib/X11/fonts/misc/vga.pcf
    mkfontdir /usr/X11R6/lib/X11/fonts/misc
    xset fp rehash