Installation guide for the Linux download scripts, version 1.1 ESRThe new Linux scripts don't work alone – they need the configuration files of an existing WSUS Offline Update installation.
Furthermore, the Linux download scripts can only replace the download part of WSUS Offline Update, namely the application UpdateGenerator.exe and the script DownloadUpdates.cmd. To install the downloaded updates, you also need the files from the wsusoffline/client directory, for example the application UpdateInstaller.exe.
The version 1.1 ESR of the new Linux download scripts was developed for WSUS Offline Update 9.2.3 ESR.
WSUS Offline Update 9.2.3 ESR still uses the older Linux script DownloadUpdates.sh. To install the new Linux scripts additionally, you should:
- install the needed packages of your Linux distribution
- download and unpack the archive wsusoffline923.zip
- download and unpack the archive sh-new-1.1-esr.tgz
Install the required and recommended packagesFor Debian and Debian-derived distributions, you need to distinguish between the packages
md5deep and
hashdeep.
The upstream developers moved their project from SourceForge to GitHub, and they renamed their project from md5deep to hashdeep:
http://md5deep.sourceforge.net/https://github.com/jessek/hashdeep/Debian followed this move and renamed the package md5deep to hashdeep, starting with Debian 8 Jessie-Backports in summer 2015. The general rule for Debian and Debian-derived distributions then is: Install the package md5deep, if the distribution was released before 2015. Install the package hashdeep for all recent distributions.
- For Debian 7 Wheezy:
- Code: Select all
su -
aptitude install cabextract md5deep wget xmlstarlet trash-cli
- For Debian 8 Jessie-Backports and newer:
- Code: Select all
su -
aptitude install cabextract hashdeep wget xmlstarlet trash-cli
- For Ubuntu 14.04 LTS Trusty:
- Code: Select all
sudo apt-get install cabextract md5deep wget xmlstarlet trash-cli
- For Ubuntu 16.04 LTS Xenial and newer:
- Code: Select all
sudo apt-get install cabextract hashdeep wget xmlstarlet trash-cli
Other distributions, which are not Debian-based, seem to keep the package name md5deep.
Note, that both packages md5deep and hashdeep install a series of related applications: hashdeep, md5deep, sha1deep, sha256deep, tigerdeep, and whirlpooldeep. Throughout WSUS Offline Update, you always need the application
hashdeep, regardless of the package name.
Download and unpack the wsusoffline archiveNote: This guide refers to WSUS Offline Update 9.2.3 ESR. If the section
ESR version of the download page
http://download.wsusoffline.net/ has a newer version 9.2.* ESR, then you should get that version.
Download the archive wsusoffline923.zip and the hashes file wsusoffline923_hashes.txt:
- Code: Select all
wget http://download.wsusoffline.net/wsusoffline923.zip
wget http://download.wsusoffline.net/wsusoffline923_hashes.txt
You can verify the archive with the hashes file:
- Code: Select all
hashdeep -a -v -v -l -k wsusoffline923_hashes.txt wsusoffline923.zip
Unpack the zip archive:
- Code: Select all
unzip wsusoffline923.zip
Change to the new directory
wsusoffline:
- Code: Select all
cd wsusoffline
Download and unpack the archive sh-new-1.1-esr.tgzDownload the archive sh-new-1.1-esr.tgz and the hashes file to the directory
wsusoffline:
- Code: Select all
wget http://downloads.hartmut-buhrmester.de/sh-new-1.1-esr.tgz
wget http://downloads.hartmut-buhrmester.de/sh-new-1.1-esr_hashes.txt
You can verify the archive with the hashes file:
- Code: Select all
hashdeep -a -v -v -b -k sh-new-1.1-esr_hashes.txt sh-new-1.1-esr.tgz
Unpack the archive in the directory
wsusoffline:
- Code: Select all
tar xvzf sh-new-1.1-esr.tgz
Change to the new directory sh-new-1.1-esr and start the script update-generator.bash for an interactive setup of the needed updates:
- Code: Select all
cd sh-new-1.1-esr
./update-generator.bash
You can also use the script get-all-updates.bash as a template: This script downloads all Windows and Office updates with all optional downloads for the default languages German and English. You can customize it as needed – just comment out all options you don't need.
NotesIt is important, that the archive sh-new-1.1-esr.tgz is unpacked in the directory
wsusoffline. This ensures, that all included files are extracted to the correct directories:
- A new directory sh-new-1.1-esr is created in the directory "wsusoffline".
- Several additional xslt files are extracted to the directory "wsusoffline/xslt".
- One file is extracted to the directory "wsusoffline/static/custom".
- One file is extracted to the directory "wsusoffline/exclude/custom".
You should use the generic
tar to unpack the archive. Other utilities like
aunpack may create an enclosing directory with the name of the archive, if the archive contains multiple files or folders at the root level. This will prevent the correct installation of the included files.
If you need to copy or move the wsusoffline directory, please make sure, to preserve the file modification date of all files. You could use "cp --archive" or "cp --preserve" instead of just "cp". This is important for the correct function of WSUS Offline Update.
You can find the complete documentation in the subdirectory
documentation.