Automatically install via Comflow Runtime Installer
- 15 Sep 2022
- 3 Minutes to read
- Contributors
- Print
- DarkLight
Automatically install via Comflow Runtime Installer
- Updated on 15 Sep 2022
- 3 Minutes to read
- Contributors
- Print
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback!
Introduction
Comflow Runtime Installer will help you with:
- Download Apache Tomcat, JDK and Comflow Studio preferred for the specified Comflow version
- Install the artifacts in the recommended locations
- Open System Defender Firewall ports for specified environments
- Exclude installations path from System Defender Virus scanner
- Set correct security on folders
Installation
Go into the server where Comflow is going to be installed. If you're installing on the D:-partition, create the folders D:\Corzia and D:\Corzia\Downloads
Download from https://update.corzia.com/comflow-installer/comflow-installer.zip
Download the .zip-file to
D:\Corzia\Downloads Extract the .zip-file to
D:\Corzia\DownloadsLaunch Windows PowerShell as Administrator (which we assume is available on your server). This is very important, since you otherwise are not allowed to perform some of the actions in the script.
D:
cd D:\Corzia\Downloads
cd .\comflow-installerNow we have the correct current directory. Beacuse we download from the Internet, we need to run "unblock" to avoid security kicking in:
unblock-file .\comflow-installer.ps1 Parameters
There are two mandatory parameters:-ports - Describes which environments whould be created. Comma separated e.g. 7070,8080,9090. This is the first parameter.-version - The Comflow version you want to install e.g. 2.22.6.
Example:
.\comflow-installer.ps1 7070,8080,9090 -version 2.22.6 -createROOTWill install preferred JDK, Apache Tomcat (x3) and Comflow Studio (x3) in the following layout:
Corzia
| Apache
| |───tdk7070
| |───tdk8080
| |───tdk9090
|
|───eclipse
| |───eclipse7070
| |───eclipse8080
| |───eclipse9090
|
|───Java
| |───jdkx.y.z_nnn
|
|───Tomcat 7070
|───Tomcat 8080
|───Tomcat 9090Command parameters and flags
| Parameter / flag | Optional/Mandatory | Example parameter value | Explanation |
|---|---|---|---|
| -ports | Mandatory | 7070,8080,9090 | Names of environments, separated by comma and without blanks. The environment name is also the port on which users will connect to it |
| -version | Mandatory | 2.22.6 | Specify the Comflow version you want to install |
| -createROOT | Optional, recommended | N/A | If this flag is specified, the installer script will create the ROOT webapp, otherwise not. If the ROOT webapp is not created, it means you will not get re-directed to |
| -targetDirectory | Optional | D:\Corzia | The folder in which environments will be created. The default value is |
| -webappName | Optional | rubore | Default webapp name is comflow. Use this parameter only if you need another name for the webapp. |
| -skipJDK | Optional | N/A | By default, a JDK will be installed. Avoid this by passing the flag. |
| -skipTomcat | Optional | N/A | By default, Tomcat will be installed. Avoid this by passing the flag. |
| -skipServices | Optional | N/A | By default, services for running Tomcat will be registered. Avoid this by passing the flag. |
| -skipStudio | Optional | N/A | By default, eclipse including Comflow plug-ins will be installed. Avoid this by passing the flag. |
| -forceDownload | Optional | N/A | By default, the installation script will use downloads that are already in the downloads folder. Force download of the latest version by passing this flag. |
| -securityGroup | Optional | COMACT\Domain Users | This group (beside the user who ran the script) will have full access to the installation folders. This parameter has effect only if the -setSecurity flag is passed. If the -SecurityGroup parameter is NOT passed, the default will be BUILTIN\Users |
| -setSecurity | Optional | N/A | This switch is required if you want to set the -securityGroup parameter |
Running
Before running the script, change the current directory to the folder where the ComflowI-Installer.ps1 file is.
Execute the script by specifying its full file path plus your parameters, for example:.\comflow-installer.ps1 8080 -version 2.22.6 -createROOT
If the OS does not allow the script to execute (error message saying e.g. "File D:\Corzia\downloads\comflow-installer\Comflow-Installer.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/….”), you can get around the problem by giving the commandset-executionpolicy remotesigned
and then trying again. (This works on Windows 10 at least)
When the script starts running, it will echo your chosen parameters and ask for your Corzia login and password if the Comflow update site needs to be accessed (which would usually be the case if you're downloading Comflow studio from there).
Upon completion, the script will have done:
- Downloaded and installed Java, Tomcat and Comflow Studio
- Set up server xml:s
- Registered services for running Tomcat
- Created shortcuts
- Opened ports in the Firewall
- Excluded installation path's from virus scan (for performance)
If for some reason you need to re-run the script, you have to first manually delete all folders that you want re-installed. The installation script will skip action if the relevant folder exists already.
Next steps for consultant:
- Download latest Comflow plug-ins (if not done by this script)
- Import plug-ins into workspace
- Import customer projects
- set up sitedef
- Set up Tomcat inside Eclipse
- Deploy projects
- Get going!
Examples
Install 7070, 8080 and 9090 environments on an empty server:.\comflow-installer.ps1 7070,8080,9090 -createROOT
Add 6060 where you have already 7070, 8080 and 9090 installed:.\comflow-installer.ps1 6060 -createROOT -skipJDK
Install 7070, 8080 and 9090 environments on an empty server and setting your own security group:.\comflow-installer.ps1 7070,8080,9090 -createROOT -setSecurity - securityGroup "COMACT\Domain Users"
Only set security group on Corzia root folder (and by inheritance to all its subfolders).\comflow-installer.ps1 -skipJDK -setSecurity -securityGroup "COMACT\Domain Users"
Was this article helpful?