This k2space.sh shell script simplifies the creation and deletion of Fabric. You can also use it to list and get information about existing Fabric spaces using:
Usage: `./k2space.sh COMMAND [OPTIONS] SPACE_NAME`
Running k2space.sh on Microsoft Windows
The
k2space.sh
file is abash
script. A Windows PowerShell-compatible script is not yet available. To run thek2space.sh
script, start theGit Bash
applications offered by Git. UsingGit Bash
you can run the script after changing the directory to its location.If you have Git integration enabled within Windows Explorer, you can also start
Git Bash
from Windows Explorer by navigating to the script's directory, right-clicking within the Explorer's window, and selecting 'Show more options'. This will display an 'Open Git Bash here' menu item that can be used to startGit Bash
to runk2start.sh
.
Listing your Spaces
List all Fabric spaces, along with some information such as profile, status (running / stopped), Web Studio port, and the URL that can be used for accessing Web Studio if Traefik is running.
Use:
./k2space.sh list
Creating Additional Spaces
Launch a Fabric space - spacename (optionally, with the selected space profile).
Use:
./k2space.sh create [--profile=profile-name] spacename
After creating your first Space, you will need to wait for Fabric to come up. Unless it up you may get a 404 error if Traefik hasn't yet processed its new ingress rules which may take a few seconds. Otherwise, you might get a 502 error if Traefik is ready but Fabric is not yet ready. Give it some time.
Starting a Space
To start a Fabric space use:
./k2space.sh start spacename
After starting a Space, you will need to wait until Traefik processes the new configuration and Fabric starts; otherwise, you may experience 404 and 502 errors temporarily.
Stopping a Space
To stop a Fabric space use:
./k2space.sh stop spacename
Destroying a Space
Delete the Fabric space - spacename.
This act will not delete the persistent files created by Web Studio and your database(s). You must manually delete them; they are located in the persistent-data/spacename
directory.
Use:
./k2space.sh destroy spacename
Traefik starts automatically after you create your first Fabric space. It will also check whenever a new Fabric space is created. If Traefik is not running, it will be started automatically.
Note: Traefik relies on the Docker network created during the creation of a Fabric space. Therefore, it must be started after the Fabric space.
To restart Traefik (e.g., after configuring your TSL certificates), run the command below:
docker compose -f k2vingress-compose.yaml restart
You are ready to add users. You can experiment with the built-in System DB (e.g., Postgres or Cassandra data stores). We recommend using alternate authentication providers rather than using built-in providers.
To use the built-in authentication provider, navigate to the Web Admin App. Select the Security tab. Select the Users tab and add a user. Select the Roles tab, create a new role (e.g., User), and then assign Fabric permissions to the newly created role.
The Docker Compose Runtime for K2view Fabric Web Studio employs underlying Fabric security capabilities and configurations. Fabric works with several authentication providers. Each authenticator is responsible for handling user authentication and managing user IDs and roles.
Following are the supported authentication providers as described here.
Here are the command options for k2space.sh:
--profile= Allows you to select the desired Fabric Space Profile
--heap= Allows you to override the default 2GB allocated heap size
--fabric-version= Allows you to override the Fabric version specified in the .env file
--compose= Allows you to use a custom Docker compose.yaml file
The Fabric version is specified using major.minor Fabric version identifiers, e.g., 8.1.7_22.
These configuration files contain required or custom settings used by Fabric. Configure parameters as if you were editing any ini file to update the config.ini file.
[section1]
key1=value1
key2=value2
[section2]
key1=value1
key2=value2
This temporary container sets the proper ownership of the persistent data's Space folder. After its execution, it should exit automatically.
This k2space.sh shell script simplifies the creation and deletion of Fabric. You can also use it to list and get information about existing Fabric spaces using:
Usage: `./k2space.sh COMMAND [OPTIONS] SPACE_NAME`
Running k2space.sh on Microsoft Windows
The
k2space.sh
file is abash
script. A Windows PowerShell-compatible script is not yet available. To run thek2space.sh
script, start theGit Bash
applications offered by Git. UsingGit Bash
you can run the script after changing the directory to its location.If you have Git integration enabled within Windows Explorer, you can also start
Git Bash
from Windows Explorer by navigating to the script's directory, right-clicking within the Explorer's window, and selecting 'Show more options'. This will display an 'Open Git Bash here' menu item that can be used to startGit Bash
to runk2start.sh
.
Listing your Spaces
List all Fabric spaces, along with some information such as profile, status (running / stopped), Web Studio port, and the URL that can be used for accessing Web Studio if Traefik is running.
Use:
./k2space.sh list
Creating Additional Spaces
Launch a Fabric space - spacename (optionally, with the selected space profile).
Use:
./k2space.sh create [--profile=profile-name] spacename
After creating your first Space, you will need to wait for Fabric to come up. Unless it up you may get a 404 error if Traefik hasn't yet processed its new ingress rules which may take a few seconds. Otherwise, you might get a 502 error if Traefik is ready but Fabric is not yet ready. Give it some time.
Starting a Space
To start a Fabric space use:
./k2space.sh start spacename
After starting a Space, you will need to wait until Traefik processes the new configuration and Fabric starts; otherwise, you may experience 404 and 502 errors temporarily.
Stopping a Space
To stop a Fabric space use:
./k2space.sh stop spacename
Destroying a Space
Delete the Fabric space - spacename.
This act will not delete the persistent files created by Web Studio and your database(s). You must manually delete them; they are located in the persistent-data/spacename
directory.
Use:
./k2space.sh destroy spacename
Traefik starts automatically after you create your first Fabric space. It will also check whenever a new Fabric space is created. If Traefik is not running, it will be started automatically.
Note: Traefik relies on the Docker network created during the creation of a Fabric space. Therefore, it must be started after the Fabric space.
To restart Traefik (e.g., after configuring your TSL certificates), run the command below:
docker compose -f k2vingress-compose.yaml restart
You are ready to add users. You can experiment with the built-in System DB (e.g., Postgres or Cassandra data stores). We recommend using alternate authentication providers rather than using built-in providers.
To use the built-in authentication provider, navigate to the Web Admin App. Select the Security tab. Select the Users tab and add a user. Select the Roles tab, create a new role (e.g., User), and then assign Fabric permissions to the newly created role.
The Docker Compose Runtime for K2view Fabric Web Studio employs underlying Fabric security capabilities and configurations. Fabric works with several authentication providers. Each authenticator is responsible for handling user authentication and managing user IDs and roles.
Following are the supported authentication providers as described here.
Here are the command options for k2space.sh:
--profile= Allows you to select the desired Fabric Space Profile
--heap= Allows you to override the default 2GB allocated heap size
--fabric-version= Allows you to override the Fabric version specified in the .env file
--compose= Allows you to use a custom Docker compose.yaml file
The Fabric version is specified using major.minor Fabric version identifiers, e.g., 8.1.7_22.
These configuration files contain required or custom settings used by Fabric. Configure parameters as if you were editing any ini file to update the config.ini file.
[section1]
key1=value1
key2=value2
[section2]
key1=value1
key2=value2
This temporary container sets the proper ownership of the persistent data's Space folder. After its execution, it should exit automatically.