\documentclass[10pt,letterpaper, final]{report}

\usepackage{../preamble/myWEPS}

\begin{document}

Due to Oracle removing the Java WebStart functionality from Java, beginning with Java 11,
we needed an alternative installation process for WebStart WEPS
as there was no immediate direct replacement for Java WebStart
at the time.
Thus, we developed a small WebStart WEPS bootloader program
that could replace the Java WebStart functionality
in Java 11 and later releases.
The WebStart WEPS bootloader program is currently
a standard MSI Windows application
that is installed under Windows 10 or later.
It should also work on earlier versions of Windows
such as Windows 7, 8.x, etc. and possibly Windows XP,
but it has not been tested on these older,
obsolete versions of Windows.

Note that currently we are only providing
the WebStart WEPS Bootloader as a Windows MSI build only.
Let the ARS WEPS developers know if you have a compelling need
for a Linux or other OS version of the WEPS Bootloader.

To install the WebStart WEPS Bootloader program,
one must download the MSI executable
from the WebStart WEPS home page:
\href{https://infosys.ars.usda.gov/wepstart}{https://infosys.ars.usda.gov/wepstart}.
The pertinent URL link is highlighted
in the red \textbf{\color{red}rectangle}
in the following partial screenshot
of the WebStart WEPS home page (\cref{fig:Other_versions_of_WEPS}).

\begin{figure}[H]
      \centering
		\includegraphics[scale=3]{images/Installation/Bootloader_MSI_URL_link.jpg}
		\caption{Links to alternative WebStart WEPS builds, tools, etc.}
		\label{fig:Other_versions_of_WEPS}
\end{figure}

Since it is a standard Windows MSI installation,
one must have "Administrator Rights"
to install the WEPS Bootloader program.
It will create an entry in the Windows menu system
under "USDA Applications" for the Bootloader executable
as well as a PDF user manual labeled "WEPS Bootloader 1.0"
and "WEPS Bootloader Manual" respectively.
It will also create a desktop shortcut,
if allowed, labeled "WEPS\_Bootloader 1.0".

There are two modes that the MSI Bootloader
can be configured to run in:
\begin{enumerate}
  \item Standard mode.
  
In the standard or basic mode,
the Bootloader code will immediately execute
the install/update process and then bring up WebStart WEPS.
There is no interactive GUI windows that the user
has to interact with,
only a progress window
(\cref{fig:WEPS_Bootloader_Popup_Progress_Window})
will display
until WebStart WEPS comes up.
The default WebStart WEPS configuration
is the "NRCS Release" build,
which will be installed/updated
and run from the Bootloader code in this mode.

\begin{figure}[H]
      \centering
		\includegraphics[scale=0.9]{images/Installation/Bootloader_install_progress_window.jpg}
		\caption{WEPS Bootloader Popup Progress Window.}
		\label{fig:WEPS_Bootloader_Popup_Progress_Window}
\end{figure}

  \item Advanced mode.
  
To run the Bootloader program in advanced mode,
obtain a copy from the link directly below the MSI Bootloader link
identified in the WebStart WEPS partial home page screenshot
shown in \cref{fig:Other_versions_of_WEPS}, which is also available directly here:
\newline
\forceindent
{
\href{https://infosys.ars.usda.gov/svn/code/weps_webstart/branches/weps.bootstrap-noWebstart/WIX WEPS Bootloader/WEPS_Bootloader_choices.cfg}{https://infosys.ars.usda.gov/svn/code/weps\_webstart/branches/[\,...]\,/WEPS\_Bootloader\_choices.cfg}

%% Can't display because I get "Overfull \hbox ..."
%\href{https://infosys.ars.usda.gov/svn/code/weps_webstart/branches/weps.bootstrap-noWebstart/WIX WEPS Bootloader/WEPS_Bootloader_choices.cfg}{https://infosys.ars.usda.gov/svn/code/weps\_webstart/branches/weps.bootstrap-noWebstart/WIX WEPS Bootloader/WEPS\_Bootloader\_choices.cfg}
}

Simply place the downloaded \text{\textbf{WEPS\_Bootloader\_choices.cfg}} file
in the \text{WEPS\_Bootloader} folder
residing in the ".weps" folder within the user's home directory.
For Windows 10 that location is here:
\newline
\forceindent {\text{\textbf{\(\sim \)/AppData/Roaming/.weps/WEPS\_Bootloader}}}

The user will, upon execution of the WEPS Bootloader,
select which operation they want to perform
from an interactive GUI window.
Once they have made that selection,
the user will then be able to select
from the available WebStart WEPS build options listed in the \text{WEPS\_Bootloader\_choices.cfg} file.

Here is the complete list of WebStart WEPS builds
that can currently be specified within the Bootloader's \text{WEPS\_Bootloader\_choices.cfg} file:
\begin{tabbing}
\hspace{10pt} \hspace{10pt} \= \kill
\>	NRCS Release \\
\>	NRCS Pre-Release \\
\>	NRCS Daily \\
\>	NRCS Release Development \\
\>	NRCS Pre-Release Development \\
\>	NRCS Daily Development \\
\>	ARS Release \\
\>	ARS Pre-Release \\
\>	ARS Daily \\
\>	ARS International Release \\
\>	ARS International Pre-Release \\
\>	ARS International Daily \\
\end{tabbing}
When running in advanced mode,
the WEPS Bootloader will first present a window
with the following user options:

\begin {itemize}
\item[]{\textbf{Install/Update}}

Installs and/or updates the selected WEPS build
(selection choices are offered after clicking on this button).

\item[]{\textbf{Launch As-Is}}

The WEPS Bootloader skips the update check and immediately executes the selected cached WebStart WEPS copy previously installed
(selection choices are offered after clicking on this button).

\item[]{\textbf{Uninstall}}

Uninstalls the selected WEPS build (selection choices are offered after clicking on this button).

\item[]{\textbf{Exit}}

Exits the WEPS Bootloader program.
\end {itemize}

For the advanced mode,
the following window will first display
with the options mentioned earlier as shown here.

\begin{figure}[H]
      \centering
		\includegraphics[scale=1.0]{images/Installation/Bootloader_initial_GUI_window.jpg}
\end{figure}

Per the initial window buttons,
the user is then given the opportunity
to select which WebStart WEPS build
to perform the previous action upon.

\begin{figure}[H]
      \centering
		\includegraphics[scale=1.0]{images/Installation/Bootloader_build_choice_window.jpg}
\end{figure}

After making the WebStart WEPS build choice selection
and clicking on the "OK" button,
the Bootloader will then display
the WEPS Bootloader progress window
shown earlier until WebStart WEPS comes up.

\end{enumerate}

\end{document}