The purpose and intent of this guide is to provide a walk-through for the i386 build process, to get i386 - 32-bit users up and running as quickly and as easily as possible.On fairly rare occasions, the integrated OMV ISO installer will not work with some 64 bit motherboards and hardware. The OMV installation method described in this guide will work with 64 bit motherboards as well, if the single change under Alternate 64-bit installation is noted and observed.
Considerations for i386 (32-bit) builds are very similar to amd64 (64-bit) builds. This guide is a supplement to the Getting Started with Openmediavault 6 New User Guide which is geared toward 64-bit platforms. Users may benefit by reviewing preliminary information and notes in the larger guide prior to the actual installation process.
UEFI (Unified Extensible Firmware Interface) is the proposed successor to traditional BIOS. While some of the intentions behind the development of UEFI were to increase security and add flexibility for hardware implementations, the real world results are as variable as the number of hardware manufacturers implementing the UEFI standard.
While the Debian project has worked diligently to address the installation and booting problems that may result when installing their OS on UEFI hardware, issues may still come into play during the installation procedure. Most of these issues can be resolved by taking one or both of the following actions in UEFI / BIOS.
OMV/Debian will run on i386 32-bit platforms, with 1GB of ram or even less. Hardware in this category will work well as a basic NAS server for home use, but performance expectations should be adjusted accordingly.
If doing an alternate 64-bit installation, download and use the amd64 version of OMV6-Bullseye. Other than this one change, the following installation process will apply.
This guide assumes that the downloaded ISO will be burned to a CD or DVD. If using a USB thumbdrive as a software source, help with creating a bootable USB thumbdrive ISO can be found here:Burn an ISO file to a USB drive.
Using SDFormatter, do a clean format on the new USB Thumbdrive:(Note that SDFormatter does a trim operation on the drive which cleans up remnants of deleted or previously existing files.)In most cases, SDFormatter will detect the thumb-drive. A volume label is not necessary, at this point, and the default options are fine.
The default hostname, for this 32-bit install, is debian. In this example, it was changed to openmediavault which is the default hostname for an openmediavault install. Users might chose something like OMV1 which is shorter and easier to type, for later use.
Partition Disks 3:Partition DisksIf installing to a single internal drive, there will be only one selection available. USB Thumb drives are obvious because many bear their OEM names and their capacity is usually small.
Install the GRUB Boot Loader on a Hard Disk:Generally the boot drive will be /dev/sda which is, in most cases, the first sata port.If multiple drives are connected and if there's any doubt, shutdown and disconnect all drives except the boot drive.(Otherwise, a USB Thumb-drive will be obvious.)
After installing Guacamole, you need to configure users and connections beforeGuacamole will work. This chapter covers general configuration of Guacamole andthe use of its default authentication method.
The search directory for libraries required by any Guacamole extensions.Guacamole will make the .jar files within this directory available toall extensions. If your extensions require additional libraries, such asdatabase drivers, this is the proper place to put them.
Specifying the full path to an alternative directory with the environmentvariable GUACAMOLE_HOME. Be sure to consult the documentation for yourservlet container to determine how to properly set environment variables.
The Guacamole web application uses one main configuration file calledguacamole.properties. This file is the common location for all configurationproperties read by Guacamole or any extension of Guacamole, includingauthentication providers.
In previous releases, this file had to be in the classpath of your servletcontainer. Now, the location of guacamole.properties can be explicitlydefined with environment variables or system properties, and the classpath isonly used as a last resort. When searching for guacamole.properties,Guacamole will check, in order:
The guacamole.properties file is optional and is used to configure Guacamolein situations where the defaults are insufficient, or to provide additionalconfiguration information for extensions. There are several standard propertiesthat are always available for use:
The maximum number of bytes to accept within the entity body of anyparticular HTTP request, where 0 indicates that no limit should beapplied. If omitted, requests will be limited to 2097152 bytes (2 MB) bydefault. This limit does not apply to file uploads.
As English is the fallback language, used whenever a translation key ismissing from the chosen language, English should only be omitted from thislist if you are absolutely positive that no strings are missing.
The corresponding JSON of any built-in languages not listed here willstill be available over HTTP, but the Guacamole interface will not usethem, nor will they be used automatically based on local browser language.If omitted, all defined languages will be available.
When searching for a configuration property in the environment, the nameof the property is first transformed by converting all lower casecharacters to their upper case equivalents, and by replacing all hyphencharacters (-) with underscore characters (_). For example, theguacd-hostname property would be transformed to GUACD_HOSTNAME whensearching the environment.
A comma-separated list of the namespaces of all extensions that should beloaded in a specific order. The special value * can be used in lieu of anamespace to represent all extensions that are not listed. All extensionsexplicitly listed will be sorted in the order given, while all extensionsnot explicitly listed will be sorted by their filenames.
If unsure which namespaces apply or the order that your extensions areloaded, check the Guacamole logs. The namespaces and load order of allinstalled extensions are logged by Guacamole during startup:
Note that if you enable this option, you must also configure guacd to useSSL via command line options. These options are documented in the manpageof guacd. You will need an SSL certificate and private key.
A comma-separated list of the identifiers of authentication providers thatshould be allowed to fail internally without aborting the authenticationprocess. For example, to request that Guacamole ignore failures due to theLDAP directory or MySQL server being unexpectedly down, allowing otherauthentication providers to continue functioning:
By default, Guacamole takes a conservative approach to internal failures,aborting the authentication process if an internal error occurs within anyauthentication provider. Depending on the nature of the error, this maymean that no users can log in until the cause of the failure is dealtwith. The skip-if-unavailable property may be used to explicitly informGuacamole that one or more underlying systems are expected to occasionallyexperience failures, and that other functioning systems should be reliedupon if they do fail.
By default, Guacamole logs all messages to the console. Servlet containers likeTomcat will automatically redirect these messages to a log file, catalina.outin the case of Tomcat, which you can read through while Guacamole runs.Messages are logged at four different log levels, depending on messageimportance and severity:
Debug messages are highly detailed and oriented toward development. Mostdebug messages will contain stack traces and internal information that isuseful when investigating problems within code. It is expected that debugmessages, though verbose, will not affect performance.
Trace messages are similar to debug messages in intent and verbosity, butare so low-level that they may affect performance due to their frequency.Trace-level logging is rarely necessary, and is mainly useful in providinghighly detailed context around issues being investigated.
Guacamole and the above example configure only one appender which logs to theconsole, but Logback is extremely flexible and allows any number of appenderswhich can each log to separate files, the console, etc. based on a number ofcriteria, including the log level and the source of the message.
There are other authentication modules available. The Guacamole projectprovides database-backed authentication modules with the ability to manageconnections and users from the web interface, and other authentication modulescan be created using the extension API provided along with the Guacamole webapplication, guacamole-ext.
Each user is specified with a corresponding tag. This tagcontains all authorized connections for that user, each denoted with a tag. Each tag contains a corresponding protocoland set of protocol-specific parameters, specified with the and tags respectively.
When using user-mapping.xml, username/password pairs are specified with tags, which each have a username and password attribute. Each tag authorizes a specific username/password pair to access allconnections within the tag:
After modifying user-mapping.xml, the file will be automatically reread byGuacamole, and your changes will take effect immediately. The newly-added userwill be able to log in - no restart of the servlet container is needed.
Each protocol supported by Guacamole has its own set of configurationparameters. These parameters typically describe the hostname and port of theremote desktop server, the credentials to use when connecting, if any, and thesize and color depth of the display. If the protocol supports file transfer,options for enabling that functionality will be provided as well.
7fc3f7cf58