install fp

This command is used to install a Fulfillment Provisioning node:

Fulfillment Provisioning Commands

provadmin install fp [ configpath=<value> ]
                     [ adminport=<value> ]
                     [ memorysize=<value> ]
                     [ nameserviceport=<value> ]
                     [ buildtype=<value> ]
                     [ nodename=<value> ]
                     [ nogui=<value> ]
                     [ debugfilter=<value> ]
                     [ lockedObjectHashSize=<value> ]
                     [ language=<value>]

The following table describes the general options that are valid with the install command:

Option Description
configpath

Specifies the directory from which configuration files are loaded. The default directory is: $SW_HOME/distrib/kabira/kpsa/samples/prov/conf.

These are the configuration files loaded from configpath upon install:

  • fp.kds: Deploy specification. If a custom fp.kds is not found in the configuration path and no fp.kds is found, then $SW_HOME/distrib/kabira/kpsa/deploy/fp.kds is used.

  • provisioning.bpmn: BPMN file for the main flow. It searches for the provisioning.bpmn file if the provisioning.bpmn file is not found.

  • *.def: Fulfillment Provisioning Catalog definition files. These files are created using the Fulfillment Provisioning Catalog application.

  • *.xml and *.bpmn: XML files for ProductOrderFlows. The cpr.def file references these *.bpmn and *.xml files.

Upon installation, these file will be loaded into the $SW_HOME/<nodename>/conf directory.

adminport Specifies the web server port (randomly generated by default)
memorysize Specifies the size of shared memory in MB (default 512)
nameserviceport Specifies the port to use for name service (default random)
buildtype Specifies the build type of components to be loaded. Must be PRODUCTION or DEVELOPMENT (default PRODUCTION)
nodename Specifies the name of the Fulfillment Provisioning node (default is the name of the server)
nogui Specifies whether Fulfillment Provisioning is to install/start Catalog GUI (default false)
debugfilter

Sets the debug trace level. To set a debug level use the following as a guide: 

NoSubsystems =          0x00000000,
SystemServices =        0x00000001,
EventDistributionBus =  0x00000002,
ObjectServices =        0x00000004,
SystemManagement =      0x00000008,
SystemMonitor =         0x00000010,
WhiteBoxTesting =       0x00000020,
NetworkElement =        0x00000040,
Persistence =           0x00000080,
Distribution =          0x00000100,
CodeGeneration =        0x00000200,
Exceptions =            0x00000400,
Script =                0x00000800,
Performance =           0x00001000,
Recovery =              0x00002000,
Java =                  0x00004000,
SystemCoordinator =     0x00008000,
Engine =                0x00010000,
Allocator =             0x00020000,
Corba =                 0x00040000,
Transform =             0x00080000,
DistributionDisc =      0x00100000,
DistributionPDU =       0x00200000,
User =                  0x00400000,
DirectoryServices =     0x00800000,
Security         =      0x01000000,
DesignCenter =          0x02000000,
AllSubsystems =         0x03FFFFFF
lockedObjectHashSize (Default=101) This number must be a PRIME number > 101. Allows the configuration of the "node\ObjectServices" -> "lockedObjectHashSize" registry value before starting the node. This specifies the hash start size for locked objects inside one transaction. If you have small transactions with a low number of objects locked, setting a high value will decrease performance. On the other hand, if you have transactions involving large numbers of objects, you may experience a significant performance boost by setting this to a high value. Please consult TIBCO before changing this value.
language Specifies which language to use for event dictionary (default en), list of available languages depends on which package language is installed in the TIBCO_HOME location.

The following shows the usage and typical output of the install fp command. 

provadmin fp install debugfilter=0x03FFFFFF adminport=18000 memorysize=500
    Loading hlralcatelr5.bpmn
    Loading pof04.bpmn
    Loading provisioning.bpmn
    Loading vms.bpmn
    Loading cpr.def
    Loading cps.def
    Loading kop-1.0.0.def
    Loading kop-1.1.0.def
    Loading xdsl.def
    Loading CA_exchanges.ini
    Loading CA_request_latency.ini
    Loading checkpointconfig.ini
    Loading config.ini
    Loading fwriter.ini
    Loading fpstats-default.ini
    Loading Shared_Memory.ini
    Loading SO_in_queue.ini
    Loading SO_number.ini
    Loading SO_processing_time.ini
    Loading trace.ini
    Loading WO_number.ini
    Loading WO_processing_time.ini
    Loading mapping.dm
    Loading createCarts.tst
    Loading deleteCarts.tst
    Loading cesrouter.trn
    Loading hlralcatelr5.trn
    Loading vms.trn
    Checkpoint directory is ../checkpoints
    Installing node

    Starting node $(hostname) ...
        Installing Registry ...
        Updating Registry ...
        Installing Components ...
        Starting Components ...
        Waiting for security services to start ...
        Loading Security Policy ...
    Startup complete

    Node $(hostname) is configured to use PRODUCTION executables
    Node $(hostname) shared memory size is 500Mb
    Node $(hostname) path: /home/nicolas/$(hostname)
    Node $(hostname) host: $(hostname)
    
    System Coordinator Host: All Interfaces
    System Coordinator Port: 21325
    
    Web Server Host: All Interfaces
    Web Server Port: 18000
    

    Node $(hostname) is configured to use PRODUCTION executables
    Node $(hostname) shared memory size is 500Mb
    Node $(hostname) path: /opt/kabira/users/svngate9/TOTO/$(hostname)
    Node $(hostname) host: $(hostname)
    
    System Coordinator Host: All Interfaces
    System Coordinator Port: 21325
    
    Web Server Host: All Interfaces
    Web Server Port: 18000
    
    Loading fp components
    Setting traceDebugFilter to 0x03FFFFFF for fp::fp

$ ls $(hostname)/
conf                dcpid   DSERegistry.sm          manual_archive  php.ini           
swsrv.kds                System::osw_config.xml           System::swcoordadmin.log
coordinator.log     dcport  $(hostname)_config.xml  manual_input    prodlib           
System::kssl_config.xml  System::osw.log
coordinator.stdout  devlib  fp::fp_config.xml       ossm            reinject_archive  
System::kssl.log         System::swcoordadmin_config.xml