User Manual
Create installer for a PC / server
This page guides you through creating a customized operating system installer for your PC or server. You will select various configuration options to build an ISO tailored to your needs, and then initiate the build process.
Create installer for a PC / server
Summary
The 'Create Installer for a PC / Server' page allows you to define the exact specifications for an awaBerry bespoke operating system installer. You will choose the CPU type, operating system, its specific version, and the desired environment. After making your selections, the system will identify a unique installer package. You can then initiate the build process, and a download link for your custom ISO will be sent to your email.
Page Access
You can access this page by navigating to: /steps_newdevice_bespoke_server
Page Functionalities
This page provides the following functionalities to help you configure and initiate the build of your bespoke ISO installer:
- Available ISO Installers Information: At the top of the page, you will see a summary indicating the total number of distinct operating systems and available ISO installers.
- CPU Type Selection: A dropdown menu allows you to select the CPU architecture (e.g., 'x64', 'arm64') of your device. This is the first step in narrowing down the available ISO options.
- Operating System Selection: After selecting a CPU type, a new dropdown appears for you to choose the operating system (e.g., 'Linux', 'Windows'). If only one OS is available for your chosen CPU, it will be automatically selected for you.
- Version Selection: Following the OS selection, another dropdown will prompt you to specify the release version of the operating system (e.g., 'Ubuntu 22.04', 'Windows 10'). Similar to OS, if only one version is available, it will be auto-selected.
- Environment Selection: The final selection step involves choosing the preferred environment for your build (e.g., 'production', 'development'). Auto-selection applies here as well if only one environment exists.
- Selected Configuration Display: After each successful selection (CPU, OS, Version, Environment), your choice will be displayed in a read-only format. Next to each selection, a 'Change' button allows you to modify that specific choice, which will reset any subsequent selections made.
- Final ISO Details: Once all configuration steps are completed, the unique 'Identifier' and a 'Description' of your customized ISO installer are displayed. This provides a summary of the bespoke ISO that will be built.
- Promotional Content: Information regarding bespoke features, including what is currently available for free and what is coming soon (e.g., Bespoke SD Card).
- Continue Button: After reviewing the final ISO details, click this button to trigger the build of your customized ISO installer. An email with a download link will be sent to you upon completion.
- Automated Connection Routines Information: A text block informs you that all bespoke installers come with automated routines to connect newly installed devices directly to your awaBerry account.
- Loading Indicator: A spinning progress indicator will appear when the system is actively fetching available options or processing your request, ensuring you know that an action is underway.
- Job Description Display (Next Page): On the subsequent page (after clicking 'Continue'), you will see a read-only display of the job description for your ISO build request.
- Processing Indicator (Next Page): A spinning indicator will be visible on the job creation page while your build job is being submitted to the system.
- Error Message Display (Next Page): Should an issue arise during job submission (e.g., an existing active job), an error message will be clearly displayed.
- Back to Overview Button (Next Page): Once the job submission is complete (either successfully or with an error), this button will become available to navigate you back to the main device connection overview.
Scenario Executions
Possible usage steps within this page
Here are the typical steps you would follow to successfully configure and initiate the build of a bespoke ISO installer:
- Step 1: Select CPU Type. Upon loading the page, you will be presented with a dropdown menu to select the CPU type of your device. Choose the appropriate option (e.g., 'x64', 'arm64').
- Step 2: Select Operating System. After selecting the CPU, a new dropdown will appear for you to choose the operating system (e.g., 'Linux', 'Windows'). If only one option is available, it will be automatically selected.
- Step 3: Select Version. Next, select the specific version of the operating system (e.g., 'Ubuntu 22.04'). The system might auto-select if there's only one version.
- Step 4: Select Environment. Finally, choose the desired environment for your ISO build (e.g., 'production', 'development'). This might also be auto-selected if unique.
- Step 5: Review Final ISO Details and Continue. Once all selections are made, the unique 'Identifier' and 'Description' of your bespoke ISO will be displayed. Review these details and click the 'Continue' button to initiate the build process.
- Step 6: Job Submission and Overview. The system will then process your request. A loading indicator will be shown briefly, followed by a confirmation message. You will then be automatically redirected to the main device connection overview page.
Possible errors which may occur on this page
Understanding potential issues can help you troubleshoot if something doesn't go as expected:
- No CPU Data Found on Load: If the application is unable to retrieve any CPU types from the backend services when the page first loads (e.g., due to network issues or service unavailability), a message stating "No CPU data found." will be displayed. This prevents you from making any selections until data can be retrieved.
- Device Limit Reached During Submission: After successfully configuring your ISO and clicking 'Continue', if your awaBerry account has reached the maximum number of connected devices allowed by your current license, you will be redirected to the license upgrade page. The ISO build job will not be initiated in this case.
- Already Running Job: If you proceed to the job creation page (after clicking 'Continue') but already have an active ISO build job in progress, an error message "You have already a running job - please wait until it is done." will be displayed. You must wait for your current job to complete before submitting a new one.
