toumash / webcon-oneline-server

Vagrant webcon provisioning template

Docker

Running on Windows 10 host

State of project

The project is considered ready to use when all below marks are checked.

More info about the planned tasks and features.

• Install Windows Server
• Install prerequisites
• Install webcon components
• Create database
• Start the workflow service
• Run BPSPortal
• Connect BPS Studio to the instance

Running it

Currently the repo supports running the webcon server by two technologies:

• Vagrant
• Docker

The goal is to run everything in docker, but for the ease of development the vagrant box is being used. They are meant to share scripts files.

Vagrant

1. Install prerequisites

choco install ruby vagrant

2. Run from elevated powershell

vagrant up --provision

Docker

1. Make sure that hyper-v and virtualization is enabled on your machine (BIOS + Windows)
2. Run in Powershell following commands:

Enable-WindowsOptionalFeature -Online -FeatureName containers –All
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V –All

3. After reboot download Docker for Windows and install it
4. Switch docker to Windows containers
5. In settings of the Docker Engine set "experimental": true

Build it

1. Clone the repo.
2. Move your WebconBPS.zip to ./vendor repo dir.
3. Build and run using docker compose up --build

Credentials

Role	Login/Password
Windows Machine	vagrant/vagrant
SQL Server	sa/Vagrant42

Folders on the machine

Path	Role
C:\install	Installation scripts
C:\vendor	Additional files that the dev need to provide to successfuly build the image/box

webcon-oneline-server's Issues

Fix webcon service install path

Now its C:\[[INSTALLDIR]], but should be normal like in the manual installation procedure.

Should be

C:\Program Files (x86)\WEBCON\WEBCON BPS WorkFlow Service

Install webcon prerequisites as chief recipies

SQL Named Pipes in vagrant sql standalone on one vm

On installation we need to have enabled named pipes for webcon to communicate with the VM:

/TCPENABLED
/NPENABLED

Figure out how to test chef recipes

Running chef from vagrant is super slow (2-5 minutes to vagrant up --provisoon)

We need a way to quickly run chef from the guest VM.

Running chef-zero.bat with cookbooks copied to C:\chef does not work.

The error message says we need a configuration file, but how to create it/pass it by cli arguments?

Install chef

webcon-web: Running provisioner: chef_solo...
webcon-web: Installing Chef (latest)...
Vagrant could not detect Chef on the guest! Even after Vagrant
attempted to install Chef, it could still not find Chef on the system.
Please make sure you are connected to the Internet and can access
Chef's package distribution servers. If you already have Chef
installed on this guest, you can disable the automatic Chef detection
by setting the 'install' option in the Chef configuration section of
your Vagrantfile

Roadmap

• Sync files from ./src to the guest
• Decide which tool to use
  • ✔ chef - has a lot of examples from the vagrant box creator and works already
  • ansible ❌ Ansible cannot be installed on a windows machine. It can only manage windows guests
• Install chief #2
  • Install IIS
  • Install .net core
• #3
• Install SQL Server
  • Enable fulltextsearch
• Run Webcon Installer
  • Install BPS Workflow Server
  • Install BPS Designer Studio
  • Install BPS Portal
  • Install BPS Server Search
• #7
• #6
• Connect from Designer
• #5
• Open IIS ports for viewing webcon from host
• Add .env config for webcon sample users
• Add .env config for Active Directory
• Add .env config for SQL Server connection
• Install letsencrypt with ssl certs
• Run Webcon with docker sql
• Run Webcon on windows docker container

Start WorkFlow Service

When starting the service it throws an error that the configuration is missing.

The stacktrace shows that the app is looking for a database connection string in that file.
I havent yet run the setup.exe silent install

Proposal

We need to actually install the webcon, and then create this file manually if the setup silent install wont do it

Migrate databases

Unfortunately the setup.exe has a badly written standard output. It cannot be redirected to a file, and the terminal simply cannot fully show it.