Setting up WSL Version 1 and Installing WebMO

WSL allows one to install linux distributions as apps onto Windows machines. It is important to note that WSL distributions are not virtual machines. The filesystem for each distribution is part of your Windows filesystem. Furthermore, you are not able to instantiate multiple separate instances of a single distro.

Enable WSL on Your Machine

Go to your control panel and Enable WSL:

In your app search bar type "control" and hit <enter>. This will open the control panel. Then select <view by> <large icons>. Then select <programs and features>. Click <turn windows features on or off> near the left of the page. Ensure that Windows Subsystem for Linux is checked.



Install a Linux Distribution

Use this link for a list of available distros. Examples Include Ubuntu, Ubuntu 18.04, and Debian.

Open Microsoft Store (click icon on your toolbar with bag sporting microsoft logo). Then search for the distro you want (if you select the one without a version you will always have the latest version). Click <download> and wait (it may ask you for a Microsoft Account but you don't need to give it one. Just hit the x on the window). Then click <launch> to install and open the shell. You will eventually be prompted for a username and password. Then you will be in your bash shell for the distro.

In the future, to access your local linux distribution, open the command line and use the name of the distro as a command (for instance if you have ubuntu 18.04 installed simply type "ubuntu1804" into the command line and press <enter>).



Verifiy You are in a Bash Shell and Enable Useful Features

Test some unix commands:

$ ls
$ pwd
$ whoami

Enable copy/paste into shell:

Right click on the title banner of your wsl window. Select <properties> from the dropdown. Verify that <Use Ctrl+Shift+C/V as Copy/Paste> is checked, if not check it



Install WebMO

  1. In your bash session, download and run the Server in the Cloud (sitc) script:
    $ curl -O https://www.webmo.net/cloud/sitc.tar.gz
    $ tar xzf sitc.tar.gz
    $ ./sitc/install
  2. Follow prompts to:
    • update the operating system and add some components
    • configure the operating system
    • install webmo
      • obtain and/or specify webmo license number
      • create a webmo user
    • install mopac7
  3. (Windows may ask to allow apache to operate. Allow this.)

   

Set a WebMO administrator password

Navigate to
<IP Address>/webmo
Log in with the username "admin" and a blank password. Set an administrative password when prompted. Enter your registration information. You are brought to the WebMO administration menu. Since a user was already created and mopac was already installed, simply click Logout.

   

Access and use WebMO

Log in with the username and password you supplied to the installation script. Run a test job.



Advanced Tips

Administering WebMO:
To access the WebMO administration pages, log into WebMO as username "admin" with the administration password. You can now access the User Manager to add additional users, Job Manager to monitor jobs, Interface Manager to enable other engines (which need to be installed separately), etc.


Adding additional computational engines:
run the commands-

$ cd ~
$ ./sitc/install --skip_webmo="true" --skip_update="true" --engines="foo" (where foo is the engine, or engines separated by commas, that you wish to install)
$ ./sitc/scripts/common/enable_in_webmo ./sitc/engines.log /home/webmo/public_html/cgi-bin/webmo/interfaces/

Some engines require a file to be downloaded beforehand. Run

./sitc/install --help

for more information.


Upgrading WebMO to Pro or Enterprise:
Upload the webmo distribution into /home/webmo/download. As the webmo system user:

$ tar xzf WebMO.16.0.00Xe.tar.gz
$ cd WebMO.install
$ find /home/webmo -name globals.int
$ perl upgrade.pl
Have you backed up your present WebMO installation [y/n]:y
Location: /home/webmo/public_html/cgi-bin/webmo/interfaces/globals.int
Continue with upgrade [y/n]:y
License number: ####-####-####
Do you wish to purge deleted jobs? [y/n]:y

Set up SSH (useful for scp):
run commands-

$ sudo apt update
$ sudo apt remove openssh-server (Openssh-server may not be there in the first place, if so then an error message will be returned. Ignore it and move to the next step)
$ sudo apt install openssh-server

Then open /etc/ssh/sshd_config with a text editor of your choice. Ensure that the the field of PasswordAuthentication is "yes" and that there is no # in front of it. Add the line "AllowUsers user" to the bottom of the file where "user" is the username you created. Save and quit from the file.run commands-

$ sudo service ssh start (Windows will ask you if you want to run sshd the first time you run this command. Allow it to do so)
$ sudo apt install dnsutils
$ dig +short myip.opendns.com @resolver1.opendns.com (shows you the external IP you need in order to ssh/scp to the your linux app)

Other Linux Distributions:
The sitc.tar.gz script supports the following linux distributions on WSL: