Introduction to Jedox Web Sandbox
Jedox Web Sandbox is based on a concept called Site Specific Browsers (SSB). An SSB is an application with an embedded browser designed to work exclusively with a single web application. It doesn’t have the menus, toolbars, and accoutrements of a normal web browser. An SSB also has a tighter integration with the OS and desktop than a typical web application running through a web browser.
The Jedox Web Sandbox is used for accessing Jedox Web. It can be installed as a component in the Jedox installation, and can be used in parallel to any other Web browser that is installed on the system. There also is a specific Setup for installing only the Jedox Web Sandbox, for example in unattended software deployment scenarios, where the Sandbox is installed unattended on multiple client machines.
Change as of Jedox Version 7.0 SR1
As of Version 7.0 SR1, Jedox Web Sandbox will only allow one running instance of sandbox client by default. This can be overridden by starting JedoxWebSandbox.exe with command line parameter /x ,
e.g. JedoxWebSandbox.exe /x
Installing Jedox Web Sandbox
Installation with Sandbox (standalone) setup
- Jedox Web Server should be set up and running.
- Firewall / Antivirus settings should be adjusted so client can reach the server with Jedox Web.
Run the Jedox Web Sandbox setup file by double-clicking it. The setup will recognize an existing Jedox Web Sandbox version and the setup will update this installation.
Step 1 – Select the language for installation:
Step 2 – Jedox Web Sandbox Setup Wizard:
Step 3 – License Agreement:
Step 3 a – Setup has found an existing Sandbox installation. In this case you have the following possibilities:
- Repair / Update: current components will be deinstalled and Setup will install Jedox Web Sandbox anew. Setup will continue with step 4 and you can define the data for the new Sandbox installation.
- Delete: Existing Sandbox installation will be removed.
Step 4 – Selection of Sandbox installation folder:
Step 5 – Setting Options: Server IP with port and name for the icon on desktop:
Enter here the interface (IP/DNS) and port to the server where Jedox Web Server is installed.
If you click on the “Test” button, setup will try to connect to Jedox Server and give a brief message if the server is reachable or not.
Step 6 – Completing the Jedox Web Sandbox installation:
After this message, you can start the installed software via Start – Programs – Jedox Suite – Jedox Web Sandbox.
Installation with Jedox Premium Setup
If you want to install Jedox Sandbox using Jedox Premium Setup, just a few things are different:
- You have the option to install the component Sandbox only in advanced installation mode.
- If you also select Jedox Web for the installation, then this Jedox Web Server address will be used for the Sandbox installation. There is no dialogue to enter a different Jedox Web Server address.
- If you don’t select Jedox Web for the installation, then you will receive the dialogue to enter the Jedox Web Server address.
Automated / Silent Installation
Just as for the Jedox All-In-One Setup, Jedox Sandbox Setup provides the possibility to record scripts for automated/silent execution. To record the settings for the script, setup needs to be started from a command line with the parameter /SAVEINF=”config_sandbox.inf”.
Example: Jedox_Sandbox_7_0.exe /SAVEINF=”config_sandbox.inf”
The standard installation process starts and all settings are recorded to the file “config_sandbox.inf”, which is in the same directory where the setup is located.
To run automated installation with settings from the script, setup needs to be started with two parameters:
Jedox_Sandbox_7_0.exe /LOADINF="config_sandbox.inf" /SILENT
Cache/chromium log (cef.log) and sandbox.log for new Sandbox are located under user AppData:
Settings for the new Sandbox are stored in XML format in a file named “user.config”. This file is in the same directory as the cache and log files, but it is only created at first start.
Initial settings are loaded from JedoxWebSandbox.exe.config located in Sandbox installation directory (e.g. C:\Program Files (x86)\Jedox\Jedox Suite\sandbox).
Content of config:
BrowserWidth: width of the Sandbox. automatically set by Sandbox.
BrowserHeight: height of the Sandbox. automatically set by Sandbox.
BrowserMaximized: as name says, automatically set by Sandbox.
DefaultURL: URL of Jedox Web, e.g. http://127.0.0.1:80/
Username: default username for auto login
Password: default password for auto login
Secret: secret of Jedox Web (Can be found in config.php)
UseSSO: if this is set to true, Username/Password is ignored. SSO settings are taken from system settings (like the behavior of Chrome).
ActiveLanguage: language for Sandbox
If you want to use auto login, you have to set username/password AND secret. The values are stored encrypted with DES.
All settings, except the URL, can be set by Settings dialogue in Sandbox (right click on title bar, then click on settings).