Page History
...
- Choose the Controller archive for the target system from the JS7 - Download page.
- For Windows systems a .zip archive including the installer is available .
Installation
- Extract the downloaded archive from
js7_controller_windows_installer.<release>.zip
.
Installation
Extract the downloaded archive to a directory, e.g.
C:\Temp
.The installer can be run with a GUI in graphical mode or in headless mode, see JS7 - Controller - Use of Linux/Windows Headless Installation.
- The installer asks for elevated administrator privileges, therefore it is not required to change the permissions in the
.\service
directory and the installer sets read/write permissions for the.\logs
directory. - After the installation you will find
- a Windows Service "
SOS JS7 Controller -id=<controller-id>
" - an executable file
.\service\
js7_controller_<controller-id>.exe
that is started by the Windows Service.
- a Windows Service "
Run the installer dialog for the JS7 Controller using
Code Block language bash title Windows command to run the installer GUI > C:\Temp\controller.<release>\setup.cmd
- The installer asks for elevated administrator administrative permissions.
- Select the language to be used for the setup: English and German are available.
- Click Next on the welcome window.
- The Licenses License page displays the licenses which are available for the Controller.
- The Open Source License GPLv3 (General Public License) is available.
- The SOS Commercial License can be used by adding a license certificate file that you receive from SOS after purchase of a license. For details see JS7 - FAQ - How to apply a JS7 License Key.
- The License Agreement displayed with step 2 of the installation has to be accepted before installation can occur.
- The installer opens a GUI window to specify the installation path directory after you accept the terms of the License Agreement.
- Add the HTTP port that is used by the JS7 Controller. Make sure that the HTTP port is available, i.e. is not otherwise used. If you run other applications that use this port then choose a different port.
- If you specify a service Windows Service account then make sure that this account has "Log on as service permissions". Consider that credentials that you enter to this window are stored in clear text with the installer response file. It is considered more secure not to add credentials with this step, but to add credentials directly for the service with the Windows Service panel after installation.
- Select the Configuration path configuration directory for the Controller where to which you want to store the journals (state folder) of the Controller and the keystore and truststore for the ControllerController's journal files.
- If you select the installation path directory to be located in
C:\Program Files
then it is recommended to choose the log directory outside of the installation path, e.g.C:\ProgramData\sos-berlin.com\js7\controller\logs
. - The installer sets read/write permissions for the specified Windows Service user account. Typically only the administrator group should have write permissions for
C:\Program Files
.
This step displays the progress of the first part of the installation procedure. - Changes to the installer options can no longer be applied once this step was is started.
- The Processing processing panel displays the progress of the second part of the installation procedure that includes to set permissions and to install the Windows Service.
The information displayed with this step is written to the installation log file that can be found in the
JS7_CONTROLLER_DATA/logs
folder.
The last step of the installation shows a summary of the installation (success/error) and paths to relevant files.
...
Note that if a problem occurs during installation a warning will be displayed and a link to the installation log file will be provided.
- A failed installation can be repeated at any time, no uninstallation is required.
Updating the JS7 Controller
...
- Stop the JS7 Controller instance, e.g. from the Controller's Windows Service.
- Prepare to rollback in case that the update of the JS7 Controller is not successful:
- Take a backup of the Controller's installation directory and configuration directory, e.g. by creating a .zip archive.
- Installation Directory
- The default installation path directory for the Controller is
C:\Program Files\sos-berlin.com\js7\controller\<controller-id>
- The default installation path directory for the Controller is
- Configuration Directory
- The default configuration path directory for the Controller is
C:\ProgramData\sos-berlin.com\js7\controller\<controller-id>
- The default configuration path directory for the Controller is
- Installation Directory
- Take a backup of the Controller's installation directory and configuration directory, e.g. by creating a .zip archive.
...
The update using the GUI can be done by rerunning the installer setup.cmd
file from the .zip archive and by providing the same parameters such as installation pathsdirectory, ports port etc.
Rollback
To perform the rollback on Windows systems follow the below steps:
- To perform Run the JS7 Controller instance rollback run the uninstaller.
- The default location of the
uninstall.cmd
file is:C:\Program Files\sos-berlin.com\js7\controller\<controller-id>\Uninstaller
- The default location of the
- Restore the Controller folders from the backup by unzipping the .zip archive for the installation directory and configuration directory to the respective locationlocations.
- Re-install the Windows Service from the command line:
- Switch to the Controller's
.\bin
directory for from the Controller from the command line.- The default location of the
.\bin
directory is:C:\Program Files\sos-berlin.com\js7\controller\<controller-id>\bin
- The default location of the
Run the below command that installs the Controller's Windows Service.
controller.cmd
install
-service [-http-port=<number>] [--ip-address=<
hostname
or ip address>]
- Switch to the Controller's
...
- The default location of the
logs
directory for the Controller is:C:\ProgramData\sos-berlin.com\js7\controller/<controller-id>
on Windows.
- Installation log files are named use names according to the pattern,
Install_V<release>_<date-time>_....log
where<
release>
is the release number and<
date-time>
refers to the point in time of installation.
...