How to manually configure 8.3 shortname paths using fsutil
Technical Articles ID:
KB82122
Last Modified: 2023-07-12 11:13:26 Etc/GMT
Environment
ePolicy Orchestrator (ePO) 5.x
Summary
ePO uses 8.3 shortnames when it references its own folder locations. Occasionally, you might need to manually set the shortname, especially when you migrate an ePO installation.
Problem
ePO doesn't function and can display common symptoms such as services failing to start.
The orion.log (ePO_installation_folder\server\logs) reports partially installed extensions:
2014-06-06 11:17:21,548 ERROR [main] plugin.PluginManager - Initialization of plugin core failed. org.springframework.beans.factoryeanCreationException: Error creating bean with name 'core.ext.taskGlobals' defined in resource loaded from byte array: Invocation of init method failed; nested exception is java.lang.IllegalStateException: The following extensions are in a partially installed state: [DataChannel:5.1.0.509, AvertAlerts:5.1.0.509, HOSTIPS_8000:8.0.4.838, GuidedConfig:5.1.0.509, rsd:4.7.1.120, Notifications:5.1.0.509, LYNXSHLD1700:1.9.0.1621, hip_800_help:800.975, epolicensing:5.1.0.509, help:5.1, Issue:5.1, MOVEOSS_2600:2.6.2.129, report:5.1, InstallHelper:5.1.0.509, HostIPSLicense:8.0.4.838, MRTBase:1.0.2.103, SIARevocation:1.0, epo_help:5.1.0.032, scheduler:5.1, msa_help:480.023, TELEMTRY1000:1.2.0.323, PolicyMgmt:5.1.0.509, console:5.1, EPOAMTReports:2.0.0.437, MOVEVOFF2600:2.6.2.129, ldap:5.1, Solidcore:6.1.3.131, DeepDefenderMETA:1.6.0.513, VSPHEREDCEXTN:3.0.1.122, rs:5.1, EPOAMT:2.0.0.437, userdirectory:1.0.0.136, CommonEvents:5.1.0.509, LYNXSHLDPARSER:1.9.0.1621, MDCC:3.0.1.106, EEADMIN:7.1.0.389, VIRUSCANREPORTS:1.2.0.236, SITEADVLICMETA:1.0.0.135, epoMigration:5.1.0.509, Countermeasures:5.1.0.509, EPOCore:5.1.0.509, VIRUSCAN8800:8.8.0.368, SITEADVMETA:3.5.0.306, EEPC:7.1.0.389, response:5.1, AgentMgmt:5.1.0.509, EEDEEP:7.1.0.389, vsel_help:190.1, SIEMCollector:10.02.58241.886, ldapsync:5.1, de_help:710.100, dr:5.1, ui:5.1, EEGO:7.1.0.389, EPOAGENTMETA:4.8.0.348, SoftwareMgmt:5.1.0.509, ComputerMgmt:5.1.0.509, mva_260_help:2.6.0.272, ProductDeployment:5.1.0.509, HostIpsAdv:8.0.4.838, deep_command_help:200.008, hotfix510LL:5.1.0.522, RepositoryMgmt:5.1.0.509, epoLicEnt:5.1.0.509, EPOAMTRCS:2.0.0.437]
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1486)
Cause
ePO configuration files reference 8.3 shortname paths that don't exist on the system. For example, the orion.properties (epoinstalldir\server\conf\orion) file references several 8.3 shortnames:
#Mon Jan 20 08:57:27 PST 2014
orion.upload.size.threshold=9000000
orion.ldap.cache.internal.periodic.task.initial.delay=7200000
orion.upload.max.size=268435456
orion.ldap.max.query.size=2000
extension.install.dir=C\:/PROGRA~2/McAfee/EPOLIC~1/server/extensions/installed
orion.exception.show.detail=false
orion.email.mime.encodefilename=true
core.cluster.group=
extension.tmp.dir=C\:/PROGRA~2/McAfee/EPOLIC~1/server/extensions/tmp
Solution
Use the fsutil command to set the 8.3 shortname to what's expected in the ePO configuration files.
- Determine the 8.3 notation form that ePO looks for. Look at one of the files that reference an 8.3 shortname:
- C:\Program Files (x86)\McAfee\ePolicy Orchestrator\APACHE2\conf\httpd.conf
- C:\Program Files (x86)\McAfee\ePolicy Orchestrator\APACHE2\conf\ssl.conf
- C:\Program Files (x86)\McAfee\ePolicy Orchestrator\Server\bin\setenv.bat
- C:\Program Files (x86)\McAfee\ePolicy Orchestrator\Server\bin\setenv.sh
- C:\Program Files (x86)\McAfee\ePolicy Orchestrator\Server\conf\epo\epo.properties
- C:\Program Files (x86)\McAfee\ePolicy Orchestrator\Server\conf\orion\log-config.xml
- C:\Program Files (x86)\McAfee\ePolicy Orchestrator\Server\conf\orion\orion.properties
- Verify that the disable8dot3 setting is set to 0:
fsutil behavior set disable8dot3 0
fsutil 8dot3name query C:
NOTE: If you make any changes, you must restart your computer for the change to take effect.
- Manually set the 8.3 shortname to match the examples above. Open an administrator command prompt and run the following command.
Modify the command to match the configuration files in the environment:
fsutil file setshortname <path_name> <shortname>
For example:
fsutil file setshortname "C:\Program Files (x86)\McAfee\ePolicy Orchestrator" EPOLIC~1
fsutil file setshortname "C:\Program Files (x86)" PROGRA~2
|