Complete the following steps to download and install Alison Wizard image into your server.
After this process, you'll have a docker instance published locally. You can publish
Download image
In order to Step 1- \ --mount type=bind,source="$(pwd)"/config/tenants, \ target=/opt/jboss/config/tenantscertisursa/wizard:latest |
| Info | ||
|---|---|---|
| ||
Alison Wizard docker image includes an ACME tenant inside. You must overwrite that definition to include your own company or project tenants. In case you want to modify the default configuration, go to step 5 to download a template of a different configuration. You can copy its content to your local machine and make the changes to:
At the moment of running the image, follow the instructions of Step 3 |
Step 4- Test Alison wizard
Open your browser pointing to http://localhost:8080/acme (or the port defined by you) to access the URL where you published your Alison Wizard installation. You'll see the following image.
| If you can see this image means that you have Alison Wizard running into your docker container. |  |
.
RelatedDebbie is module used to validate certificates and signaturesDebbie
Download the files from the following link Define following variables to your docker instanceStep 6- Define environment variables and mount external volumes
Configure your into in varables 7_Use theThe previous variables and volume mappings are used to define the new configuration, in this example as a docker_compose.yml file.
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
version: '3'
services:
wizard:
image: certisursa/wizard:latest
environment:
ENABLED_TENANTS: looney
WIZARD_SECRET_KEY_BASE: 95820b3cea66376d006bf3ca3adf48287c1fc671e81c5956f8cd56aaffc4ac707673872d3d8561e14d851dea4c685a9874329a86f5c4b741e6e187cb70895820
BASE_INSTALLERS_PATH: https://s3.amazonaws.com/downloads.certisur.net/installers
volumes:
- "./wizard/tenants:/opt/jboss/config/tenants"
- "./wizard/logs:/opt/jboss/logs"
ports:
- 8082:8080
|
Launch the container from a shell
| Code Block | ||||
|---|---|---|---|---|
| ||||
> docker-compose --verbose -f docker-compose.yml up -d |
Open your browser pointing to http://localhost:8082/looney (or the port defined by you) to access the URL where you published your Alison Wizard installation. You'll see the following image.
| If you can see this image means that you have Alison Wizard running into your docker container. |
|
| Note | ||
|---|---|---|
| ||
Up to here, you can change look&feel |
.
a download include debbie you debbie variables configuretion debbie http debbie healthcheck
| Info | |
|---|---|
|
| title | Conclusion |
|---|
Wizard Configuration
Alison Wizard docker image includes an ACME tenant inside. You must overwrite that definition to include your own company or project tenants.
Environment Variables
Configure the following variables to customize your tenants and platforms.
Internal encryption key. It's a random 128 hexadecimal characters long key.
Create your own key and replace it.
Inside of this directory you have to create a subforder for each product version as it is described below.
You don't need to expose this site to internet, just need to be accessed by Alison Wizard.
Volumes
The following volumes must be mounted on the Docker image to overwrite the variables of each defined tenant.
Running Custom Tenant
After configuring your own tenant, launch a new docker image with the new configuration.
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
# docker run -d \
-it \
-p 8080:8080 \
--name wizard \
--mount type=bind,source="$(pwd)"/config/tenants, target=/opt/jboss/config/tenants \
-e ENABLED_TENANTS=acme \
-e BASE_INSTALLERS_PATH=https://<wizard_url>/installers \
-e DEBBIE_BASE_URL=https://<debbie_url:port>/ \
-e WIZARD_SECRET_KEY_BASE=a95820b3cea66376d06bf3...9a86f5c4b741e6e187cb7085aaee \
certisursa/wizard:latest |
License
Alison Wizard comes preinstalled with a universal license valid for up to 1 year.
To obtain a full license, contact CertiSur team (support@certisur.com) and inform the domain list (from all environments: development, staging, production) where the container will be published.
CertiSur will return a definitive license covering all the domains informed with a 3 years validity.
The license file must be included in each tenant configuration folder.
Plugins
These optional components may be installed on some browsers (Firefox, Chrome, Internet Explorer) to allow a different communication between the browser and Alison Desktop.
Plugins must be enabled by domain, similar to license.
| Warning | ||
|---|---|---|
| ||
In the particular case of Internet Explorer, you will download an ActiveX component, that will require administrator privileges to be installed. |
Tenant Configuration
Each tenant has its own configuration, and every Alison Wizard docker instance can manage one or several tenants.
The configuration file allows defining all the behavior of the Wizard for each tenant. It is easy to make changes in the operation of the application. It requires to reload the Alison Wizard container image to apply any change made on these files.
The following files define tenant configuration and must be customized or replaces.
This is the main configuration file. It defines keystores, providers, filters, and plugins.
It also defines minimal and suggested Alison-Desktop version.
background_world_map.png
background_world_map_ie.png
This file includes a license for the enabled domains.
This file must be replaced by a definitive license file, that can extend new domains and expiration date.
Create a new Tenant
The best way to create a new tenant is to copy ACME tenant configuration distributed on the last version of Docker Image, modify its name and apply changes on each related file.
| Warning | ||
|---|---|---|
| ||
After copying and configuring the new Tenant, the new name must be included in the ENABLED_TENANTS variable and restart the container. |