Fabric Basics - Getting Started
Start and Stop Fabric Commands
Run the following commands through the Fabric server command line:
Get Fabric Version
Run the k2fabric -version script through the Fabric server command line to get the version of Fabric installed on your server. Note that you can check the Fabric version of your server in Fabric using the VERSION INFO Fabric command.
Login Fabric
Enter Fabric From the Fabric Server
Type fabric in the Fabric server command line.
Enter the Fabric Debug Server
Fabric Studio Debug Panel can be used to start, stop and open the Fabric Console of the Fabric debug server.
Reset Fabric
The Fabric reset.sh script cleans Fabric and deletes (drops) all data from Fabric and Cassandra. The reset.sh script is located under $K2_HOME/fabric/scripts and is used mainly:
In a Test environment to delete the current data and to restart the testing process from scratch.
In a Production environment. Note that the DROP LUTYPE command and the reset.sh script are rarely used in a Production environment. A possible scenario for using these processes is to clean an environment after a soft launch prior to starting an actual Production run.
Unlike the drop LU (DROP LUTYPE) command which drops a specific LU, the reset.sh script performs a full Fabric initialization, including deleting users, tokens, metadata, data and also deletes the data from Cassandra.
The Drop process must be followed by the re-creation of Fabric credentials and redeployment of the project implementation into the Fabric server and an initial load of LUI into the re-deployed LUs.
Note that the Windows version of the $K2_HOME/fabric/scripts Reset script is reset.bat.
Run the script from $K2_HOME/fabric/scripts directory:
- ./reset.sh <mode><black_list><path of config.ini file>
Reset.sh Parameters
Parameter Name |
Mandatory |
Description |
|
Mode |
Yes |
Reset mode. The following modes are supported:
|
|
Black-list |
No |
List of Cassandra Fabric-related keyspaces or Kafka topic names that must be excluded from the drop. The names have double quotes and are separated by a space. |
|
Path |
No |
Config.ini file path. |
Run Reset.sh On a Fabric Cluster
When a Fabric cluster clean-up is required, it is recommended to execute the reset.sh script in the following order:
Run on one node, ./reset.sh drop_all; - cleans Fabric storage on the local Fabric node and removes Cassandra keyspaces and Kafka topics. Removing Cassandra keyspaces and Kafka topics impacts the entire Fabric cluster.
Run on all other nodes, ./reset.sh drop_local; - cleans Fabric storage on the local Fabric node. To reset the Fabric cluster correctly, execute the reset.sh script on all fabric nodes, and only then start each Fabric node individually.
Reset Fabric - Remove Fabric Directories
The reset.sh script gets the list of the Fabric directories to be removed from the config.ini configuration file. The following parameters are checked to get the list of removed Fabric directories:
Fabric Basics - Getting Started
Start and Stop Fabric Commands
Run the following commands through the Fabric server command line:
Get Fabric Version
Run the k2fabric -version script through the Fabric server command line to get the version of Fabric installed on your server. Note that you can check the Fabric version of your server in Fabric using the VERSION INFO Fabric command.
Login Fabric
Enter Fabric From the Fabric Server
Type fabric in the Fabric server command line.
Enter the Fabric Debug Server
Fabric Studio Debug Panel can be used to start, stop and open the Fabric Console of the Fabric debug server.
Reset Fabric
The Fabric reset.sh script cleans Fabric and deletes (drops) all data from Fabric and Cassandra. The reset.sh script is located under $K2_HOME/fabric/scripts and is used mainly:
In a Test environment to delete the current data and to restart the testing process from scratch.
In a Production environment. Note that the DROP LUTYPE command and the reset.sh script are rarely used in a Production environment. A possible scenario for using these processes is to clean an environment after a soft launch prior to starting an actual Production run.
Unlike the drop LU (DROP LUTYPE) command which drops a specific LU, the reset.sh script performs a full Fabric initialization, including deleting users, tokens, metadata, data and also deletes the data from Cassandra.
The Drop process must be followed by the re-creation of Fabric credentials and redeployment of the project implementation into the Fabric server and an initial load of LUI into the re-deployed LUs.
Note that the Windows version of the $K2_HOME/fabric/scripts Reset script is reset.bat.
Run the script from $K2_HOME/fabric/scripts directory:
- ./reset.sh <mode><black_list><path of config.ini file>
Reset.sh Parameters
Parameter Name |
Mandatory |
Description |
|
Mode |
Yes |
Reset mode. The following modes are supported:
|
|
Black-list |
No |
List of Cassandra Fabric-related keyspaces or Kafka topic names that must be excluded from the drop. The names have double quotes and are separated by a space. |
|
Path |
No |
Config.ini file path. |
Run Reset.sh On a Fabric Cluster
When a Fabric cluster clean-up is required, it is recommended to execute the reset.sh script in the following order:
Run on one node, ./reset.sh drop_all; - cleans Fabric storage on the local Fabric node and removes Cassandra keyspaces and Kafka topics. Removing Cassandra keyspaces and Kafka topics impacts the entire Fabric cluster.
Run on all other nodes, ./reset.sh drop_local; - cleans Fabric storage on the local Fabric node. To reset the Fabric cluster correctly, execute the reset.sh script on all fabric nodes, and only then start each Fabric node individually.
Reset Fabric - Remove Fabric Directories
The reset.sh script gets the list of the Fabric directories to be removed from the config.ini configuration file. The following parameters are checked to get the list of removed Fabric directories:
