pinit

The pinit command copies the service model data of the publish environment to the specified cells. Initializing a cell does not remove status values from component instances.

If publish from BMC Atrium CMDB is enabled, then the cells are automatically initialized with the data of the Atrium Publish environment to which they are assigned, and default management data is also created on the cells. Normally, the BMC Impact Publishing Server initializes new cells automatically. You might need to use the pinit command to restore a cell's service model when it is not in sync with the impact service model of BMC Atrium CMDB.

If publish from BMC Atrium CMDB is disabled, then you must publish the management data manually before the components and impact relationships by using the pposter CLI command.

For more information for a Direct Publish environment, see Initializing-a-cell-from-a-Direct-Publish-environment.

Note

When performing a pinit of a large service model, the Stack Size and the Heap Size of the Publishing Server might need to be increased. For service models with approximately 10,000 CIs and 10,000 relationships, you must double both the Stack Size and the Heap Size. To double the Stack Size, in the pserver.bat file (Windows) or the pserver file (UNIX), either change the default -Xoss400k and -Xss512k values to -Xoss800k and -Xss1M or add -Xoss800k and -Xss1M if the default -Xoss400k and -Xss512k values are not present. To double the Heap Size, in the pserver.bat or pserver file, change the default -Xms256M -Xmx800M values to -Xms512M -Xmx1600M. Additionally, in the pserver_service.conf file, add the following parameters before restarting the Publishing Server:
wrapper.java.additional.2=-Xms512M
wrapper.java.additional.3=-Xoss800k
wrapper.java.additional.4=-Xss1M
wrapper.java.additional.5=-Xmx1600M
Making these changes will allow publishing of 10k models successfully if you run pserver.bat or pserver manually.

pinit syntax

pinit <common options> [-f] [-n <cellName1>[,<cellName2>[...]] |-a ] -e <EnvId> [-s <Description>]

pinit command options

The following table lists the command options for pinit.

no options are required for {{pinit}}.

pinit options

Option	Description
<common options> -c -h -? -i -q -l -p -t -v -z	See Common-command-options-for-Publishing-Server-CLIs.
-a	Initializes HomeCell or the cells defined by CellAliases If one or more of the cells cannot be initialized (for example, because a cell is not running), none of them is initialized and the request fails.
-f	Forces the cell initialization without prompting you to confirm the initialization action If the -f option is not specified, you are prompted to confirm the initialization action.
-ncellName1[,cellName2[...]]	For a BMC Atrium CMDB publish environment: specifies the cells to initialize or reinitialize with the impact service model. On Windows platforms, you must enclose the cell list in quotation marks ("). If a cell name is not specified, the default cell name (the unqualified version of the host computer name) is used. If such a cell does not exist or does not belong to the considered environment, the command fails. If one or more of the cells cannot be initialized (for example, because a cell is not running), none of them is initialized and the request fails.
-sDescription	Describes request
-eEnvID	Sets environment identifier to EnvID. The default value is PROD. It specifies either an Atrium CMDB environment or a Cell Publish environment, depending on the value of OriginId. For example: OriginId=AtriumCMDB or OriginId=CellPublish.

When you execute a pinit command for a specific environment, only the data for that environment is reinitialized. Therefore, if the same cell contains different environments (for example, Atrium Publish and CellPublish), then only part of the data of the cell is reinitialized.

pinit examples

This section provides examples of using the pinit command to initialize or reinitialize a cell with service model data.

Initializing a cell with the production service model data from the BMC Atrium CMDB

To initialize or reinitialize a cell whose name is ShortHostName with the BMC Atrium CMDB production service model, type the following command. (The ShortHostName is the unqualified version of the host computer name.)

pinit pncell_host1

Initializing a specific cell with the BMC Atrium CMDB production service model

To initialize a specific cell named jana with the BMC Atrium CMDB production service model, enter the following command:

pinit -n jana

Initializing all BMC Atrium Core Console-registered cells with the BMC Atrium CMDB production service model

To initialize all the cells registered with the with the BMC Atrium CMDB production service model, enter the following command.

pinit -a

If one or more of the specified cells cannot be initialized, for example, if a cell is not running, none of them is initialized and the request fails.

Initializing a cell's data for a Direct Publish environment

To initialize the cell name austin in the Direct Publish environment Sales, enter the following command:

pinit -n austin -e Sales

This command removes all data of the service model in the Direct Publish environment Sales. In the cell, this corresponds to data that has the slot publish_env_id set to DirectPublish.Sales.

pinit return codes

For information about CLI return codes, see Return codes for Publishing Server CLIs.