install fp

This command is used to install a Fulfillment Provisioning node: 

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

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

After installation, the following configuration files are loaded:

  • fp.kds :Deploy specification. If a custom fp.kds is not found in configuration path, the application looks for kpsa.kds. If kpsa.kds is not found, then $SW_HOME/distrib/kabira/kpsa/deploy/fp.kds will be used.

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

  • kop-<version>.def: Fulfillment Provisioning Catalog definition files. These are created using the Fulfillment Provisioning Catalog Application.

  • *.xml and *.bpmn : XMI files for ProductOrderFlows. The

    cpr.def file will reference *.bpmn and *.xml files.

After installation, these files are loaded into the $SW_HOME/<nodename>/conf directory.

adminport The web server port. The default value is a random number.
memorysize The size of shared memory in MB, The default size is 512 MB.
nameserviceport The port used for name service. The default value is a random number.
buildtype The build type of components to be loaded. The values can be PRODUCTION or DEVELOPMENT. The default value is PRODUCTION.
nodename The name of the Fulfillment Provisioning node.The default value is the name of the server.
nogui Used to specify whether or not Fulfillment Provisioning should install or start Catalog GUI. The default value is 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 Is used to configure the node\ObjectServices-> lockedObjectHashSize registry value before starting the node. The default value is 101.This number must be a prime number greater than 101. This value represents the hash start size for locked objects inside one transaction. When you have small transactions, with lesser 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 The language to be used in the event dictionary. The default value is en. The list of available languages depends on the language package that is installed in SW_HOME.

The following shows the usage and 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 kpsastats-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 einsteinium ...
        Installing Registry ...
        Updating Registry ...
        Installing Components ...
        Starting Components ...
        Waiting for security services to start ...
        Loading Security Policy ...
    Startup complete

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

    Node einsteinium is configured to use PRODUCTION executables
    Node einsteinium shared memory size is 500Mb
    Node einsteinium path: /opt/kabira/users/svngate9/TOTO/einsteinium
    Node einsteinium host: einsteinium
    
    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 einsteinium/
conf                dcpid   DSERegistry.sm          manual_archive  php.ini           
swsrv.kds                System::osw_config.xml           System::swcoordadmin.log
coordinator.log     dcport  einsteinium_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

>