124 lines
4.5 KiB
Markdown
124 lines
4.5 KiB
Markdown
# ogGui - OpenGnsys Administration Interface
|
|
|
|
## Introduction
|
|
|
|
Welcome to the new OpenGnsys administration interface. This manual will guide you through your first steps to configure and use the platform efficiently. The new web console represents a qualitative leap with the following main features:
|
|
|
|
!!! info
|
|
- Developed with Angular 18, a modern and up-to-date framework
|
|
- Responsive web design that works on both desktop and mobile devices
|
|
- Multilingual support with English translation
|
|
|
|
## System Access
|
|
|
|
To start using OpenGnsys:
|
|
|
|
1. Open your preferred web browser
|
|
2. Enter the OpenGnsys server URL
|
|
3. On the login screen, enter your credentials (username and password)
|
|
|
|
Click on "Log In"
|
|
|
|
|
|
|
|
## Main Interface
|
|
|
|
Once inside, you will find:
|
|
|
|
- **Sidebar navigation panel**: Access to all modules and functionalities
|
|
- **Top bar**: User information, notifications, and quick access to settings
|
|
- **Central workspace**: Where the selected information is displayed and managed
|
|
|
|
|
|
|
|
## Initial Configuration
|
|
|
|
### User Management
|
|
|
|
User management allows you to control who has access to the system and what they can do.
|
|
|
|
|
|
|
|
#### View Existing Users
|
|
|
|
Go to **Administration > Users** to see the list of current system users.
|
|
|
|
|
|
|
|
#### Add a New User
|
|
|
|
1. On the Users page, click the "Add users" button
|
|
2. Complete the form with the following data:
|
|
|
|
|
|
|
|
- **Username**: Unique identifier for logging in
|
|
- **Password**: Access key (note: only administrators can change passwords)
|
|
- **Role**: Select one or more roles that will define the user's permissions
|
|
- **Organizational Unit**: Defines which classroom groups or machines the user can manage
|
|
|
|
3. Click "Save" to create the new user
|
|
|
|
#### Edit an Existing User
|
|
|
|
1. In the user list, locate the user you want to edit
|
|
2. Click the edit icon (pencil)
|
|
3. Update the necessary fields
|
|
4. Save the changes
|
|
|
|
#### Delete a User
|
|
|
|
1. In the user list, locate the user you want to delete
|
|
2. Click the delete icon (trash can)
|
|
3. Confirm the action when prompted
|
|
|
|
### Role Configuration
|
|
|
|
Roles define user permissions on the platform. OpenGnsys includes four predefined levels:
|
|
|
|
- **Super Administrator**: Full control of the platform, no restrictions
|
|
- **Organizational Unit Administrator**: Full control over the assigned organizational unit
|
|
- **Organizational Unit Operator**: Limited permissions to operate machines in the assigned unit
|
|
- **User**: Basic access to the platform
|
|
|
|
### Environment Variables
|
|
|
|
Environment variables define the connection configuration to the different components:
|
|
|
|
1. Go to **Administration > Environment Variables**
|
|
2. Configure the following variables according to your infrastructure:
|
|
|
|
- **OG_CORE_IP**: IP address of the main server
|
|
- **OG_DHCP_API_URL**: DHCP service API URL
|
|
- **OG_BOOT_API_URL**: Boot server API URL
|
|
- **OG_LOG_IP**: Logging server IP address
|
|
- **REMOTEPC_AUTH_LOGIN**: Authentication URL for RemotePC
|
|
- **REMOTEPC_AUTH_USERNAME**: Username for RemotePC
|
|
- **REMOTEPC_AUTH_PASSWORD**: Password for RemotePC
|
|
- **REMOTEPC_URL**: Base URL of the RemotePC service
|
|
- **SSL_ENABLED**: true or false
|
|
|
|
|
|
|
|
!!! note "Note"
|
|
UDS_ variables will appear as REMOTEPC_ in your installation
|
|
|
|
## Menu Navigation
|
|
|
|
The left sidebar contains all available menus based on your role and the active modules:
|
|
|
|
- **Groups**: Group management
|
|
- **Actions**: Actions, Commands, and Tasks management module
|
|
- **Subnets**: DHCP service management module
|
|
- **Boot**: Management module for ogLive and PXE boot services
|
|
- **Calendars**: Module to manage machine availability in the RemotePC service
|
|
- **Repositories**: Module to manage repositories and their associated images
|
|
- **Menus**: Allows managing the menus displayed when launching ogLive on a client machine
|
|
|
|
!!! note "Note"
|
|
Some modules may not be available if they depend on external services that are not configured. For example, if the DHCP service is managed externally, accessing that menu will display a message indicating that the module is not enabled.
|
|
|
|
--8<-- "sections/oggui-grupos.md"
|
|
--8<-- "sections/oggui-acciones.md"
|
|
--8<-- "sections/oggui-cierre.md"
|