Before installing ActiveSpaces processes as Windows services, create folders to save the realm data and the logs. Create TIBCO FTL configuration file and tibdg configuration scripts that can be later used to create the grid.
The logs from the TIBCO FTL servers and ActiveSpaces processes are stored in the logs directory.
The realm data from the TIBCO FTL servers are stored in the realm_data directory. The ActiveSpaces grid data for a grid named _default are stored in the _default directory.
2. Create a TIBCO FTL configuration file with the following content and save it to
C:\activespacesdata\ftl.yaml.
TIBCO recommends that you run a separate TIBCO FTL server on each machine.
globals:
data: C:\activespacesdata\realm_data
logfile: C:\activespacesdata\logs\ftl1-rs-log.txt ftl2:
- realm:
data: C:\activespacesdata\realm_data
logfile: C:\activespacesdata\logs\ftl2-rs-log.txt ftl3:
- realm:
data: C:\activespacesdata\realm_data
logfile: C:\activespacesdata\logs\ftl3-rs-log.txt services:
realm: {}
3. Create a tibdg configuration script with the following content and save it to C:\activespacesdata
\_default.tibdg.
grid create copyset_size=2 copyset create cs_01 copyset create cs_02
node create --copyset cs_01 --dir C:/activespacesdata/_default/cs_01.n_1_data cs_01.n_1
node create --copyset cs_01 --dir C:/activespacesdata/_default/cs_01.n_2_data cs_01.n_2
node create --copyset cs_02 --dir C:/activespacesdata/_default/cs_02.n_1_data cs_02.n_1
node create --copyset cs_02 --dir C:/activespacesdata/_default/cs_02.n_2_data cs_02.n_2
This configuration file is used later to create the grid.
Installing TIBCO FTL Server as a Windows Service Prerequisites
Complete the steps mentioned in Preparing for Installation.
Procedure
● Based on the YAML file created in Step 2 in Preparing for Installation, install three FTL servers, each pointing to ftl.yaml configuration file and each having a unique name.
TIBCO_HOME\ftl\<ftl_version>\bin\prunsrv.exe //IS/tibftlserver1
If you plan to copy the code snippet, remember to remove line breaks for all the sample commands that are associated with prunsrv.exe.
In this example, a separate port was specified for each of the servers (8085, 8185, 8285) to allow all three TIBCO FTL servers to run on the same machine. In most cases, the same port could be used if the TIBCO FTL servers were being run on three different machines. The ActiveSpaces start
parameters for each process must use a pipe (“|”) separated list of URLs so that it can communicate with any of the TIBCO FTL servers. In this case the pipe-separated list would be http://
localhost:8085|http://localhost:8185|http://localhost:8285. If different ports are chosen in the ftl.yaml config file, those start parameters must also be updated for the ActiveSpaces processes.
Creating the ActiveSpaces Grid Prerequisites
1. Complete the steps listed in Preparing for Installation.
2. Complete the steps listed in Installing TIBCO FTL Server as a Windows Service.
3. On Microsoft Windows, open the Services window and manually start each of the TIBCO FTL servers. Ensure that the TIBCO FTL servers are running. Verify by taking a look at the logs that are written to C:\activespacesdata\logs and the realm data that is written to C:\activespacesdata
\realm_data.
Procedure
1. Create the example data grid by using the tibdg.exe administration tool, which creates the grid definition in the realm. The grid definition saved from the Step 3 in Preparing for Installation is found in C:\activespacesdata\_default.tibdg.
TIBCO_HOME\as\<as_version>\bin\tibdg -r "http://localhost:8085|http://
localhost:8185|http://localhost:8285" -s C:\activespacesdata\_default.tibdg
2. After creating the grid, check the status using the tibdg.exe administration tool.
TIBCO_HOME\as\<as_version>\bin\tibdg -r "http://localhost:8085|http://
localhost:8185|http://localhost:8285" status
The output shows the grid and the processes that are not yet running.
Grid Status
Installing the ActiveSpaces Statekeeper as a Windows Service
Prerequisites
Perform the following tasks:
1. Before using TIBCO ActiveSpaces processes as Windows services, ensure that both Java and the TIBCO FTL Windows package and the TIBCO ActiveSpaces Windows package are installed on a local disk of the host computer (not on a mapped network drive).
2. Complete the steps listed in Preparing for Installation.
3. Complete the steps listed in Installing TIBCO FTL Server as a Windows Service.
4. Complete the steps listed in Creating the ActiveSpaces Grid.
Procedure
1. Use the following command to install three state keeper processes as Windows Services:
TIBCO_HOME\as\<as_version>\bin\prunsrv.exe //IS/tibdgkeeper_default_k_1 DisplayName="TIBCO ActiveSpaces Statekeeper k_1 (_default)"
--Install=TIBCO_HOME\as\<as_version>\bin\prunsrv.exe
--StartMode=exe --StartImage=TIBCO_HOME\as\<as_version>\bin\tibdgkeeper.exe --LibraryPath=TIBCO_HOME\as\<as_version>\bin;TIBCO_HOME\ftl\<ftl_version>\bin --StartParams=-r;"http://localhost:8085|http://localhost:8185|http://
localhost:8285";-n;k_1;--logfile;C:\activespacesdata\logs\_default-k_1-log.txt --StopMode=exe --StopTimeout=30 --StopImage=TIBCO_HOME\as\<as_version>\bin
\tibdg.exe
--StopParams=-r;"http://localhost:8085|http://localhost:8185|http://
If you plan to copy the code snippet, remember to remove line breaks for all the sample commands that are associated with prunsrv.exe.
2. On Microsoft Windows, open the Windows Services panel manually start each of the state keepers.
The logs are written to C:\activespacesdata\logs and the process data is written to
C:\activespacesdata\_default\process_name.
Installing the ActiveSpaces Node as a Windows Service
Prerequisites
Perform the following tasks:
1. Before using TIBCO ActiveSpaces processes as Windows services, ensure that both Java and the TIBCO FTL Windows package and the TIBCO ActiveSpaces Windows package are installed on a local disk of the host computer (not on a mapped network drive).
2. Complete the steps listed in Preparing for Installation.
3. Complete the steps listed in Installing TIBCO FTL Server as a Windows Service.
4. Complete the steps listed in Creating the ActiveSpaces Grid.
Procedure
1. Use the following commands to install the four nodes (two per copyset):
TIBCO_HOME\as\<as_version>\bin\prunsrv.exe //IS/tibdgnode_default_cs01_1
--StartMode=exe --StartImage=TIBCO_HOME\as\<as_version>\bin\tibdgnode.exe
If you plan to copy the code snippet, remember to remove line breaks for all the sample commands that are associated with prunsrv.exe.
2. On Windows, open the Windows Services panel and manually start each of the nodes.
The logs are written to C:\activespacesdata\logs and the process data is written to
C:\activespacesdata\_default\process_name.
Installing the ActiveSpaces Proxy as a Windows Service
Prerequisites
Perform the following tasks:
1. Before using TIBCO ActiveSpaces processes as Windows services, ensure that both Java and the TIBCO FTL Windows package and the TIBCO ActiveSpaces Windows package are installed on a local disk of the host computer (not on a mapped network drive).
2. Complete the steps listed in Preparing for Installation.
3. Complete the steps listed in Installing TIBCO FTL Server as a Windows Service.
4. Complete the steps listed in Creating the ActiveSpaces Grid.
Procedure
1. To install both the proxies, use the following commands:
TIBCO_HOME\as\<as_version>\bin\prunsrv.exe //IS/tibdgproxy_default_p_01
localhost:8285";-n;p_01;--logfile;C:\activespacesdata\logs\_default-p_01-log.txt
If you plan to copy the code snippet, remember to remove line breaks for all the sample commands that are associated with prunsrv.exe.
2. On Windows, open the Windows Services panel in Windows and manually start each of the proxies.
The logs are written to C:\activespacesdata\logs.
Installing the ActiveSpaces tibdgadmind as a Windows Service
Prerequisites
Perform the following tasks:
1. Before using TIBCO ActiveSpaces processes as Windows services, ensure that both Java and the TIBCO FTL Windows package and the TIBCO ActiveSpaces Windows package are installed on a local disk of the host computer (not on a mapped network drive).
2. Complete the steps listed in Preparing for Installation.
3. Complete the steps listed in Installing TIBCO FTL Server as a Windows Service.
4. Complete the steps listed in Creating the ActiveSpaces Grid.
Procedure
1. Use the following command to install two tibdgadmind processes:
TIBCO_HOME\as\<as_version>\bin\prunsrv.exe //IS/tibdgadmind1
If you plan to copy the code snippet, remember to remove line breaks for all the sample commands that are associated with prunsrv.exe.
2. On Windows, open the Windows Services panel to manually start each of the tibdgadmind
processes.