Compare commits
7 Commits
admin-clon
...
main
| Author | SHA1 | Date |
|---|---|---|
 Luis Gerardo Romero Garcia
|
1859a3ba28 | |
 Angel Rodriguez
|
645d476b98 | |
|
Luis Gerardo Romero Garcia
|
23bac1c58c | |
|
Angel Rodriguez
|
4725fa1626 | |
|
Angel Rodriguez
|
44e4eaed6f | |
|
Luis Gerardo Romero Garcia
|
453b1446eb | |
|
Luis Gerardo Romero Garcia
|
fd06d96f92 |
Binary file not shown.
|
After Width: | Height: | Size: 84 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 116 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 88 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 74 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 68 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 148 KiB After Width: | Height: | Size: 96 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 162 KiB After Width: | Height: | Size: 75 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 63 KiB After Width: | Height: | Size: 182 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 150 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 122 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 178 KiB After Width: | Height: | Size: 141 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 142 KiB After Width: | Height: | Size: 156 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 109 KiB After Width: | Height: | Size: 85 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 186 KiB After Width: | Height: | Size: 112 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 133 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 77 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 88 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 98 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 81 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 84 KiB |
|
|
@ -0,0 +1,302 @@
|
|||
# Boot Module (ogboot)
|
||||
|
||||
The ogboot module is responsible for managing the network boot process for OpenGnsys clients, using the iPXE system. This component serves the necessary binaries for booting (such as **undionly.kpxe** or **ipxe.efi**), manages the ogLive operating system, and generates custom boot instructions for each client based on their configuration.
|
||||
|
||||
Its main features include:
|
||||
|
||||
- Managing ogLive versions (install, delete, set as default).
|
||||
|
||||
- Generating custom boot instructions per client through reusable templates.
|
||||
|
||||
- Exposing ogLive files (kernel and initialization image) via HTTP for client boot.
|
||||
|
||||
The boot architecture is determined by both the client configuration parameters, parameters inherited from their Organizational Unit, and detection performed by the DHCP server (ogDHCP) based on the client's architecture.
|
||||
|
||||
|
||||
## ogboot Module Status
|
||||
From the top menu, you can access the Global Status panel, which shows the current status of ogboot.
|
||||
|
||||
|
||||
In this view you can check:
|
||||
|
||||
- Reserved disk usage for ogLive and boot files.
|
||||
|
||||
- Status of critical services (**tftpboot** and **nginx**).
|
||||
|
||||
- List of installed ogLive images, with their kernel, architecture, and version.
|
||||
|
||||
## ogLive Management
|
||||
|
||||
From the lateral ogLive section, it is possible to manage the different versions of the operating system that will be offered to clients when booting.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Each entry shows:
|
||||
|
||||
- Image name (e.g., ogLive-6.8.0-31-generic-20250519)
|
||||
|
||||
- Whether it's marked as the default image
|
||||
|
||||
- Installation status
|
||||
|
||||
- Creation date
|
||||
|
||||
Actions: view details, delete, or change the default image
|
||||
|
||||
!!! warning "Warning"
|
||||
Only one ogLive image can be marked as default. This will be the one used in boot templates when no specific version is specified.
|
||||
It is not possible to delete an image marked as default.
|
||||
|
||||
|
||||
|
||||
### Adding and installing a new ogLive image
|
||||
To add a new ogLive version to the system, follow these steps from the lateral ogLive menu:
|
||||
|
||||
|
||||
1. Click the "Add OgLive" button to select one of the images detected in the system.
|
||||
|
||||
|
||||
|
||||
2. A window will open with a dropdown list of available images that are not yet registered in the interface. Select one of the available ogLives and press "Add".
|
||||
|
||||
|
||||
|
||||
3. Once added, the image will appear in the list with "Not installed" status.
|
||||
|
||||
|
||||
|
||||
From here you can view it, delete it, or deploy the actions menu to proceed with its installation.
|
||||
|
||||
4. Install ogLive image
|
||||
Click on the actions icon (≡) and select "Install".
|
||||
|
||||
|
||||
|
||||
This will start the installation process, which will register the image and prepare it to be used during client boot.
|
||||
|
||||
5. Once the process is complete, the status will change to "Installed" and the image will be ready for use.
|
||||
|
||||
|
||||
|
||||
!!! note "Note"
|
||||
You can mark the new image as default if you want it to be used automatically in boot templates that don't specify a specific version.
|
||||
|
||||
|
||||
## PXE Template Management
|
||||
From the lateral PXE Templates menu, you access the management of base files that define how each client will boot. These templates are used to generate files customized by MAC address and allow selecting the boot method that the equipment should use.
|
||||
|
||||
|
||||
|
||||
|
||||
This view shows:
|
||||
|
||||
- Template name
|
||||
|
||||
- Synchronization status with the file system
|
||||
|
||||
- Whether it's the default template
|
||||
|
||||
- Creation date
|
||||
|
||||
- Available actions: view, edit, or delete
|
||||
|
||||
### Default available templates
|
||||
The system comes with several predefined templates located at:
|
||||
|
||||
```
|
||||
/opt/opengnsys/ogboot/tftpboot/ipxe_scripts/templates/
|
||||
```
|
||||
The default templates are:
|
||||
|
||||
| Template | Description |
|
||||
|---------------------------|-----------------------------------------------------------------------------|
|
||||
| firstDisk | Boots from the system's first disk |
|
||||
| firstDisk_firstPartition | Boots from the first partition of the first disk |
|
||||
| firstDisk_secondPartition | Boots from the second partition of the first disk |
|
||||
| firstDisk_thirdPartition | Boots from the third partition of the first disk |
|
||||
| oglive | Boots the ogLive system from network (HTTP) |
|
||||
| ogliveCache | Boots ogLive from the client's local cache (/opt/opengnsys/cache/oglive/) |
|
||||
|
||||
These templates are used as a base to generate files customized per client, replacing the variables contained in them with specific values based on the equipment configuration.
|
||||
|
||||
|
||||
### PXE template variables
|
||||
The boot templates available in ogboot contain variables that will be automatically substituted when generating the custom boot file for each client. This allows reusing generic templates for multiple computers, dynamically adapting the values.
|
||||
|
||||
Example template: oglive
|
||||
```
|
||||
#!ipxe
|
||||
set timeout
|
||||
set timeout-style hidden
|
||||
|
||||
set ISODIR __OGLIVE__
|
||||
set default 0
|
||||
set kernelargs __INFOHOST__
|
||||
|
||||
:try_iso
|
||||
kernel http://__SERVERIP__/tftpboot/${ISODIR}/ogvmlinuz ${kernelargs} || goto fallback
|
||||
initrd http://__SERVERIP__/tftpboot/${ISODIR}/oginitrd.img
|
||||
boot
|
||||
|
||||
:fallback
|
||||
echo "OgLive default"
|
||||
set ISODIR ogLive
|
||||
kernel http://__SERVERIP__/tftpboot/${ISODIR}/ogvmlinuz ${kernelargs}
|
||||
initrd http://__SERVERIP__/tftpboot/${ISODIR}/oginitrd.img
|
||||
boot
|
||||
```
|
||||
### Available variables
|
||||
|
||||
| Variable | Description |
|
||||
|---------------|------------------------------------------------------------------------------------------------------------|
|
||||
| __SERVERIP__ | ogboot server IP address (HTTP/TFTP server hosting the ogLive) |
|
||||
| __OGLIVE__ | Name of the directory where the selected ogLive image is mounted |
|
||||
| __INFOHOST__ | Set of kernel parameters customized for the client (IP, hostname, ogcore, ogrepo, etc.) |
|
||||
|
||||
These variables are automatically substituted when the boot file for a client (for example, 01-00:11:22:33:44:11) is generated from the selected template.
|
||||
|
||||
In PXE templates used by ogboot, the __INFOHOST__ variable is automatically substituted with a string of kernel parameters. These parameters are generated by the ogcore component from the client configuration and its Organizational Unit.
|
||||
|
||||
- Substitution example
|
||||
```
|
||||
set kernelargs ro boot=oginit quiet splash irqpoll acpi=on og2nd=sqfs ogprotocol=smb ogactiveadmin=true ogdebug=true ogtmpfs=15 oglivedir=${ISODIR} LANG=es_ES.UTF-8 ip=192.168.3.11:172.17.8.35:192.168.3.1:255.255.255.0:PC11:eth0:none group=Aula_Ciencias ogrepo=172.17.8.35 ogcore=192.168.2.2 oglive=172.17.8.35 oglog=192.168.68.51 ogshare=172.17.8.35 ogprof=false hardprofile=default ogdns=192.168.3.1 vga=791
|
||||
```
|
||||
|
||||
- Parameter details
|
||||
|
||||
| Parameter | Origin and function |
|
||||
|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
|
||||
| ip= | Client IP address along with network configuration, in the format:<br>`<client-ip>:<server-ip>:<gateway>:<netmask>:<hostname>:<device>:<autoconf>` |
|
||||
| ├── client-ip | IP address assigned to the client |
|
||||
| ├── server-ip | ogboot server IP address (TFTP/HTTP server) |
|
||||
| ├── gateway | Subnet router IP |
|
||||
| ├── netmask | Network mask |
|
||||
| ├── hostname | Client name (PC11, for example) |
|
||||
| ├── device | Network interface (e.g., eth0) |
|
||||
| └── autoconf | IP configuration method (none, dhcp, etc.) |
|
||||
| oglivedir | Name of the ogLive directory to be used |
|
||||
| ogcore | ogcore server IP |
|
||||
| oglive | ogboot server IP (where the ogLives are located) |
|
||||
| ogrepo | Image repository server IP |
|
||||
| oglog | oglog server IP (centralized logs) |
|
||||
| ogshare | IP address for shared storage |
|
||||
| group | Client's Organizational Unit name |
|
||||
| hardprofile | Client hardware profile (default if none assigned) |
|
||||
| ogdns | DNS server IP |
|
||||
| ogntp | NTP server IP (if defined) |
|
||||
| ogProxy | Proxy address (if applicable) |
|
||||
| netiface | Network interface (e.g., eth0) |
|
||||
| LANG | Language (es_ES.UTF-8) |
|
||||
| vga=791 | Screen resolution |
|
||||
| Other common parameters | `ro boot=oginit quiet splash irqpoll acpi=on og2nd=sqfs ogprotocol=smb ogtmpfs=15` |
|
||||
|
||||
|
||||
### Creating a new PXE template
|
||||
The ogboot module allows adding new PXE templates from the graphical interface, either starting from scratch or using one of the predefined models.
|
||||
|
||||
1. To add a new template:
|
||||
|
||||
2. Access the lateral PXE Templates menu
|
||||
|
||||
3. Click "Add template"
|
||||
|
||||
4. Fill out the form that opens
|
||||
|
||||
|
||||
|
||||
#### Template models
|
||||
The interface allows loading a base model by clicking the "Load template model" button, which will insert one of the two available models into the editor:
|
||||
|
||||
- ogLive model (HTTP or TFTP network boot)
|
||||
This model is designed to boot ogLive from an HTTP or TFTP server. It uses the __SERVERIP__, __OGLIVE__, and __INFOHOST__ variables, which will be automatically substituted by ogboot when generating the custom file.
|
||||
|
||||
```
|
||||
#!ipxe
|
||||
set timeout 0
|
||||
set timeout-style hidden
|
||||
set ISODIR __OGLIVE__
|
||||
set default 0
|
||||
set kernelargs __INFOHOST__
|
||||
:try_iso
|
||||
kernel http://__SERVERIP__/tftpboot/${ISODIR}/ogvmlinuz ${kernelargs} || goto fallback
|
||||
initrd http://__SERVERIP__/tftpboot/${ISODIR}/oginitrd.img
|
||||
boot
|
||||
|
||||
:fallback
|
||||
set ISODIR ogLive
|
||||
kernel http://__SERVERIP__/tftpboot/${ISODIR}/ogvmlinuz ${kernelargs}
|
||||
initrd http://__SERVERIP__/tftpboot/${ISODIR}/oginitrd.img
|
||||
boot
|
||||
```
|
||||
|
||||
|
||||
- Disk boot model
|
||||
This second model detects whether the system is in BIOS or UEFI mode and boots from the first available disk, using grub.exe or grubx64.efi.
|
||||
|
||||
|
||||
```
|
||||
#!ipxe
|
||||
iseq ${platform} efi && goto uefi_boot || goto bios_boot
|
||||
|
||||
:bios_boot
|
||||
echo "Running in BIOS mode - Booting first disk"
|
||||
chain http://__SERVERIP__/tftpboot/grub.exe --config-file="title FirstHardDisk;chainloader (hd0)+1;rootnoverify (hd0);boot" || echo "Failed to boot in BIOS mode"
|
||||
exit
|
||||
|
||||
:uefi_boot
|
||||
echo "Running in UEFI mode - Booting first disk"
|
||||
sanboot --no-describe --drive 0 --filename \EFI\grub\Boot\grubx64.efi || echo "Failed to boot in UEFI mode"
|
||||
exit
|
||||
```
|
||||
!!! note "Note"
|
||||
These models are editable and serve as a base to define other more complex variants (for example, boot by specific partition or recovery modes).
|
||||
|
||||
### Viewing template content
|
||||
Click the eye icon to view the complete content of a PXE template.
|
||||
|
||||
|
||||
|
||||
### Editing an existing template
|
||||
Click the pencil icon to edit the name or content of the template. The editor will open with the current content preloaded.
|
||||
|
||||
|
||||
|
||||
### Deleting a template
|
||||
Click the trash icon and confirm deletion to remove the template from the system.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Client Templates (Boot PXE)
|
||||
|
||||
Each client can have a specific boot file assigned based on a template. These files are named 01-<MAC> and stored in /opt/opengnsys/ogboot/tftpboot/ipxe_scripts/.
|
||||
|
||||
|
||||
|
||||
### Assigning template to a client
|
||||
From the lateral menu, access PXE Boot, where you can see all clients in an Organizational Unit (for example, "Aula Ciencias"):
|
||||
|
||||
|
||||
1. Select a template for each client from the Template column.
|
||||
|
||||
!!! note "Note"
|
||||
You can also apply a template to all clients using the top dropdown.
|
||||
|
||||
2. Click Save to generate the corresponding boot files.
|
||||
|
||||
|
||||
|
||||
These files are created with the name 01-<MAC> (for example, 01-00:11:22:33:44:55) and stored in:
|
||||
|
||||
```
|
||||
/opt/opengnsys/ogboot/tftpboot/ipxe_scripts/
|
||||
```
|
||||
The content of the generated file will be a copy of the corresponding template with variables substituted by the specific client values: IP address, ogLive, ogcore, etc.
|
||||
|
||||
!!! success "What we have learned"
|
||||
- What we have learned 1
|
||||
- What we have learned 2
|
||||
- What we have learned ...
|
||||
|
|
@ -1,249 +0,0 @@
|
|||
# CloneEngine Module
|
||||
|
||||
## Introduction
|
||||
CloneEngine is the component responsible for executing cloning, partitioning, creation, and restoration operations of images on clients registered in OpenGnsys. It acts as an execution engine that receives instructions from the web interface and translates them into commands that are executed on client computers.
|
||||
|
||||
It does not have its own visual interface, but operates transparently as a backend for management modules. Among its main functionalities are:
|
||||
|
||||
- Disk and partition preparation.
|
||||
|
||||
- Image creation and restoration.
|
||||
|
||||
- Boot configuration (BIOS/UEFI).
|
||||
|
||||
- Cache and inventory management.
|
||||
|
||||
- Execution of custom scripts.
|
||||
|
||||
These operations are executed in real-time or in a scheduled manner, and their results are reported through the web interface.
|
||||
|
||||
|
||||
|
||||
## Disk and Partition Management
|
||||
|
||||
### Introduction to partitioning in OpenGnsys
|
||||
Disk partitioning is one of the most delicate operations that the administrator can execute from the OpenGnsys web console. Its correct definition is essential to ensure compatibility with the images to be restored and guarantee that operating systems can boot properly.
|
||||
|
||||
The web interface allows you to remotely define the partition table of one or several disks of registered clients, using the visual partitioning wizard. Internally, the CloneEngine motor is responsible for applying this structure on the client, removing previous content and creating new partitions with the defined sizes and types.
|
||||
|
||||
!!! warning "Warning"
|
||||
Incorrect partitioning can render the client system inoperative, delete existing systems, or prevent restorations due to type or size incompatibilities.
|
||||
|
||||
### Previous considerations
|
||||
Before defining a partition table, it is recommended to consider:
|
||||
|
||||
- **Disk size**: verify that the total detected space is usable. It is recommended to test first on a model computer.
|
||||
|
||||
- **Environment (classroom or computer group)**: maintaining homogeneous partitioning structures facilitates maintenance.
|
||||
|
||||
- **Operating systems to restore**: ensure that the size and partition type is compatible with the corresponding image.
|
||||
|
||||
- **CACHE partition size**: dimension correctly if you want to use it as an intermediate container or for ogLive.
|
||||
|
||||
- **Partition table type**: the wizard automatically detects if it is MSDOS (BIOS) or GPT (UEFI) type, but its recreation can be forced.
|
||||
|
||||
- **Previous partitioning**: old structures or those created with external software may interfere. It is always recommended to test on a model.
|
||||
- Partition types and file systems:
|
||||
The interface allows you to configure for each partition:
|
||||
- Partition type (e.g., LINUX, WINDOWS, CACHE, EMPTY, EXTENDED, etc.).
|
||||
- File system type (e.g., EXT4, NTFS, CACHE, etc.).
|
||||
- Size in MB or percentage.
|
||||
- Format option.
|
||||
|
||||
|
||||
Compatibility summary table
|
||||
|
||||
| Partition type | Allowed file systems | Description |
|
||||
|------------------------|-----------------------------------------|----------------------------------------------------------|
|
||||
| EMPTY | EMPTY | Reserved space with no defined use |
|
||||
| CACHE | CACHE | Used as intermediate container by OpenGnsys |
|
||||
| LINUX | EXT4, BTRFS, XFS, ... | For GNU/Linux systems |
|
||||
| WINDOWS | NTFS, FAT32, HFAT32, ... | For Windows systems |
|
||||
| LINUX-SWAP | LINUX-SWAP | Linux swap area |
|
||||
| EXTENDED | – | BIOS only, allows adding more logical partitions (not implemented)|
|
||||
| FREEBSD, SOLARIS, … | Corresponding native systems | For alternative systems (not common) |
|
||||
|
||||
!!! note "Note"
|
||||
The system identifies CACHE partition as such, but internally uses an EXT4 file system with specific configuration.
|
||||
|
||||
|
||||
### The CACHE partition
|
||||
The CACHE partition is a special type of partition managed by OpenGnsys, which offers several essential functionalities for system efficiency:
|
||||
|
||||
- Intermediate image container:
|
||||
Allows saving operating system images locally, reducing time in subsequent restorations. It also acts as a buffer in Torrent-type transfers.
|
||||
|
||||
- Auxiliary container for ogLive:
|
||||
During PXE boot with ogLiveAdmin, the system can copy the kernel and initrd to this partition to reduce server dependency and improve boot times.
|
||||
|
||||
!!! warning "Warning"
|
||||
If the CACHE partition is formatted, images and ogLive temporary data are lost. It will be necessary to restart from ogLiveAdmin to regenerate them.
|
||||
|
||||
### Rules and recommendations
|
||||
|
||||
- Only one CACHE partition should exist per computer.
|
||||
|
||||
- In MSDOS partitions it must be in position 4 and be primary.
|
||||
|
||||
- In GPT partitions it can occupy any order, but its identifier will be the fourth.
|
||||
|
||||
- The minimum recommended size is 1.5 GB if it will only be used for ogLive.
|
||||
If you want to store images, dimension according to the estimated number and size of these.
|
||||
|
||||
|
||||
|
||||
### Accessing the wizard
|
||||
To access the partitioning wizard:
|
||||
|
||||
- Go to the Groups section from the side menu.
|
||||
|
||||
- Select an Organizational Unit.
|
||||
|
||||
- Click the ⋮ button on any client.
|
||||
|
||||
- In the dropdown menu, select the Partition and Format option.
|
||||
|
||||
|
||||
This will open the wizard in a new view.
|
||||
|
||||
|
||||
|
||||
### Form structure
|
||||
The wizard is divided into three main blocks:
|
||||
|
||||
- Selected clients
|
||||
At the top, the client (or group of clients) where the partition table will be applied is shown.
|
||||
|
||||
- Design of the new partition table
|
||||
Here the disk structure is defined:
|
||||
|
||||
- Available disk and its size.
|
||||
|
||||
- Firmware type (BIOS/UEFI).
|
||||
|
||||
- Partition table type: automatically detected (MSDOS or GPT).
|
||||
|
||||
- Editable partition list: type, file system, size (MB or %), and format option.
|
||||
|
||||
- Graphical disk distribution:
|
||||
On the right, a circular graph is shown with the total, free, and used space according to the current configuration.
|
||||
|
||||
|
||||
|
||||
|
||||
### Partition table design
|
||||
The following details the steps to design a partition table:
|
||||
|
||||
1. Select computers
|
||||
|
||||
In case you have selected several computers in the previous window when selecting Partition, these computers will appear in the upper dropdown. Clicking on a computer you can select or deselect in case you don't want to apply the partitioning command on a specific computer. The **Model** checkbox indicates that the selected computer will be used as a partitioning model and will load its partition table to the view dynamically. You can select a computer as Model and deselect it in case you don't want to partition it again but want to apply its partitioning configuration to the rest of the machines.
|
||||
|
||||
|
||||
|
||||
1. Select disk
|
||||
|
||||
In the upper left dropdown, choose the disk to partition (example: Disk 1 (80.00 GB)).
|
||||
|
||||
2. Firmware type and partition table
|
||||
|
||||
- Firmware: indicates if the computer is in BIOS or UEFI mode.
|
||||
|
||||
- Partition table: can be MSDOS or GPT, and is automatically assigned according to the firmware.
|
||||
|
||||
3. Add partitions
|
||||
|
||||
- Click the Add partition button if you are using GPT table.
|
||||
|
||||
4. For each partition:
|
||||
|
||||
- Define the partition type (e.g., LINUX, CACHE, WINDOWS, etc.).
|
||||
|
||||
- Select the file system (e.g., EXT4, NTFS, etc.).
|
||||
|
||||
- Enter the size, in MB or percentage.
|
||||
|
||||
- Format: if you want to format the partition after its creation.
|
||||
|
||||
5. Disk usage graph
|
||||
|
||||
- Make sure the free space is not negative.
|
||||
|
||||
- Leave free margin (recommended ≥ 1 GB) on large disks to avoid precision failures during the process.
|
||||
|
||||
|
||||
|
||||
!!! note "Note"
|
||||
In systems with MSDOS partition table, the maximum number of primary partitions is four. In GPT there is no such limit, but the identification of the CACHE partition as the fourth must be respected.
|
||||
|
||||
|
||||
|
||||
Execution options
|
||||
Once the disk structure is defined, you can:
|
||||
|
||||
- Execute the command directly on the computer.
|
||||
|
||||
- Generate instructions to apply them later (in a scheduled manner).
|
||||
|
||||
- Access advanced scheduling options if you want to include it in an action queue.
|
||||
|
||||
In case instructions are generated, these are shown in an editable block that can be reviewed before execution.
|
||||
|
||||
|
||||
|
||||
|
||||
# Cloning Engine
|
||||
|
||||
The Cloning Engine is a fundamental component that manages the complete image cloning process in our system. This component integrates several critical procedures that are described below.
|
||||
|
||||
It manages the complete lifecycle of images, from their creation to their deployment in production environments. This system automates complex tasks and guarantees consistency across all environments.
|
||||
|
||||
## Main Procedures
|
||||
|
||||
### Image Creation
|
||||
|
||||
For the detailed image creation procedure, consult the specific documentation:
|
||||
|
||||
[Create Image](DocumentacionCrearImage.md)
|
||||
|
||||
### Image Deployment
|
||||
|
||||
Image deployment follows a standardized protocol that ensures system integrity:
|
||||
|
||||
[Deploy Image](DocumentacionDeployImage.md)
|
||||
|
||||
## Integrated Workflow
|
||||
|
||||
The complete cloning process follows these steps:
|
||||
|
||||
1. Engine initialization
|
||||
1. Dependency verification
|
||||
2. Configuration loading
|
||||
3. Permission validation
|
||||
2. Image creation (see [detailed documentation](DocumentacionCrearImage.md))
|
||||
1. Base template selection
|
||||
2. Parameter configuration
|
||||
3. Image generation
|
||||
3. Integrity validation
|
||||
1. Checksum verification
|
||||
2. Automated testing
|
||||
3. Manual approval (if necessary)
|
||||
4. Image deployment (see [detailed documentation](DocumentacionDeployImage.md))
|
||||
1. Target environment selection
|
||||
2. Deployment sequence
|
||||
3. Post-deployment verification
|
||||
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
To resolve common problems during the cloning process, consult:
|
||||
|
||||
- [Create Image - Troubleshooting](DocumentacionCrearImage.md#troubleshooting)
|
||||
- [Deploy Image - Troubleshooting](DocumentacionDeployImage.md#troubleshooting)
|
||||
|
||||
## Additional References
|
||||
|
||||
For additional information about the Cloning Engine, consult:
|
||||
|
||||
- System administration guide
|
||||
- Cloning API documentation
|
||||
- Change logs and updates
|
||||
|
|
@ -0,0 +1,303 @@
|
|||
# Módulo de Arranque (ogboot)
|
||||
|
||||
El módulo ogboot es el encargado de gestionar el proceso de arranque por red de los clientes de OpenGnsys, utilizando el sistema iPXE. Este componente sirve los binarios necesarios para el arranque (como **undionly.kpxe** o **ipxe.efi**), gestiona el sistema operativo ogLive y genera instrucciones de arranque personalizadas para cada cliente en función de su configuración.
|
||||
|
||||
Entre sus principales características se encuentran:
|
||||
|
||||
- Gestionar las versiones de ogLive (instalar, borrar, marcar por defecto).
|
||||
|
||||
- Generar instrucciones de arranque personalizadas por cliente, mediante plantillas reutilizables.
|
||||
|
||||
- Exponer archivos de oglive (kernel e imagen de inicialización) por HTTP para el arranque de clientes.
|
||||
|
||||
La arquitectura de arranque se determina tanto por los parámetros de las configuración de los clientes, los parámetros heredados por su Unidad Organizativa a la que pertenecen y por la detección que realiza el servidor DHCP (ogDHCP) en función de la arquitectura del cliente.
|
||||
|
||||
|
||||
## Estado del módulo ogboot
|
||||
Desde el menú superior se puede acceder al panel de Estado Global, donde se muestra el estado actual de ogboot.
|
||||
|
||||
|
||||
En esta vista se puede comprobar:
|
||||
|
||||
- Uso de disco reservado para ogLive y archivos de arranque.
|
||||
|
||||
- Estado de los servicios críticos (**tftpboot** y **nginx**).
|
||||
|
||||
- Lista de imágenes ogLive instaladas, con su kernel, arquitectura y versión.
|
||||
|
||||
## Gestión de ogLive
|
||||
|
||||
Desde la sección lateral ogLive, es posible gestionar las distintas versiones del sistema operativo que serán ofrecidas a los clientes al arrancar.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Cada entrada muestra:
|
||||
|
||||
- Nombre de la imagen (ej. ogLive-6.8.0-31-generic-20250519)
|
||||
|
||||
- Si está marcada como imagen por defecto
|
||||
|
||||
- Estado de instalación
|
||||
|
||||
- Fecha de creación
|
||||
|
||||
Acciones: ver detalles, eliminar, o cambiar la imagen por defecto
|
||||
|
||||
!!! warning "Advertencia"
|
||||
Sólo puede haber una imagen ogLive marcada como por defecto. Esta será la usada en las plantillas de arranque cuando no se especifique una versión concreta.
|
||||
No es posible eliminar una imagen marcada como por defecto.
|
||||
|
||||
|
||||
|
||||
### Añadir e instalar una nueva imagen ogLive
|
||||
Para añadir una nueva versión de ogLive al sistema, sigue estos pasos desde el menú lateral ogLive:
|
||||
|
||||
|
||||
1. Haz clic en el botón "Añadir OgLive" para seleccionar una de las imágenes detectadas en el sistema.
|
||||
|
||||
|
||||
|
||||
2. Se abrirá una ventana con una lista desplegable de las imágenes disponibles pero aún no registradas en la interfaz. Selecciona uno de los Oglives disponibles y pulsa "Añadir".
|
||||
|
||||
|
||||
|
||||
3.Una vez añadida, la imagen aparecerá en la lista con el estado "Sin instalar".
|
||||
|
||||
|
||||
|
||||
Desde aquí podrás visualizarla, eliminarla, o desplegar el menú de acciones para proceder a su instalación.
|
||||
|
||||
4. Instalar imagen ogLive
|
||||
Pulsa sobre el icono de acciones (≡) y selecciona "Instalar".
|
||||
|
||||
|
||||
|
||||
Esto iniciará el proceso de instalación, que registrará la imagen y la preparará para ser usada durante el arranque de los clientes.
|
||||
|
||||
5. Una vez completado el proceso, el estado pasará a "Instalada" y la imagen estará lista para usarse.
|
||||
|
||||
|
||||
|
||||
!!! note "Nota"
|
||||
Puedes marcar la nueva imagen como por defecto si deseas que sea la utilizada automáticamente en las plantillas de arranque que no especifiquen una versión concreta.
|
||||
|
||||
|
||||
## Gestión de Plantillas PXE
|
||||
Desde el menú lateral Plantillas PXE, se accede a la gestión de los ficheros base que definen cómo arrancará cada cliente. Estas plantillas son utilizadas para generar archivos personalizados por dirección MAC y permiten seleccionar el método de arranque que debe usar el equipo.
|
||||
|
||||
|
||||
|
||||
|
||||
En esta vista se muestra:
|
||||
|
||||
- Nombre de la plantilla
|
||||
|
||||
- Estado de sincronización con el sistema de archivos
|
||||
|
||||
- Si es la plantilla por defecto
|
||||
|
||||
- Fecha de creación
|
||||
|
||||
- Acciones disponibles: ver, editar o eliminar
|
||||
|
||||
### Plantillas disponibles por defecto
|
||||
En el sistema vienen predefinidas varias plantillas localizadas en:
|
||||
|
||||
```
|
||||
/opt/opengnsys/ogboot/tftpboot/ipxe_scripts/templates/
|
||||
```
|
||||
Las plantillas por defecto son:
|
||||
|
||||
| Plantilla | Descripción |
|
||||
|----------------------------|-----------------------------------------------------------------------------|
|
||||
| firstDisk | Arranca desde el primer disco del sistema |
|
||||
| firstDisk_firstPartition | Arranca desde la primera partición del primer disco |
|
||||
| firstDisk_secondPartition | Arranca desde la segunda partición del primer disco |
|
||||
| firstDisk_thirdPartition | Arranca desde la tercera partición del primer disco |
|
||||
| oglive | Arranca el sistema ogLive desde red (HTTP) |
|
||||
| ogliveCache | Arranca ogLive desde la caché local del cliente (/opt/opengnsys/cache/oglive/) |
|
||||
|
||||
Estas plantillas son utilizadas como base para generar archivos personalizados por cliente, sustituyendo las variables contenidas en ellas por valores concretos en función de la configuración del equipo.
|
||||
|
||||
|
||||
### Variables de las plantillas PXE
|
||||
Las plantillas de arranque disponibles en ogboot contienen variables que serán sustituidas automáticamente al generar el fichero de arranque personalizado para cada cliente. Esto permite reutilizar plantillas genéricas para múltiples equipos, adaptando dinámicamente los valores.
|
||||
|
||||
Ejemplo de plantilla: oglive
|
||||
```
|
||||
#!ipxe
|
||||
set timeout
|
||||
set timeout-style hidden
|
||||
|
||||
set ISODIR __OGLIVE__
|
||||
set default 0
|
||||
set kernelargs __INFOHOST__
|
||||
|
||||
:try_iso
|
||||
kernel http://__SERVERIP__/tftpboot/${ISODIR}/ogvmlinuz ${kernelargs} || goto fallback
|
||||
initrd http://__SERVERIP__/tftpboot/${ISODIR}/oginitrd.img
|
||||
boot
|
||||
|
||||
:fallback
|
||||
echo "OgLive default"
|
||||
set ISODIR ogLive
|
||||
kernel http://__SERVERIP__/tftpboot/${ISODIR}/ogvmlinuz ${kernelargs}
|
||||
initrd http://__SERVERIP__/tftpboot/${ISODIR}/oginitrd.img
|
||||
boot
|
||||
```
|
||||
### Variables disponibles
|
||||
|
||||
| Variable | Descripción |
|
||||
|---------------|------------------------------------------------------------------------------------------------------------|
|
||||
| __SERVERIP__ | Dirección IP del servidor ogboot (servidor HTTP/TFTP que aloja el ogLive) |
|
||||
| __OGLIVE__ | Nombre del directorio donde está montada la imagen ogLive seleccionada |
|
||||
| __INFOHOST__ | Conjunto de parámetros del kernel personalizados para el cliente (IP, hostname, ogcore, ogrepo, etc.) |
|
||||
|
||||
Estas variables se sustituyen automáticamente cuando se genera el fichero de arranque para un cliente (por ejemplo, 01-00:11:22:33:44:11) a partir de la plantilla seleccionada.
|
||||
|
||||
En las plantillas PXE utilizadas por ogboot, la variable __INFOHOST__ se sustituye automáticamente por una cadena de parámetros del kernel. Estos parámetros son generados por el componente ogcore a partir de la configuración del cliente y su Unidad Organizativa a la que pertenece.
|
||||
|
||||
- Ejemplo de sustitución
|
||||
```
|
||||
set kernelargs ro boot=oginit quiet splash irqpoll acpi=on og2nd=sqfs ogprotocol=smb ogactiveadmin=true ogdebug=true ogtmpfs=15 oglivedir=${ISODIR} LANG=es_ES.UTF-8 ip=192.168.3.11:172.17.8.35:192.168.3.1:255.255.255.0:PC11:eth0:none group=Aula_Ciencias ogrepo=172.17.8.35 ogcore=192.168.2.2 oglive=172.17.8.35 oglog=192.168.68.51 ogshare=172.17.8.35 ogprof=false hardprofile=default ogdns=192.168.3.1 vga=791
|
||||
```
|
||||
|
||||
- Detalle de los parámetros incluidos
|
||||
|
||||
| Parámetro | Origen y función |
|
||||
|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
|
||||
| ip= | Dirección IP del cliente junto con la configuración de red, en el formato:<br>`<client-ip>:<server-ip>:<gateway>:<netmask>:<hostname>:<device>:<autoconf>` |
|
||||
| ├── client-ip | Dirección IP asignada al cliente |
|
||||
| ├── server-ip | Dirección IP del servidor ogboot (servidor TFTP/HTTP) |
|
||||
| ├── gateway | IP del router de la subred |
|
||||
| ├── netmask | Máscara de red |
|
||||
| ├── hostname | Nombre del cliente (PC11, por ejemplo) |
|
||||
| ├── device | Interfaz de red (ej. eth0) |
|
||||
| └── autoconf | Método de configuración IP (none, dhcp, etc.) |
|
||||
| oglivedir | Nombre del directorio ogLive que se va a utilizar |
|
||||
| ogcore | IP del servidor ogcore |
|
||||
| oglive | IP del servidor ogboot (donde están los oglives) |
|
||||
| ogrepo | IP del servidor de repositorios de imágenes |
|
||||
| oglog | IP del servidor oglog (logs centralizados) |
|
||||
| ogshare | Dirección IP para almacenamiento compartido |
|
||||
| group | Nombre de la Unidad Organizativa del cliente |
|
||||
| hardprofile | Perfil hardware del cliente (default si no tiene uno asignado) |
|
||||
| ogdns | IP del servidor DNS |
|
||||
| ogntp | IP del servidor NTP (si está definido) |
|
||||
| ogProxy | Dirección del proxy (si aplica) |
|
||||
| netiface | Interfaz de red (ej. eth0) |
|
||||
| LANG | Idioma (es_ES.UTF-8) |
|
||||
| vga=791 | Resolución de pantalla |
|
||||
| Otros parámetros comunes | `ro boot=oginit quiet splash irqpoll acpi=on og2nd=sqfs ogprotocol=smb ogtmpfs=15` |
|
||||
|
||||
|
||||
### Crear una nueva plantilla PXE
|
||||
El módulo ogboot permite añadir nuevas plantillas PXE desde la interfaz gráfica, ya sea partiendo de cero o usando uno de los modelos predefinidos.
|
||||
|
||||
1. Para añadir una nueva plantilla:
|
||||
|
||||
2. Accede al menú lateral Plantillas PXE
|
||||
|
||||
3. Pulsa "Añadir plantilla"
|
||||
|
||||
4. Rellena el formulario que se abrirá
|
||||
|
||||
|
||||
|
||||
#### Plantillas modelo
|
||||
La interfaz permite cargar un modelo base pulsando el botón "Cargar plantilla modelo", que insertará en el editor uno de los dos modelos disponibles:
|
||||
|
||||
- Modelo ogLive (arranque por red HTTP o TFTP)
|
||||
Este modelo está pensado para arrancar ogLive desde un servidor HTTP o TFTP. Utiliza las variables __SERVERIP__, __OGLIVE__ y __INFOHOST__, que serán sustituidas automáticamente por ogboot al generar el fichero personalizado.
|
||||
|
||||
```
|
||||
#!ipxe
|
||||
set timeout 0
|
||||
set timeout-style hidden
|
||||
set ISODIR __OGLIVE__
|
||||
set default 0
|
||||
set kernelargs __INFOHOST__
|
||||
:try_iso
|
||||
kernel http://__SERVERIP__/tftpboot/${ISODIR}/ogvmlinuz ${kernelargs} || goto fallback
|
||||
initrd http://__SERVERIP__/tftpboot/${ISODIR}/oginitrd.img
|
||||
boot
|
||||
|
||||
:fallback
|
||||
set ISODIR ogLive
|
||||
kernel http://__SERVERIP__/tftpboot/${ISODIR}/ogvmlinuz ${kernelargs}
|
||||
initrd http://__SERVERIP__/tftpboot/${ISODIR}/oginitrd.img
|
||||
boot
|
||||
```
|
||||
|
||||
|
||||
- Modelo arranque por disco
|
||||
Este segundo modelo detecta si el sistema se encuentra en modo BIOS o UEFI y arranca desde el primer disco disponible, utilizando grub.exe o grubx64.efi.
|
||||
|
||||
|
||||
```
|
||||
#!ipxe
|
||||
iseq ${platform} efi && goto uefi_boot || goto bios_boot
|
||||
|
||||
:bios_boot
|
||||
echo "Running in BIOS mode - Booting first disk"
|
||||
chain http://__SERVERIP__/tftpboot/grub.exe --config-file="title FirstHardDisk;chainloader (hd0)+1;rootnoverify (hd0);boot" || echo "Failed to boot in BIOS mode"
|
||||
exit
|
||||
|
||||
:uefi_boot
|
||||
echo "Running in UEFI mode - Booting first disk"
|
||||
sanboot --no-describe --drive 0 --filename \EFI\grub\Boot\grubx64.efi || echo "Failed to boot in UEFI mode"
|
||||
exit
|
||||
```
|
||||
!!! note "Nota"
|
||||
Estos modelos son editables y sirven como base para definir otras variantes más complejas (por ejemplo, arranque por partición concreta o modos de recuperación).
|
||||
|
||||
### Consultar el contenido de una plantilla
|
||||
Haz clic en el icono del ojo para ver el contenido completo de una plantilla PXE.
|
||||
|
||||
|
||||
|
||||
### Editar una plantilla existente
|
||||
Haz clic en el icono del lápiz para editar el nombre o el contenido de la plantilla. Se abrirá el editor con el contenido actual precargado.
|
||||
|
||||
|
||||
|
||||
### Eliminar una plantilla
|
||||
Haz clic en el icono de la papelera y confirma la eliminación para borrar la plantilla del sistema.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Plantillas por cliente (Boot PXE)
|
||||
|
||||
Cada cliente puede tener asignado un fichero de arranque específico basado en una plantilla. Estos archivos tienen el nombre 01-<MAC> y se almacenan en /opt/opengnsys/ogboot/tftpboot/ipxe_scripts/.
|
||||
|
||||
|
||||
|
||||
### Asignar plantilla a un cliente
|
||||
Desde el menú lateral, accede a Arranque PXE, donde podrás ver todos los clientes de una Unidad Organizativa (por ejemplo, "Aula Ciencias"):
|
||||
|
||||
|
||||
1. Selecciona una plantilla para cada cliente desde la columna Plantilla.
|
||||
|
||||
!!! note "Nota"
|
||||
También puedes aplicar una plantilla a todos los clientes usando el desplegable superior.
|
||||
|
||||
2. Haz clic en Guardar para generar los ficheros de arranque correspondientes.
|
||||
|
||||
|
||||
|
||||
Estos archivos se crean con nombre 01-<MAC> (por ejemplo, 01-00:11:22:33:44:55) y se almacenan en:
|
||||
|
||||
```
|
||||
/opt/opengnsys/ogboot/tftpboot/ipxe_scripts/
|
||||
```
|
||||
El contenido del fichero generado será una copia de la plantilla correspondiente con las variables sustituidas por los valores concretos del cliente: dirección IP, ogLive, ogcore, etc.
|
||||
|
||||
!!! success "Lo que hemos aprendido"
|
||||
- Qué es ogboot y cómo se encarga del arranque de los clientes mediante IPXE.
|
||||
- Qué son los ogLive, cómo se gestionan (instalar, eliminar, marcar como por defecto) y cómo se usan en el arranque.
|
||||
- Cómo funcionan las plantillas PXE, cómo se editan, consultan, eliminan y qué variables utilizan.
|
||||
- Cómo se asigna un fichero de arranque personalizado a cada cliente a partir de una plantilla.
|
||||
|
|
@ -1,196 +1,3 @@
|
|||
# Módulo CloneEngine
|
||||
|
||||
## Introducción
|
||||
CloneEngine es el componente encargado de ejecutar las operaciones de clonado, particionado, creación y restauración de imágenes en los clientes registrados en OpenGnsys. Actúa como un motor de ejecución que recibe instrucciones desde la interfaz web y las traduce en comandos que se ejecutan en los equipos cliente.
|
||||
|
||||
No cuenta con interfaz visual propia, sino que opera de forma transparente como backend de los módulos de gestión. Entre sus funcionalidades principales se incluyen:
|
||||
|
||||
- Preparación de discos y particiones.
|
||||
|
||||
- Creación y restauración de imágenes.
|
||||
|
||||
- Configuración del arranque (BIOS/UEFI).
|
||||
|
||||
- Gestión de caché e inventario.
|
||||
|
||||
- Ejecución de scripts personalizados.
|
||||
|
||||
Estas operaciones son ejecutadas en tiempo real o de forma programada, y su resultado es reportado a través de la interfaz web.
|
||||
|
||||
|
||||
|
||||
## Gestión de Discos y Particiones
|
||||
|
||||
### Introducción al particionado en OpenGnsys
|
||||
El particionado de discos es una de las operaciones más delicadas que puede ejecutar el administrador desde la consola web de OpenGnsys. Su correcta definición es esencial para asegurar la compatibilidad con las imágenes a restaurar y garantizar que los sistemas operativos puedan arrancar adecuadamente.
|
||||
|
||||
La interfaz web permite definir de forma remota la tabla de particiones de uno o varios discos de los clientes registrados, usando el asistente visual de particionado. Internamente, el motor CloneEngine se encarga de aplicar esta estructura en el cliente, eliminando el contenido previo y creando las nuevas particiones con los tamaños y tipos definidos.
|
||||
|
||||
!!! warning "Advertencia"
|
||||
Un particionado incorrecto puede dejar inoperativo el sistema del cliente, eliminar sistemas existentes o impedir restauraciones debido a incompatibilidades de tipo o tamaño.
|
||||
|
||||
### Consideraciones previas
|
||||
Antes de definir una tabla de particiones se recomienda tener en cuenta:
|
||||
|
||||
- **Tamaño del disco**: comprobar que el espacio total detectado es utilizable. Se recomienda probar primero sobre un equipo modelo.
|
||||
|
||||
- **Entorno (aula o grupo de ordenadores)**: mantener estructuras de particionado homogéneas facilita el mantenimiento.
|
||||
|
||||
- **Sistemas operativos a restaurar**: asegurar que el tamaño y tipo de partición es compatible con la imagen correspondiente.
|
||||
|
||||
- **Tamaño de la partición CACHE**: dimensionar correctamente si se desea usar como contenedor intermedio o para ogLive.
|
||||
|
||||
- **Tipo de tabla de particiones**: el asistente detecta automáticamente si es de tipo MSDOS (BIOS) o GPT (UEFI), pero se puede forzar su recreación.
|
||||
|
||||
- **Particionado previo**: estructuras antiguas o creadas con software externo pueden interferir. Se recomienda probar siempre en un modelo.
|
||||
- Tipos de partición y sistemas de archivos:
|
||||
La interfaz permite configurar para cada partición:
|
||||
- Tipo de partición (ej. LINUX, WINDOWS, CACHE, EMPTY, EXTENDED, etc.).
|
||||
- Tipo de sistema de archivos (ej. EXT4, NTFS, CACHE, etc.).
|
||||
- Tamaño en MB o porcentaje.
|
||||
- Opción de formateo.
|
||||
|
||||
|
||||
Tabla resumen de compatibilidad
|
||||
|
||||
| Tipo de partición | Sistemas de archivos permitidos | Descripción |
|
||||
|------------------------|-----------------------------------------|----------------------------------------------------------|
|
||||
| EMPTY | EMPTY | Espacio reservado sin uso definido |
|
||||
| CACHE | CACHE | Usada como contenedor intermedio por OpenGnsys |
|
||||
| LINUX | EXT4, BTRFS, XFS, ... | Para sistemas GNU/Linux |
|
||||
| WINDOWS | NTFS, FAT32, HFAT32, ... | Para sistemas Windows |
|
||||
| LINUX-SWAP | LINUX-SWAP | Área de intercambio de Linux |
|
||||
| EXTENDED | – | Solo para BIOS, permite añadir más particiones lógicas (no implementado)|
|
||||
| FREEBSD, SOLARIS, … | Sistemas nativos correspondientes | Para sistemas alternativos (no habituales) |
|
||||
|
||||
!!! note "Nota"
|
||||
El sistema identifica partición CACHE como tal, pero internamente utiliza un sistema de archivos EXT4 con configuración específica.
|
||||
|
||||
|
||||
### La partición CACHE
|
||||
La partición CACHE es un tipo especial de partición gestionada por OpenGnsys, que ofrece varias funcionalidades esenciales para la eficiencia del sistema:
|
||||
|
||||
- Contenedor intermedio de imágenes:
|
||||
Permite guardar imágenes de sistema operativo localmente, reduciendo el tiempo en restauraciones posteriores. También actúa como búfer en transferencias tipo Torrent.
|
||||
|
||||
- Contenedor auxiliar de ogLive:
|
||||
Durante el arranque PXE con ogLiveAdmin, el sistema puede copiar el kernel e initrd a esta partición para reducir la dependencia del servidor y mejorar los tiempos de arranque.
|
||||
|
||||
!!! warning "Advertencia"
|
||||
Si la partición CACHE se formatea, se pierden las imágenes y los datos temporales de ogLive. Será necesario reiniciar desde ogLiveAdmin para regenerarlos.
|
||||
|
||||
### Reglas y recomendaciones
|
||||
|
||||
- Solo debe existir una partición CACHE por equipo.
|
||||
|
||||
- En particiones MSDOS debe estar en la posición 4 y ser primaria.
|
||||
|
||||
- En particiones GPT puede ocupar cualquier orden, pero su identificador será el cuarto.
|
||||
|
||||
- El tamaño mínimo recomendado es de 1.5 GB si solo se va a usar para ogLive.
|
||||
Si se desea almacenar imágenes, dimensionar según el número y tamaño estimado de estas.
|
||||
|
||||
|
||||
|
||||
### Acceso al asistente
|
||||
Para acceder al asistente de particionado:
|
||||
|
||||
- Ve al apartado Grupos desde el menú lateral.
|
||||
|
||||
- Selecciona una Unidad Organizativa.
|
||||
|
||||
- Haz clic en el botón ⋮ de cualquier cliente.
|
||||
|
||||
- En el menú desplegable, selecciona la opción Particionar y Formatear.
|
||||
|
||||
|
||||
Esto abrirá el asistente en una nueva vista.
|
||||
|
||||
|
||||
|
||||
### Estructura del formulario
|
||||
El asistente está dividido en tres bloques principales:
|
||||
|
||||
- Clientes seleccionados
|
||||
En la parte superior, se muestra el cliente (o grupo de clientes) donde se aplicará la tabla de particiones.
|
||||
|
||||
- Diseño de la nueva tabla de particiones
|
||||
Aquí se define la estructura del disco:
|
||||
|
||||
- Disco disponible y su tamaño.
|
||||
|
||||
- Tipo de firmware (BIOS/UEFI).
|
||||
|
||||
- Tipo de tabla de particiones: detectada automáticamente (MSDOS o GPT).
|
||||
|
||||
- Listado editable de particiones: tipo, sistema de archivos, tamaño (MB o %), y opción de formateo.
|
||||
|
||||
- Distribución gráfica del disco:
|
||||
A la derecha, se muestra un gráfico circular con el espacio total, libre y utilizado según la configuración actual.
|
||||
|
||||
|
||||
|
||||
|
||||
### Diseño de la tabla de particiones
|
||||
A continuación, se detallan los pasos para diseñar una tabla de particiones:
|
||||
|
||||
1. Seleccionar equipos
|
||||
|
||||
En caso de que has seleccionado varios equipos en la ventana previa al seleccionar Particionar estos equipos aparecerán en el desplegable superior. Pulsando un equipo podrás seleccionar o deseleccionar en caso de que no quieras aplicar el comando de particionado sobre un equipo en concreto. El checkbox de **Modelo** indica que ese ordenador seleccionado será usado como modelo de particionado y cargará su tabla de particiones a la vista de forma dinámica. Puedes seleccionar un ordenador como Modelo y deseleccionarlo en caso de que no quieras volver a particionarlo pero quieras aplicar su configuración de particionado al resto de las máquina.
|
||||
|
||||
|
||||
|
||||
1. Seleccionar disco
|
||||
|
||||
En el desplegable superior izquierdo, elige el disco a particionar (ejemplo: Disco 1 (80.00 GB)).
|
||||
|
||||
2. Tipo de firmware y tabla de particiones
|
||||
|
||||
- Firmware: indica si el equipo está en modo BIOS o UEFI.
|
||||
|
||||
- Tabla de particiones: puede ser MSDOS o GPT, y se asigna automáticamente según el firmware.
|
||||
|
||||
3. Añadir particiones
|
||||
|
||||
- Pulsa el botón Añadir partición si estás usando tabla GPT.
|
||||
|
||||
4. Para cada partición:
|
||||
|
||||
- Define el tipo de partición (ej. LINUX, CACHE, WINDOWS, etc.).
|
||||
|
||||
- Selecciona el sistema de ficheros (ej. EXT4, NTFS, etc.).
|
||||
|
||||
- Introduce el tamaño, en MB o en porcentaje.
|
||||
|
||||
- Formateo: si deseas formatear la partición tras su creación.
|
||||
|
||||
5. Gráfico de uso del disco
|
||||
|
||||
- Asegúrate de que el espacio libre no sea negativo.
|
||||
|
||||
- Dejar margen libre (recomendado ≥ 1 GB) en discos grandes para evitar fallos de precisión durante el proceso.
|
||||
|
||||
|
||||
|
||||
!!! note "Nota"
|
||||
En sistemas con tabla de particiones MSDOS, el número máximo de particiones primarias es cuatro. En GPT no hay este límite, pero sí debe respetarse la identificación de la partición CACHE como la cuarta.
|
||||
|
||||
|
||||
|
||||
Opciones de ejecución
|
||||
Una vez definida la estructura del disco, puedes:
|
||||
|
||||
- Ejecutar la orden directamente sobre el equipo.
|
||||
|
||||
- Generar instrucciones para aplicarlas más tarde (de forma programada).
|
||||
|
||||
- Acceder a opciones avanzadas de programación si se desea incluir en una cola de acciones.
|
||||
|
||||
En el caso de que se generen instrucciones, estas se muestran en un bloque editable que puede ser revisado antes de su ejecución.
|
||||
|
||||
|
||||
|
||||
|
||||
# Motor de Clonación
|
||||
|
||||
El Motor de Clonación es un componente fundamental que gestiona el proceso completo de clonación de imágenes en nuestro sistema. Este componente integra varios procedimientos críticos que se describen a continuación.
|
||||
|
|
|
|||
|
|
@ -52,7 +52,7 @@ Cuando accedemos al menú Acciones -> Comandos, podemos administrar los comandos
|
|||
- **Comandos predefinidos**: aquellos que tienen el botón de edición sombreado
|
||||
- **Comandos personalizado**: aquellos que tienen el botón de edición activo
|
||||
|
||||
{ style="display: block; margin: 20px auto; max-width: min(1024px, 100%); height: auto;" }
|
||||
{ style="display: block; margin: 20px auto; max-width: min(1024px, 100%); height: auto;" }
|
||||
|
||||
Para añadir o editar un comando, accedemos a la ventana de edición, en este ejemplo el "**comando test**" ejemplo podemos ver las opciones de edición, donde podemos definir las variables del script a ejecutar, en este ejemplo:
|
||||
|
||||
|
|
@ -61,7 +61,7 @@ Para añadir o editar un comando, accedemos a la ventana de edición, en este ej
|
|||
cd /user @1 @1
|
||||
```
|
||||
|
||||
{ style="display: block; margin: 20px auto; max-width: min(1024px, 100%); height: auto;" }
|
||||
{ style="display: block; margin: 20px auto; max-width: min(1024px, 100%); height: auto;" }
|
||||
|
||||
!!! warning "Advertencia"
|
||||
La ejecución de comandos otorga permisos de administrador sobre la máquina remota, por lo que el acceso a esta característica debe estar controlado para prevenir abusos y riesgos de seguridad.
|
||||
|
|
@ -70,19 +70,19 @@ cd /user @1 @1
|
|||
|
||||
La siguiente abstracción respecto a las acciones, son las tareas. Las tareas son secuencias de comandos que se pueden ejecutar al instante, o bien programarlas.
|
||||
|
||||
{ style="display: block; margin: 20px auto; max-width: min(1024px, 100%); height: auto;" }
|
||||
{ style="display: block; margin: 20px auto; max-width: min(1024px, 100%); height: auto;" }
|
||||
|
||||
Una vez elegimos programarla, accedemos a un menú que nos permite configurarla para ejecutarla una sola vez o de forma recurrente según una programación establecida
|
||||
|
||||
{ style="display: block; margin: 20px auto; max-width: min(1024px, 100%); height: auto;" }
|
||||
{ style="display: block; margin: 20px auto; max-width: min(1024px, 100%); height: auto;" }
|
||||
|
||||
La tarea que hemos creado, aparece en la lista de Tareas, donde se ve activo el **Reloj** de programación, podemos acceder al menú de selección del script que se quiere ejecutar **< >** o bien, pulsando en "Acciones" podemos acceder a los comandos que se ejecutarán en esta Tarea
|
||||
|
||||
{ style="display: block; margin: 20px auto; max-width: min(1024px, 100%); height: auto;" }
|
||||
{ style="display: block; margin: 20px auto; max-width: min(1024px, 100%); height: auto;" }
|
||||
|
||||
Si pulsamos el botón **acciones**, veremos los scripts que se ejecutarán y el orden en el que lo harán
|
||||
|
||||
{ style="display: block; margin: 20px auto; max-width: min(1024px, 100%); height: auto;" }
|
||||
{ style="display: block; margin: 20px auto; max-width: min(1024px, 100%); height: auto;" }
|
||||
|
||||
!!! success "Lo que hemos aprendido"
|
||||
Hemos adquirido una visión global de la gestión de Acciones, donde hemos cubierto los siguientes aspectos:
|
||||
|
|
|
|||
Loading…
Reference in New Issue