Location is just special representation of a group. Every object which belongs to some geographical place should have a location.
Location is identified by unique tag location= . For example, location=default.
Locations can be nested. In this case, location has location tag of its parent.
There is predefined location default which is used for all imported objects. If you want to add objects to other location, use --locationid parameter.
Every location must belong to organization.
When collecting data from sources which understands locations, locations are added into epoch. So you can review them. But objects cannot belong to locations from epochs because it is too volatile. CoreLocations are used to specify static locations for all epochs.
Before adding object to any location, corelocation with specific if must exists. Do not forget that every location needs organization tag.
fcpc config set corelocation/newone name="New location" tag="organization=default"
fcpc config to-core itoplocation
fcpc config search corelocation
There are numerous sources for locations. It can be Skybox, Qualys, iTop or others.
From that reason, we need flexible way, how to assign locations from these sources to their core representation. There is an option --locations.map for this. By default, it is set to "*,default*". This means that all locations will be mapped to default location.
You can use this parameter to tune location matching. To match all itoplocations to default, but only itoplocation/my to my:
--locations.map=itoplocation/my,my
--locations.map=itoplocation/*,default