Project

General

Profile

Bug #69598

Remove Microsoft Download Tool from Guide

Added by Thorsten Behrens 2 months ago. Updated about 1 month ago.

Status:
Done
Priority:
No priority
Assignee:
Warren Block
Category:
Documentation
Target version:
Seen in:
Severity:
New
Reason for Closing:
Reason for Blocked:
Needs QA:
No
Needs Doc:
No
Needs Merging:
No
Needs Automation:
No
Support Suite Ticket:
n/a
Hardware Configuration:
ChangeLog Required:
No
Tags:

Description

The guide at https://www.ixsystems.com/documentation/freenas/11.2/install.html suggests to use the Microsoft USB/DVD Download Tool to create a bootable USB drive on Windows. That tool is not usable with 11.2-U1, it complains about "invalid ISO format".

Suggest to remove the line that reads:

"Microsoft provides the USB/DVD Download Tool to create a USB bootable image from an .iso file. Follow these instructions, but enter the name of the downloaded .iso into the SOURCE FILE box."

A good alternative would be Etcher, as it is cross-platform and easy to use. Maybe something along the lines of:

"Etcher can be used to create a bootable USB drive from the FreeNAS .iso image. Select the image, select the drive, and flash."

Where "Etcher" would link to https://www.balena.io/etcher/

History

#1 Updated by Dru Lavigne 2 months ago

  • Assignee changed from Release Council to Warren Block
  • Target version changed from Backlog to 11.2-U2

#2 Updated by Warren Block 2 months ago

  • Status changed from Unscreened to Screened

#3 Updated by Warren Block about 2 months ago

Etcher reportedly has problems on Windows when the image has misplaced GPT tables (https://github.com/balena-io/etcher/issues/1839), which FreeNAS install images will almost always have. So I'm skeptical about including that, but we will definitely remove the Microsoft tool.

#5 Updated by Warren Block about 2 months ago

  • Status changed from Screened to In Progress

#6 Updated by Dru Lavigne about 2 months ago

  • Subject changed from Remove Microsoft Download Tool from guide to Remove Microsoft Download Tool from Guide
  • Status changed from In Progress to Ready for Testing
  • Needs Doc changed from Yes to No
  • Needs Merging changed from Yes to No

#9 Updated by Jeff Ervin about 1 month ago

52518
52527
52534

Test Passed FreeNAS-11.2-U2-INTERNAL84

Checked both Legacy & new GUI guides (Screenshots of both provided, along with a reference screenshot of before the changes). New links provided working as well.

#10 Updated by Dru Lavigne about 1 month ago

  • Status changed from Passed Testing to Done

Also available in: Atom PDF