Product configuration files after upgrade
After you finish upgrading BMC Cloud Lifecycle Management, you must review every file mentioned in the following table where the values are not retained post-upgrade and check for the parameters whose values have got changed. Compare the latest version of the file with the backed-up version.
This topic contains the following information:
Before you begin
Review Product-configuration-files-before-upgrade.
Product configuration files after upgrade
Product files | Values retained after upgrade? |
|---|---|
Platform Manager |
|
cloudservices.json Linux: <PM_Install_Directory>/Platform_Manager/configuration | ❌️ |
providers.json Linux: <PM_Install_Directory>/Platform_Manager/configuration | ❌️ |
wrapper.conf Linux: <PM_Install_Directory>/Platform_Manager | ❌️ |
config.ini Linux: <PM_Install_Directory>/Platform_Manager/configuration | ❌️ |
csm-bootstrap.properties Linux: <PM_Install_Directory>/Platform_Manager | ❌️ Check for safety if any parameter is customized in this file. |
BMC Server Automation |
|
Config Server Use the BMC Server Automation Console to enter Application Server settings as required. Your changes are stored in the database.
| ✅️ |
Job Server Use the BMC Server Automation Console to enter Job Server settings as required. Your changes are stored in the database.
| ✅️ |
secure Linux: /etc/rsc/secure or /opt/bmc/rscd/NSH/conf/secure |
|
BBSA Agent on vCenter host AssetImplConfig.xml Windows: <AgentHome>\daal\Implementation\BMC_VMware_VirtualInfrastructureManager_win64\ win64\AssetImplConfig.xml. | ✅️ |
Deployments Linux: <bl_install_dir>/NSH/br/deployments | ✅️ |
AppServerProfiles.xml Linux: <bl_install_dir>/NSH/br/AppServerProfiles.xml | ✅️ |
bladelogic.keystore Linux: <bl_install_dir>/NSH/br/deployments/bladelogic.keystore | ✅️ |
Custom NSH scripts Linux: <bl_install_dir>/NSH/scripts | ✅️ |
Sensors Linux: <bl_install_dir>/NSH/share/sensors | ✅️ |
Enterprise-AR and Cloud-AR |
|
ar.conf Linux: <ARS_Home>/conf/ar.cfg | ❌️ |
armonitor.conf Linux: /etc/arsystem/<hostname>/armonitor.cfg | ❌️ Check for safety if any parameter is customized in this file. |
pluginsvr_config.xml E-AR Linux: E-AR Windows: C-AR Linux: C-AR Windows: | ❌️ Check for safety. |
CAI Plugin Registry
| ❌️ Check for safety. |
Mid Tier |
|
config.properties Linux: <MidTier_Install>/WEB-INF/classes/config.properties | ✅️ |
server.xml Linux: < Tomcat_Install>/conf/server.xml | ❌️ |
tomcat6w/startup.sh Linux: <Tomcat_Install>/bin/startup.sh | ✅️ |
BMC Atrium Orchestrator |
|
Access Manager and Repository .lax/server.sh Linux: <AMREPO_Install>/bin/server.sh | ❌️ |
Access Manager and Repository bao.sh Linux: <AMREPO_Install>/bin | ❌️ |
Access Manager and Repository repository.xml Linux: Windows: | ❌️ |
Configuration Distribution Peer Linux: <CDP_Install>/bin/server.sh | ❌️ |
Configuration Distribution Peer bao.sh Linux: <AMREPO_Install>/bin | ❌️ |
Configuration Distribution Peer log4j.xml Linux: <CDP_INSTALL_DIR>/tomcat/webapps/baocdp/WEB-INF/classes/log4j.xml | ❌️ |
BMC Network Automation |
|
BcanInstalledConfiguration.xml Linux:<BCA_NETWORKS_INSTALL_DIR>/ BcanInstalledConfiguration.xml | ✅️ |
database.properties Linux:<BCA_NETWORKS_DATA_INSTALL_DIR>/database.properties | ❌️ |
logging.properties Linux: <BCA_NETWORKS_DATA_INSTALL_DIR>/logging.properties | ❌️ |
server.xml Linux:<BCA_NETWORKS_INSTALL_DIR>/tomcat/conf/server.xml | ❌️ |
BMC Capacity Optimization |
|
freetds.conf Linux: /opt/cpit/etl/freetds/etc/freetds.conf | ✅️ |
server.xml Linux : %BCO_HOME%/web/tomcat/conf/server.xml | ✅️ |
User configurations User configurations in the BCO database | ✅️ |
BMC Database Automation |
|
Manager Configuration (Manager Host) Linux: <BDA_Install_Dir>/dmanager/etc/dmanager.conf | ✅️ |
Middle Tier Configuration (Manager Host) Linux: <BDA_Install_Dir>/dmanager/etc/mtd.conf | ✅️ |
GUI Configuration (Manager Host) Linux: <BDA_Install_Dir>/dmanager/etc/d2500_config | ✅️ |
GUI PHP Configuration (Manager Host) Linux: <BDA_Install_Dir>/etc/php.ini | ❌️ Partial – Some values reset on upgrade |
GUI Web Server Configuration (Manager Host) Linux: /etc/httpd/etc/conf/httpd.conf /etc/httpd/etc/conf.d/gridapp.conf | ❌️ Partial – Some values reset on upgrade |
MultiManager Configuration (Manager Host) Linux: <BDA_Install_Dir>/dmanager/etc/mesh.conf | ✅️ |
Agent Configuration (Agent Host) Linux/Unix: <BDA_Install_Dir>/dagent/etc/dagent.conf Windows: <BDA_Install_Dir>\dagent.conf | ✅️ |
Recommended settings
After you compare the latest version of the file with the backed-up version, manually update these parameters to their recommended values.
Platform Manager
Apply the following settings to the Platform Manager configuration files:
Configuration file | Recommended value |
|---|---|
cloudservices.json | Maximum Connections = 50 |
| Maximum number of connections = 50 |
| Number of task manager threads = 100 |
| Maximum number of task manager threads = 300 |
providers.json | "name" : " BBSA_MAX_WEBSERVICES_SESSIONS " }, "attributeValue" : "1", |
| name : "BBSA_VG_JOB_STATUS_POLLS " }, "attributeValue" : "240", |
| name:BBSA_VG_JOB_STATUS_POLL_INTERVAL_SECONDS"}, "attributeValue" : "15", |
| “name" : BBSA_USP_JOB_STATUS_POLLS " }, "attributeValue" : "240" |
| “name" : BBSA_USP_JOB_STATUS_POLL_INTERVAL_SECONDS " }, "attributeValue" : "15" |
| name : "BBSA_SCRIPT_JOB_STATUS_POLLS" }, "attributeValue" : "240" |
| name:"BBSA_SCRIPT_JOB_STATUS_POLL_INTERVAL_SECONDS"}, "attributeValue" : "15" |
| name:BBSA_SOFTWARE_JOB_STATUS_POLLS" },"attributeValue": "240" |
| name:BBSA_SOFTWARE_JOB_STATUS_POLL_INTERVAL_SECONDS"}, "attributeValue" : "15" |
| name : "BBSA_VG_AGENT_STATUS_POLLS" }, "attributeValue" : "240" |
| name:"BBSA_VG_AGENT_STATUS_POLL_INTERVAL_SECONDS" }, "attributeValue" : "15" |
wrapper.conf | Not applicable |
BMC Server Automation
Apply the following settings to the BMC Server Automation configuration files:
Configuration file | Recommended value |
|---|---|
App Server | 2 GB Heap Size Do not use the Application Server as the Job Server. |
Job Server | MaxJobs = 75 (per Job Server) |
| MaxWorkItems = 120 (per Job Server) |
| Affinity Rules: |
C:\WINDOWS\rsc\secure | rscd:port=4750:protocol=5:tls_mode=encryption_only:encryption=tls:timeout=120 |
BBSA Agent on vCenter host | <AgentHomeDirectory>\8.1\RSCD\daal\Implementation\BMC_VMware_VirtualInfrastructureManager_win64\win64\AssetImplConfig.xml, |
In addtion, review the following BMC Server Automation settings.
File name | Parameter | Recommended value | Additional information |
|---|---|---|---|
config_deployment | Max Heapsize | 2048 | Values are retained if modified and upgraded. |
Job_Deployment | Max Heapsize | 2048 | Values are retained if modified and upgraded. |
Manually created Job Deployment | Max Heapsize | 2048 | Values are retained if modified and upgraded. |
secure | timeout | 120 | Values are retained if modified and upgraded. |
Enterprise-AR and Cloud-AR
Apply the following settings to the Enterprise-AR and Cloud-AR configuration files:
Configuration file | Setting | Value | Additional information |
|---|---|---|---|
ar.conf (Linux) | AR Server tag | Recommended value | Configuration parameter and value |
| Delay-Recache-Time | 300 seconds (5 minutes) | Delay-Recache-Time: 300 |
| Max-Entries-Per-Query | 2000 | Max-Entries-Per-Query: 2000 |
| Next-Id-Block-Size | 100 | Next-ID-Block-Size: 100 |
| Server-Side-Table-Chunk-Size | 1000 | Server-Side-Table-Chunk- Size: 1000 |
| Allow-Unequal-Queries | Disallow | Allow-Unequal-Queries: F |
| Cache-Mode | Development mode OFF | Cache-Mode: 0 |
| Debug-mode | No debug mode | Debug-mode: 0 |
| Submitter-Mode | Locked | Submitter-Mode: 1 |
| Minimum-API-Version | Set a value appropriate for your production environment. Defaults to 0 (not recommended). General rule is 2 versions backward-compatible. | For more information, see the AR System 8.1 documentation on ar.cfg and ar.conf settings. |
| Private-RPC-Socket (Fast: 390620) | <Value = 3 x # of CPUs> | Total number of threads should not exceed 8 times the number of CPU cores. |
| CMBD-Cache-Refresh-Interval | 600 seconds (10 minutes) | CMDB-Cache-Refresh- |
Enterprise-AR Plugin Server: <AR System Home Directory>\pluginsvr\pluginsvr_config.xml | numCoreThreads: | Default 5: New 30 |
|
Cloud-AR Plugin Server : <Cloud Portal Home Directory>\plugin\pluginsvr_config.xml | numSelectorThreads | Default 2: New 5 |
|
| workQueueTaskThreshold | Default 5: New 5 |
|
CAI Plugin Registry | Manual steps to be set in the database. |
| For more information, see the AR System 8.1 documentation on CAI-plug-in-configuration, |
Mid Tier
Apply the following settings to the Mid-Tier configuration files:
Tomcat configuration parameters | Parameter | Recommended value |
|---|---|---|
| Keep-alive parameters |
|
| Keep-alive count | Infinite (minimum 5000) |
| Max connection timeout | 90000 ms (minimum 60000 ms) |
| JVM parameters |
|
| JVM heap | =-Xms1024m –Xmx1024m |
| MaxPermSize | -XX:MaxPermSize=256m |
| Tomcat connector parameters |
|
| maxThreads | 500 |
| acceptCount | 100 |
| 64-bit JVM |
|
| JVM hybrid mode and GC | -XX:+UseCompressedOops |
<Tomcat_directory>/conf/ server.xml | Enable Cache Persistence |
|
| Prefetch or preload service |
|
| Recommended pre-load procedure |
|
| arsystem.formhtmljs_expiry_interval |
|
| Definition Change Check Interval |
|
| arsystem.log_level |
|
BMC Atrium Orchestrator
Apply the following settings to the BMC Atrium Orchestrator configuration files:
Configuration file | Operating system | Recommended value | Additional information |
|---|---|---|---|
BMC Atrium Orchestrator Access Manager and Repository.lax/BMC Atrium Orchestrator CDP.lax/server.sh | Windows: | -Xms1024m | Values are not retained. You must manually restore the modified values from the .bak files |
| Linux: | -Xms1024m | Values are not retained. You must manually restore the modified values from the .bak files |
BMC Network Automation
Apply the following settings to the BMC Network Automation configuration files:
File name | Parameter | Recommended value | Additional information |
|---|---|---|---|
BcanInstalledConfiguration.xml | DATABASE_URL | jdbc:oracle:thin:<hostname>:<port>:<SID> | Values are retained if modified. |
database.properties | javax.jdo.option.ConnectionUR | jdbc:oracle:thin:<hostname>:<port>:<SID> | Values are retained if modified/ |
logging.properties | com.bmc.bcan.engine.database.persistence.level | INFO | Values are not retained if modified. You must manually take the back-up before upgrade and restore them later. |
server.xml | maxThreads | 150 | Values are not retained if modified. You must manually take the back-up before upgrade and restore them later. |