Difference between revisions of "PKC on Windows Platform"
| (8 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
The first and foremost problem with Windows is its file/directory names and permissions are different from UNIX-based operating systems. Therefore, there will be many hiccups. | The first and foremost problem with Windows is its file/directory names and permissions are different from UNIX-based operating systems. Therefore, there will be many hiccups. | ||
To avoid these problems, one can following the following instruction to install [[PKC]] on Windows: | To avoid these problems, one can following the following instruction to install [[PKC]] on Windows: | ||
# Make sure that your Hypervisor options on your Windows 10 are enabled<ref>{{:Video/WSL 2 GUI Setup and Config for Ubuntu on Windows 10}}</ref>,<ref>https://techcommunity.microsoft.com/t5/itops-talk-blog/step-by-step-enabling-hyper-v-for-use-on-windows-10/ba-p/267945</ref>,<ref>https://jingyan.baidu.com/article/19020a0a5d3a8a529d28421c.html</ref>. | |||
# | ## For users running '''Windows 10 Home Edition''', use the following link: [https://docs.docker.com/desktop/windows/install/ Docker for Windows Installation] | ||
## | ## For users running '''Windows 10 Professional Edition''', you may use the following installation file: [https://runnable.com/docker/install-docker-on-windows-10 Download InstallDocker.msi] | ||
# Make sure that Docker-compose is installed and launch Docker Desktop | # Make sure that Docker-compose is installed and launch Docker Desktop | ||
## Try the following command to make sure your Docker Desktop is running: <code>docker run hello-world</code> | ## Try the following command to make sure your Docker Desktop is running: <code>docker run hello-world</code> | ||
# Make sure that <code>docker-compose</code> is installed: | # Make sure that <code>docker-compose</code> is installed: | ||
docker-compose --version | docker-compose --version | ||
It is common to find the Installation of Dockers on Windows causing various mysterious problems, they can be found here: | |||
=[[Windows Anamolies]]= | |||
{{:Windows Anamolies}} | |||
==Install PKC on Windows 10== | |||
Just go to the following page for [[Windows 10 PKC Installation]]. | |||
<noinclude> | <noinclude> | ||
==Related Pages== | ==Related Pages== | ||
*[[Logic Model::PKC DevOps]] | *[[Logic Model::PKC DevOps]] | ||
</noinclude> | </noinclude> | ||
Latest revision as of 12:07, 10 February 2022
The first and foremost problem with Windows is its file/directory names and permissions are different from UNIX-based operating systems. Therefore, there will be many hiccups. To avoid these problems, one can following the following instruction to install PKC on Windows:
- Make sure that your Hypervisor options on your Windows 10 are enabled[1],[2],[3].
- For users running Windows 10 Home Edition, use the following link: Docker for Windows Installation
- For users running Windows 10 Professional Edition, you may use the following installation file: Download InstallDocker.msi
- Make sure that Docker-compose is installed and launch Docker Desktop
- Try the following command to make sure your Docker Desktop is running:
docker run hello-world
- Try the following command to make sure your Docker Desktop is running:
- Make sure that
docker-composeis installed:
docker-compose --version
It is common to find the Installation of Dockers on Windows causing various mysterious problems, they can be found here:
Windows Anamolies
Since PKC is designed around Linux-based containerization technology, which means that it will have many incompatibilities with Windows inherently. There are some tips that we captured here:
Consult the System Administrator of the Computer
Some system administrators will block users from installing WSL2.0. If this is the case, the Windows operating system needs to be reinstalled to avoid that blocking. See Windows WSL Troubleshooting and this webpage[4].
Windows Subsystem for Linux (WSL) Update
After installing Docker Desktop, Windows 10 will often ask for the installation of WSL update. Please follow the wizard, and install the update accordingly.
VPN Software Interfering with WSL
Under Windows 10 Environment, some VPN software might interfere with Docker's Windows Subsystem for Linux, a.k.a. Windows Subsystem for Linux (WSL), you will need to remove the interfering VPN software before installing Docker. Please note that not all VPN software interferes with WSL. In case you don't want to remove your VPN software, or your Docker and Bash have compatibility issues, please try the following solution:Installing VirtualBox for PKC.
Choosing adequate directories
Mitch Altman identified the following scenarios for PKC installation on Windows 10, which indicate that Windows users will face many unexpected problems during installation, the following lists are some important ones. Make sure that you don't pick a directory outside of your usual Users/Documents directory. If you choose some directories outside of your User/Documents directory, it is possible that certain batch script commands will stop to work, due to file right access authority issues.
GNU TAR might not work
Mitch also found that tar command may not work on certain machines. To ensure that PKC will install smoothly on Windows 10 machines, we put an .exe (Windows executable) file unzip.exe[5] in the PKC/resources directory. We also made sure that a initial data package, namely mountPoint.zip is included in the resources directory, so that the up.bat script will be able to conduct the automatic installation and initial launch process completely.
Install PKC on Windows 10
Just go to the following page for Windows 10 PKC Installation.
Related Pages
- ↑ Britec Tech Tips, ed. (Jul 18, 2020). WSL 2 GUI Setup and Config for Ubuntu on Windows 10. local page: Britec09.
- ↑ https://techcommunity.microsoft.com/t5/itops-talk-blog/step-by-step-enabling-hyper-v-for-use-on-windows-10/ba-p/267945
- ↑ https://jingyan.baidu.com/article/19020a0a5d3a8a529d28421c.html
- ↑ Enable/Disable Windows Sybsystem on Windows 10
- ↑ Works, Stahl (20 August 2021). ZIP Related Tools.