Page History
...
Updating the JS7 Controller
Preparation
nothing to do
Update
rerun the installer
Rollback
similar to what is explained for headless installation
Installation without GUI
The update to the JS7 Controller is performed from the same download file as we use for any fresh installation:
js7_controller_windows.x.x.x.zip
for windowsjs7_agent_unix
Run the installer for JS7 Controller parametrized with thecontroller_install.xml
the file that is included with the extracted archive.This parameter file is preconfigured, i.e. you can run it without any changes.Code Block > cd C:\Temp\controllerlanguage bash title Windows command to open the installer GUI .x.x.x
> setup.cmd controller_install.xml.tar.gz
for Linux
Preparation
- Stop the JS7 Controller instance
- Prepare a rollback in case the updating the JS7 Controller is not successful then a backup is necessary.
- Create a .zip archive for the:
- Installation Directory:
- The default installation path for the Controller
- Installation Directory:
If you run the installer without modifications incontroller_install.xml
then- the installation path
- is
C:\Program Files\sos-berlin.com\js7\controller
- is
the http port is4444
\<controller-ID>
on Windows.
- Configuration Directory
- The default configuration path for the Controller
- is
C:\ProgramData\sos-berlin.com\js7\controller
- is
\<controller-ID>
on Windows.
- Create a .zip archive for the:
- Take a Backup of the above archives created.
Update
The update using the GUI can be done by rerunning the installer (setup.cmd) file from the zip archive and provide the same parameters such as installation paths, ports etc.
Rollback
To perform the rollback on Windows follow the below steps:
- To perform JS7 Controller instance rollback run the uninstaller.
- The default location of the
uninstall.cmd
file is:C:\Program
If you want to modify the default options then edit thecontroller_install.xml
file before you start the installer.The defaultcontroller_install.xml
the file is shown in the code listing below. The extensive comments are intended to be self-explanatory.Code Block <?xml version="1.0" encoding="UTF-8" standalone="no"?> <!-- XML configuration file for JS7 Controller setup The JS7 Controller is available with a dual licensing model. - GNU GPL 2.0 License (see http://www.gnu.org/licenses/gpl-2.0.html) - JS7 Commercial License (see licence.txt) The setup asks you for the desired license model (see <entry key="licenceOptions" .../> below). If you call the setup with this XML file then you accept at the same time the terms of the chosen license agreement. --> <AutomatedInstallation langpack="eng"> <com.izforge.izpack.panels.UserInputPanel id="home"> <userInput/> </com.izforge.izpack.panels.UserInputPanel> <!--com.izforge.izpack.panels.UserInputPanel id="licences"> <userInput--> <!-- Select the license model (GPL or Commercial) --> <!--entry key="licenceOptions" value="GPL"/--> <!-- If you selected GPL as license model than the licence must be empty. Otherwise please enter a license key if available. It is also possible to modify the license key later. --> <!--entry key="licence" value=""/> </userInput> </com.izforge.izpack.panels.UserInputPanel--> <com.izforge.izpack.panels.HTMLLicencePanel id="gpl_licence"/> <com.izforge.izpack.panels.HTMLLicencePanel id="commercial_licence"/> <com.izforge.izpack.panels.TargetPanel id="target"> <!-- SELECT THE INSTALLATION PATH The installation expands this path with the JS7 ID as subdirectory. It must be absolute! For example C:\Programlanguage xml title Content of controller_install.xml linenumbers true Files\sos-berlin.com\js7\controller
\<controller-ID>\Uninstaller
on Windows.
- The default location of the
- Restore the folders from the backup by unzipping the .tar.gz/.zip archive for the installation directory and configuration directory to the respective location.
- Re-Install the windows service from the command line:
- Switch to the
./bin
directory for the Controller from the command line- The default location of the
./bin
directory is:C:\Program Files\sos-berlin.com\js7\controller
- The default location of the
- Switch to the
Debugging
...
\<controller-ID>\bin
on Windows.
Run the below command. This command installs the Controller's Windows Service.
controller.cmd
install
-service [-http-port=<number>] [-ip-address=<
hostname
or ip address>]
Installation Log
The installer creates a log file in the directory that is pointed to by the environment variable JS7_CONTROLLER_LOGS
or in the logs
subdirectory of the Controller configuration directory.
- The default path of the
logs
directory for the Controller are:C:\ProgramData\sos-berlin.com\js7\controller/<Controller-ID>
on Windows.
- Installation log files are named according to the pattern,
Install_V[release]_[date&time]_....log
where release is the version release number and date and time refer to the installation.
- For further references about the logging refer to the complete overview of log files JS7 - Logging
Further References
JS7 - Controller - Command Line Operation
...