Escolar Documentos
Profissional Documentos
Cultura Documentos
Version: 3V1
2 Login ............................................................................................................................. 6
3 CPM ............................................................................................................................... 7
3.1 Planning ......................................................................................................................... 8
3.1.1 Import ....................................................................................................................... 8
3.1.1.1 Atoll import ............................................................................................................ 8
3.1.1.2 XAKTA Import ........................................................................................................ 9
3.1.1.3 Importing a Use Case List (Action List) .................................................................... 10
3.1.1.4 DataEngine-Import ............................................................................................... 12
3.1.2 The Data Engine and its working copy.......................................................................... 13
3.1.3 DataBrowser ............................................................................................................. 14
3.1.3.1 Basic editing and filtering ....................................................................................... 14
3.1.3.2 Sorting ................................................................................................................ 15
3.1.3.3 Searching for parameters ...................................................................................... 15
3.1.3.4 Hiding columns ..................................................................................................... 16
3.1.3.5 Hierachical Filter (NE-filter) .................................................................................... 16
3.1.3.6 Parameter Filter .................................................................................................... 17
3.1.4 CSV-/Excel Export ..................................................................................................... 17
3.1.5 Rule Editor ............................................................................................................... 18
3.1.6 DataEngine-Export into Workspace .............................................................................. 19
3.1.7 NWP-Editor............................................................................................................... 19
3.1.8 Export2CCM ............................................................................................................. 20
3.2 Optimizing .................................................................................................................... 22
3.2.1 Create SCRs ............................................................................................................. 22
3.2.1.1 Neighbour GUI / Excel-Import ................................................................................ 22
3.2.1.2 Parameter GUI / Excel-Import ................................................................................ 23
3.2.2 Apply WS/RDE .......................................................................................................... 25
3.2.3 SCR Overview ........................................................................................................... 25
3.2.4 Trace Back ............................................................................................................... 26
3.3 Data Verification ............................................................................................................ 26
3.3.1 NET-Import .............................................................................................................. 26
3.3.2 Delta ....................................................................................................................... 27
4 CCM ............................................................................................................................. 28
4.1 Import ......................................................................................................................... 28
4.1.1 Plan import............................................................................................................... 28
4.1.2 Live import ............................................................................................................... 29
4.2 Delta............................................................................................................................ 30
4.2.1 Deltabildung ............................................................................................................. 30
4.2.1.1 Delta Tree and Detail Table .................................................................................... 30
4.2.1.2 Object Delta Tree and Parameter Delta Tree............................................................. 31
4.2.1.3 Planexport and Selective Delta ............................................................................... 31
4.2.1.4 Statistic ............................................................................................................... 33
4.2.1.5 Searching ............................................................................................................ 33
4.2.1.6 Blacklist ............................................................................................................... 34
4.2.2 Export ..................................................................................................................... 35
6 Glossary ....................................................................................................................... 45
First, there are raw data sets for RADIO (RPT), TRANSPORT (FIT) and EQUIPMENT (EQP). These have to
be imported first from the corresponding tools, e.g. ATOLL and X:AKTA. These data sets have to pass
consistency checks and approval by a user before they can be used. From the other side, Wirk data have
to be imported in CCM. The Monitor shows for each site the Integration status, i.e. the delta between
plan data and Wirk data. If the current raw data set is approved, a frozen copy will be created for the
delta, otherwise, when the current raw data set is not approved, the last frozen copy will be used. NET
data are imported from CCM. When refreshing the monitor, global checks over (frozen) raw data sets and
net data are performed. For sites which pass all checks and a supported delta-usecase is detected, export
files can be created.
2 Login
After we start the CPCM client, the login screen appears, where you have to enter your user name and
password. These information should be given to you by your administrator. You can also choose to which
servers (CPM/CCM/IWZ) you want to connect, and enter their corresponding URLs. Note that you need
to connect to at least one server in order to start the client. If you log in the first time with the initial
password given to you, you will be prompted to change the password and choose your own one.
After login in, the main window of CPCM appears. What exactly you see, depends both on your rights, given
to you by your admistrator, and also which view you had opened last time.
3 CPM
The planning component of CPCM is called CPM (Common Planning Managment). It allows you to import
the data from radio and fixed network planning tools, and then transform them into the vendor specific
formats for e.g. NOKIA, HUAWEI or SIEMENS equipments, depending on nettypes 2G,3G,4G, the software
version of the equipment (e.g. RG20, RAN18, LTE16,...) and also different planning releases, which are of
the form (R/E)(YEAR)_(NUMBER), like R2016_7 and E2016_6 where R are the releases for O2 and E are
the releases for EPLUS. The data can then be manipulated and checked for consistency in many different
ways, before they are ready to be exported to the configuration component CCM (Common Configuaration
Management) of CPCM, and from there to the network.
The data sets in CPM are stored in CPM-Regions which are independent from each other, and correspond
to a database scheme. There is one CPM-Region per planning region and vendor.
3.1.1 Import
Basis for CPM are the radio planning data (RPT data) and the fixed network data (FPT data). The Use
Case List (Action List) defines which sites have to be imported into the DataEngine. So the first steps are
the imports of the RPT data (see 3.1.1.1), the import of the FPT data (see 3.1.1.2XAKTA Import), the
import of an Action List (see 3.1.1.3) and the DataEngien import (see 3.1.1.4). Before the first
DataEngine import, RPT data, FPT data and an Action List must exist.
the lower part of your client window (but can – like all tabs of CPCM – be dragged around freely, even
outside your CPCM-client window), you should latestly by now see in its sub-tab Data an entry belonging
to the imported Atoll data.
Instead of clicking on the blue arrow, the import can also be started
by right clicking in this Data tab and selecting “RPT Import Alles ...”.
In both cases, a complete Atoll import is started. The context menu
offers three more options for partial Atoll imports, namely only the
frequency plan, neighbour-relations or external neighbour-relations.
You can watch and edit the imported ATOLL Data by double clicking the desired entry of the “Data” sub-
tab of the “RPT Data” tab. Then the “Data browser” sub-tab will open, where on the left side you can see
the ATOLL-Tables (Objects), and by clicking on a table, you will see its contents on the right side of the
tab, i.e. the parameters (columns) and their values. This parameter values can be edited, and also filtered.
This right side of the tab is CPCM’s Data Viewer, which not only appears for the Atoll Data, but almost
everywhere in the Client where Tables are involved. Also a “Data Browser” tab with the same structure,
i.e. table names in the left part and contents of a selected table in the right part, appears multiple times in
CPCM. It is therefore explained in more detail later in section 3.1.3
The first column is the name of the use case to be performed. These come from a fixed set of use cases,
that were defined in ZeroTOC Project. Then
“Controller Basekey” and “Site Basekey” define
which Sites/Contoller shall be affected by the use
case. Finally, the ActionGroupID is an arbitrary
name, which defines the list of actions to be
performed when this Action List is used. For
example, for one ActionGroupId, you could have
both the use cases 2G_Dismantling for one site,
and 2G_NewSite for another site. A very special
and important use case is the 2/3/4G_InitialPAC.
This use cases both sets up the necessary inital
database structure of the plan model, and also re-
sets the values of all parameters depending
directly from atoll – but only for sites that are
already imported in the data engine. Therefore,
this use case does not have a Controller/Site
Basekey. Also this use case cannot be combined
with any others within the same ActionGroupId.
Another special use case is the 2/3/4G_PrePAC. It is a combination of the InitialPAC and several other use
cases (including _NewSite), so it both sets up the database structure, and also imports data for the given
site list.
In order to import an Action List, select the sub tab “Action List” of the “Data Engine” Tab of your region,
right click in the table, and choose “Maßnahmen importieren” from the context menu.
2G_Dismantling
3G_Dismantling
4G_Dismantling
2G_DeleteSite
3G_DeleteSite
4G_DeleteSite
2G_NewSite
3G_NewSite
4G_NewSite
2G_MorneRadioTx
3G_MorneRadioTx
4G_MorneRadioTx
2G_FreqChange
3G_PSCChange
4G_PCIChange
2G_Reparent
3G_Reparent
4G_Reparent
2G_ParamChange
3G_ParamChange
4G_ParamChange
2G_NeighbourChange
3G_NeighbourChange
4G_NeighbourChange
2G_ParamChangeTx
3G_ParamChangeTx
4G_ParamChangeTx
2G_BSCChangeTx
3G_RNCChangeTx
4G_SECGEChangeTx
4G_MMEChangeTx
4G_UGWChangeTx
2G_InitialPAC
3G_InitialPAC
4G_InitialPAC
2G_REPChange
2G_REPDelete
3G_REPChange
Projekt/Titel: CPCM Filename: CPCM High Level User
Guide.docx
Bezeichnung: CPCM High Level User Guide Version: 3V1
3.1.1.4 DataEngine-Import
Now we import the Atoll Data into the Data Engine. A DataEngine import
has the prerequisite that a consistent data record in RPT Actual and FIT
Actual must exist for the desired nettype and planning region. To start the
import, click on the blue arrow between the RPT Actual and Data Engine pot
with the desired nettype. Then a dialog window will open, where you can
select the planning region, the equipment, software version, release and
one of the action lists you have imported before. As we haven’t imported any data before, the only action
list allowed is the one belonging to an InitialPac or to a PrePac, as these uses cases are the only ones
that set up the necessary database structure. Also note that the InitialPac use cases only updates
parameters of already existing sites, but does not import any new sites itself, so after this
import, all tables will still be empty. In order to really import data of sites, an Action List containing a
use case like NewSite must be used afterwards. Conversely, the PrePac use case both sets up the database
structure and imports data.
Note that in a region, for each equipment and software version, there are usually two instances of data
sets present: The “actual” Data-Engine data (which we will now call DTE-data), and a working copy
of it (which we will call DWC-data). For the further steps for exporting data through to CCM and into the
network, only the DTE-Data can be used. Therefore, the DTE-Data are considered to be more worthful and
need to be protected from failed imports. It is always possible to create a 1-1 copy of the DTE-data into
the DWC-data (even when DTE-data are inconsistent). Reversely, only a consistent set of DWC-data can
be copied into the DTE-data. So for saftey reasons, a DataEngine import is only possible into DWC-data,
so even after a failed import, the DTE-data will be unaffected. This explains the two buttons for importing
into the Data Engine:
Neue Arbeitskopie für Import erstellen (recommended): This should be the button which is usually
used. It first copies the DTE-data to the DWC-data (old DWC-data will be deleted!), and then
imports into the DWC-data.
Bereits existierende Arbeitskopie für import verwenden: If you press this button, the data will
directly be imported into the DWC-data. This makes sense if you haven’t changed your DTE-data
in between, but have already done several changes on your working copy.
In the case there are not any DTE-data yet (for example if a new software version is introduced), both
buttons will do the same and directly import into the DWC-data. Similarly as after an ATOLL import, the
“Data” sub tab of the “Data Engine” tab will show a new entry with tableprefix DWC which represents your
imported DWC-data.
“UNCHECKED”, and the colour of the Data Engine pot (which, as mentioned before, always
shows the DTE-data consistency, and never the DWC-data consistency) has changed to yellow.
In order to export the DTE-data further into the workspace, they have to be consistency-
checked in the same way as the DWC-data, also see section 3.1.6. Note that in the situation
we just described, where there exist DWC-data but no DTE-data yet, you can always merge
your DWC-data into the DTE-data. However, there is a mechanism to prevent from doing so when the DTE-
data have newer modifications (that would be lost after the merge) – see the next section for the details.
3.1.3 DataBrowser
The Data Browser is the component of CPCM to watch and manually edit data. It appears as a sub tab of
the Data tab for many types of Data, like ATOLL data, XAKTA data, Data Engine data, Workspace data and
so on. We explain the Data Browser for the example of the Data Enginge data. Note that though most of
the Data Browsers are very similiar, they might differ slightly in available features, e.g. depending if data
can be edited or not. Usually the Data Browser is opened by double clicking on an entry in the Data tab.
With the buttons you can build more complex filters using
own SQL statements. This so called ‘Parameter filter’ is explained in section
3.1.3.6.
filtering
Sometimes you want to change the value of a parameter for all rows
3.1.3.2 Sorting
the others. For this, you can click on , and choose the
parameters you want to see. Then in the Data View, all other
parameters will be hidden. Note that
for technical reasons, the number of
visible columns is restricted to 200,
so when an object has more
parameters, some of them will
only two parameters visible here
always be hidden.
either tick the “P”-column checkbox, or click the button in the toolbar of the
Data Viewer. Then the editor window of the parameter filter will open, where you can type in any valid
SQL-where-clause. Two combo-boxes, where you can create simple conditions for the parameters and
buttons for AND and OR support you.
order. So it is a “what you see is what you get” export. To open the export dialog, click on in the
current data broser view you want to export.
Most of the Data tabs have a Rule Editor sub tab (Screenshot below). The Rule Editor allows you to see
details of the checks that are performed during a consistency check, and add/edit own checks you want to
be executed. Note that for each kind of data sets (ATOLL data, data engine data, workspace data,...) own
lists of checks can be defined, and also for each software version, own lists apply. The user can only edit
those checks that start with “user_......”. However, note that the user defined
checks will then apply for every user of CPCM, not just you, so there is just one user_.... file for all
CPCM users per region! Therefore, if you want to create an own rule to be checked, for example for the
data engine and software release RG30, most likely you are not the first user, and an entry of the form
“RG30/user_consistency_(regionname)_dte” already exists. Then you can select it in order to add your rule
to it. Otherwise, you can create the user file by clicking on the first „+“ symbol. Now select this file, and
click on the second “+” symbol to create a new rule in it. In the right part of the window, you can enter
the name of the test case, the SQL to be executed, if the check shall be blocking or just warning, and if the
check is active or not. Note that the context menu appearing when clicking on the rules in the left window
offers options like copying or deleting rules.
We now describe the syntax for the SQL command in the right window. The idea is to write an SQL select
statemtent, that only will have an output if the check fails, and the output gives details for the reason of
the failure. Therefore, the select statement should produce three columns,
OBJECT, DISTNAME, DESCRIPTION.
For example, we choose
for our rule. IMPORTANT: The statement MUST NOT be ended with semicolon ‘;’!.
Also do not forget to click on the disk symbol for save. If we now right click on a Data Engine entry and
start the consistency check, this sql command will be performed, and always produce a line, hence the
check fails. In order to watch the results of all consistency checks, right click on your Data Engine entry
and choose “Log ansehen”. Then the error log will open,
Right clicking on a workspace data set, the context menu offers options to delete or duplicate the selected
data set.
3.1.7 NWP-Editor
The “Network Wide Parameters” (NWPs) are parameters whose values are taken from a list called NWP
templates, and these NWP templates (usually) exist on the level of BSC/RNC, SITE and CELL. There is
always a ‘default’ template, but the user can create own templates.
To edit NWP-Templates, open the sub tab “NWP Template” of the workspace tab.
You will see a hierarchical view, with levels the CPM regions, equipments,
software versions, releases, layers, template set names, objects and instances.
By right clicking on a template set name, the context menu offers options to
delete or duplicate the contents of this template set. Similarly for NWP objects,
you can copy or delete instances from the context menu.
3.1.8 Export2CCM
As only a consistent plan data set can be exported to CCM, right click on
it and choose Konsistenzcheck. Then the arrow between Workspace
Lokal/Global should be clickable. In the dialog window, you can then start
the export.
Note that for the export, also the FPT data are used. The export to CCM will transfrom the data from
the plan format in the local workspace to the NBI (or wirk) format in the global workspace.
For further use of the data of workspace global in CCM (in particular for the Plan Import into CCM, see
4.1.1), the workspace global data set has to be activated. To do so, it has to be consistent, so first right
click on it and start the consistency check (“Konsistenzcheck”). After a successful check, activate the
workspace global data by right clicking on its entry in the Data-
subtab of the workspace-tab, and click on “Plan aktivieren
(global)”. Then the entry becomes green, and the ACTIVE
column of the entry has value “YES”.
In the tab ScrNeighbour you have to select at first a Region Source and a Source Tech for which you want
to add or delete a neighbour cell. In window (1) all cells are displayed which exists in the Local workspace
as active data set. Now you have to select a specific cell in window (1) and the Target Tech for the neighbor
relations you are interested. Now you can see in window (2) some informations of existing neighbor cells
of the selected cell in window (1). Additional you can see in window (3) all planned and executed operations
for the selected cell.
To add a new neighbor cell you can type its cellname in the Suche Target field. You can also type a blank
or the first few characters of the neighbor cell to get a list of possible cellnames. With the einfügen button
You first have to select the Region, the Equipment and one of the tabs Features and Flags, Cell Parameter,
NBR Parameter or TRX Parameter to see all cells or neighbor relations of the active data set in the local
workspace in the window verfügbare Zellen. You can use the combobox Prefix or the text field Filter to filter
the cells in the list of verfügbare Zellen. With the green arrow buttons you move selected cells from
verfügbare Zellen to Gewählte Zellen and vice versa to use the cells in Gewählte Zellen for modification.
Depending on the choosen type of parameter you have a slightly different appearance of the list of cells
and combo boxes.
Features and Flags
On the left side you can see a cellname and the corresponding target cellname for a neighbor
relationship.
On the right side you have a combo box Type for the Object you decide to modify.
In the combo box Parameter you can choose the parameter which should be modified.
Wert is a text field where you can enter the new value.
The aktueller Wert displays the actual value before the modification is applied.
If available, the Range shows the specified range for the parameter.
TRX Parameter (only 2G)
On the left side you can see a cellname and the corresponding trx number.
In the combo box Parameter you can choose the parameter which should be modified.
Wert is a text field where you can enter the new value.
Projekt/Titel: CPCM Filename: CPCM High Level User
Guide.docx
Bezeichnung: CPCM High Level User Guide Version: 3V1
If the action fails you have to open the Show_SCRs tab and press the refresh button. In the column
TOC_ARCHIV_STATUS or DATAENGINE_STATUS you can read the error message.
To check whether the SCR was successfully applied or not you have to look at the OK_xxx and xxx_STATUS
column. In the OK_xxx column and xxx_STATUS you can see whether the SCR of the corresponding data
set is successfully applied or not and in the xxx_DATE you can see when is was applied.
3.3.1 NET-Import
To import NET data from CCM to CPM either click on the corresponding arrow between the CCM computer
icon and the NetData pot, or right click in the Data sub tab of the Net Data tab and choose “Import”. In
the dialog window, you can then select the appropriate data, and start the import. The Net Data are in
the same (NBI-) format as data in workspace global.
Note that before you can import from CCM to CPM, you must have startet a live import in CCM,
see the next chapter.
will open, where you can select two data sets you want to compare. Note that the dialog only allows to
select combinations that are comparable, so for example a change of the workspace from local
to global for the “Check data set” will automatically adapt the selection of the “Vergleich data
set”. After you have started the computation, you can watch the result of the comparison by double clicking
on the corresponding entry in the “Delta Table” sub tab of the “Delta Data” tab.
The results of the comparison are then displayed in the “Delta Browser” tab in a tree view.
Each object where a delta is found appears as a node. As possible sub nodes, it has MODIFY, CREATE and
DELETE, depending on if a parameter was modified or a whole row has been added or deleted respectively.
The Common Configuration Manager (CCM) is used to configure the live system with changes made in the
planning data. To do so you first need to import your planning data (Plan import) and the current live data
(Live import). After the imports are finished you can calculate the so called Delta of the two data sets,
which is a record about the differences in the data. By exporting a Delta, the changes contained in it are
converted to an XML file which can then be imported into the live system.
To open the CCM perspective you need to select one of the tools from the
CCM drop down list. These tools are organized according to their technology
2G, 3G or 4G. The different vendors can be identified by the prefix of the
tool name “HCM” for Huawei, “NCM” for Nokia and “SCM” for Siemens.
4.1 Import
In the Statusinformation section you can see the status of the last successful plan import for each NMS
relevant for the selected tool. Additionally there is an overview of the number of network elements in the
data to check if new elements were introduced or deleted.
After successfully finishing a Planimport the new set of data is available to all tools with the same technology
and all users.
When running a Wirkimport information about the ongoing process can be seen in the “Import Log” at the
bottom of the window. After it is finished the imported data is available for all tools and users.
4.2.1 Deltabildung
With a CCM perspective open, the processing of a delta can be started by pressing the Delta button.
In the Statusinformation section you can see the status of the last successful delta for each NMS and
software version relevant for the selected tool.
After the Delta button has been pressed the delta is running. The progress of the delta processing is shown
in the view Delta Log.
The green line indicates that the delta processing has been successful.
The bold words indicate that the corresponding objects have a delta. If you click on such an object the
details are shown in the detail table (Detailtabelle), the view shown on the right side. Here you can compare
old value and new Valus of the parameters which belong to the delta object.
The parameter delta tree (Parameter Deltabaum) shows update delta only. The tree hierarchy is different
to the Object Delta Tree. The second level of the tree contain the parameter for which a delta exists. So
you easily can find all objects for which a certain parameter must be modified. Also note that parameters
which are displayed in orange color are service affecting.
After pressing this button a dialog opens in which you can define for which controller or sites the delta
should be performed.
4.2.1.5 Searching
To narrow the delta tree for entries which contain a given text, choose Search (Suche).
4.2.1.6 Blacklist
To prevent some objects to be part of an export press the butto Blacklist. In the opening dialog you can
define controller and site the objects.
4.2.2 Export
The export generates one or more files which can be used as input for the network management system.
The result is shown in a new window which has the name Dateiexport.
5 Integration Wizard
The Integration Wizard (IWZ) is the fast track to integrate new Sites, Cells and Trxs into the network. In
contrast to CPM, it only has one raw data pot for each type of Radio, Transport and Equipment data and
Technology, and one data pot for Net Data, but no other “intermediate”-data pots between raw data and
live data. The delta between raw data and net data is monitored in the IWZ-Monitor, which can also be
considered as the control room of the Integration Wizard. For each site it shows whether there is no
difference between raw data and network data, or in the other case which kind of operation (create
site/cell(s)/trx(s)) is needed to bring the live data in accordance with the planning data. When the
planning data has passed the consistency checks, the necessary export file to perform this operation can
be created from the IWZ-Monitor. When the IWZ-Monitor is refreshed, it checks if prepared operations
from the previous state have been successfully integrated into the network (i.e., there is no longer a
delta between planning data and net data). These sites and operations are then archived in a history
view, together with the relevant export files.
First note thate there are tabs for each IWZ-Region (where there is one IWZ-Region per planning region
and vendor), where above we have the two regions TESTBED_HUAWEI and TESTBED_NOKIA. Make sure
you have the right region selected before you proceed. Then there are three main windows:
1. This window contains the icons for the pots of the three raw data pots RPT (radio data), FIT
(transport data), EQP (equipment data) and the pots for live data NET, for each technology
2G,3G,4G. The pots can have the colours grey (no data/operation active), yellow (unchecked
data), red (inconsistent/error data) or green (consistent data).
2. This window has tabs for each of the four pots from before, each coming with two tabs “Data”
(overview of the data sets in this pot) and “Data Browser” to view the objects of a data set.
Another tab is the Rule Editor, to manage existing consistency checks and create user-defined
consistency checks.
3. This window is the heart of the Integration Wizard, containing the four tabs related to the IWZ-
Monitor. These are the Monitor tab itself, containing information for each site, the monitor status
tab for an overview of the monitor data for each region and technology, the History tab which
contains the former monitor entries of successfully integrated operations, and a Konsistenz Log
tab, showing the results of consistency checks.
5.1 Import
The first step is to import the relevant planning raw data, i.e. RPT, FIT and EQP data.
5.1.1 Atoll
To import radio plan data, right click somwhere in the RPT tab, in its data sub
tab and select “RPT Import ...”. Then a new window will open, where you can
Projekt/Titel: CPCM Filename: CPCM High Level User
Guide.docx
Bezeichnung: CPCM High Level User Guide Version: 3V1
5.1.2 X:Akta
To import fixed network data from X:Akta, select the FIT
tab, right click into its Data sub-tab and select “Festnetz
interims Daten import ...” from the context menu. Then
similar as for RPT data, a dialog opens where you can
select region and nettype, and either import all data or a
subset of sites determined by a CSV list. Also consistency
check and approval work in exactly the same way as for
RPT data.
For each technology, there are four types of consistency checks, where three come from one for each of
the raw data pots RPT,FIT,EQP (which can be started individually), and one is a global one performed
during monitor refresh, see 5.4.1. In the rule editor, you can both view the preinstalled consistency
checks for each type, and add user defined ones. Note that only one user defined check per type and
region can exist, which will always be performed after the preinstalled checks, independently which user
starts the check/monitor refresh. So here user defined means (various) users can edit these checks, but
then they will apply to any user of this region!
Each check (whether user defined or preinstalled) consists of a set of SQL statements, which are meant
to produce a row for each failure of a check, and produce no row when the check passes.
Also each check can have one of the severities “Warnung” or “Blockieren”, which affect how/if the data
set can be used for further actions (or has to be be fixed before), and it can be active (check will be
performed) or not active (check will not be performed). In the left window of the Rule Editor, these flags
are displayed through a orange/red flag for the severity and a checkmark/cross for the activity status.
To create a new user defined check, click on the first green plus in the top right of the
left window. In the following dialog window, you can choose region, technology and the type
(RPT,FIT,EQP,GLOBAL) of the user defined consistency checks. Now to define a SQL statement to perform
inside this test, select it and click on the second plus. In the right hand side of the window, you can
define a SQL statement, where the first column should yield the SITE_BASEKEY of the failing site, and
the second column a description. Now when executed during a consistency check, these columns will
appear in the consistency log, which can be opened by right clicking on the data set entry and selecting
“Log ansehen” for raw data checks, or in the Konsistenz Log tab of the Monitor.
Projekt/Titel: CPCM Filename: CPCM High Level User
Guide.docx
Bezeichnung: CPCM High Level User Guide Version: 3V1
Note that if a check with severity BLOCKING fails, it means that this raw data pot can not be approved
(and hence not used for a monitor refresh, see 5.4.1). If a check fails with WARNING, it does not block
the approval of the pot, but this check will then also appear in the “Konsistenz Log” tab of the Monitor,
and in particular, once a site has at least one entry here, it will have status INVALID in the monitor, so no
usecases can be performed on it (see 5.4.1)
Note that when writing own raw data checks, make sure the sql statements go to the T-DATA
sets (and NOT to the D-Data sets), as these are the sets relevant for the check! (I.e., for the
table prefix for radio use RPT and not RPD. And for transport, use FIT and not FPD. See 5.4.1)
Note that when writing own GLOBAL checks, make sure the sql statements go to the D-DATA
sets (and NOT to the T-Data sets), as these are the sets relevant for the monitor refresh! (I.e.,
for the table prefix for radio use RPD and not RPT. And for transport, use FPD and not FIT. See 5.4.1)
Note that for GLOBAL checks, the severity should always be WARNING.
Note that in the pots FIT, RPT, EQP there are two kinds of data sets (per Region-Technology)
1) The raw data set coming from the last raw data import. We call these T-DATA.
2) The copy of an approved T-Data set created during the monitor refresh, which we will call D-
DATA.
Note that for the condition of b) above to be met it is enough for the pot that a (successfully copied) D-
DATA set exists. If there are currently no approved T-DATA, but a D-DATA set (from a previous refresh)
exists, this D-DATA set will be used for the monitor refresh. Therefore if you want to use newly
imported/edited T-data set for a refresh, you must make sure it is approved, otherwise a
maybe outdated D-DATA set will be used in the refresh!
Now during a monitor refresh, for each pot where there exists an approved T-Data set which has a newer
aprroval date than the D-Data set (or there is no D-Data set yet), the pot\type T-Data set D-Data set
old D-Data set will be replaced by the current T-Data set. When the prefix prefix
two approval dates are equal (or the T-Data set is not RPT-Data RPT RPD
approved), the existing D-Data set is preserved instead. FIT-Data FIT FPD
EQP-Data EQP EPD
In the Data-tabs, T-Data and D-Data sets can be distinguished by
their tableprefixes, see the following table. Note that the D-Data sets represent a “frozen state”, so they
cannot be edited by the user.
After the RPT/FIT/EQP D-data pots where (if necessary) actualized, NET Data will be imported from CCM.
Recall there are up to two CCM-Data sets per NMS, where at most one is active. For the import, either
the active CCM-Data set is used, or when there is no active set (e.g. because currently a CCM-Import is
running), the last active set is used. If there is neither an active nor a last active CCM-data set, the
monitor refresh will fail.
It all also contains information of the involved RPT,FIT,EQP pots, e.g. their approval date and comment,
and the current status of the monitor for this region/technology overall.
In the “Konsistenz Log”-tab you get information on the results of the consistency checks.
Note that these consistency check results come from four sources, determined by the column
SOURCEPOT with values RADIO,TRANSMISSION,EQUIPMENT,GLOBAL.
- The entries for RADIO,TRANSMISSION,EQUIPMENT are the results of the consistency checks
on the corresponding pots. These consistency check are not performed during monitor
refresh, just its results are copied from the consistency logs of the pots into the monitor
consistency log.
- The entries for GLOBAL come from the global consistency checks, as defined in the xml files
“consistency_intwiz_[EQUIPMENT].xml” and
“user_consistency_intwiz_[REGION][TECHNOLOGY].xml” (for the user defined checks). These
are actually performed during the monitor refresh.
It contains for each site (per region/technology) the detected pre-delta between plan and wirk data. Of
relevancy here are the columns USECASE, USECASE_INFO, CONSISTENT and INTEGRATION_STATUS:
- The CONSISTENT column has values OK or INVALID. When any of the consistency checks
failed for the relevant site (i.e. there will be an entry in the “Konsistenz Log” tab with the
given SITE_BASEKEY), the site is INVALID and the INTEGRATION_STATUS will be
NO_OPERATION
- When the site passed all consistency checks, its CONSISTENT entry is OK, and the
INTEGRATION_STATUS is either NO_OPERATION (when there is no delta between plan and
wirk) or OPEN, when a delta between plan and wirk is detected.
- In this case, the USECASE and USECASE_INFO columns contain the information on the kind
of detected delta, where USECASE can take the values CREATE_SITE, CREATE_CELL,
CREATE_TRX. Then USECASE_INFO lists the affected elements, e.g. in case of CREATE_CELL
a list of the cellnames to be created.
Note that when creating an export-file for a site (see the next section), the INTEGRATION_STATUS
changes from OPEN to PREPARED. Now when the monitor is refreshed again, there will be a special
handling for sites which are prepared see 5.4.6
If a file to download already exists on your file system, you will be asked how to handle this file
(keep/overwrite), and possibly all
other files, so if you want to
download a larger bunch of files,
in order not to get stuck in the mid
with a dialog, it is best to make
sure the target directory is empty.
The downloaded file(s) remain also on the database, so it/they can be downloaded at any time again.
5.4.4 Planexport
A plan export file can be created for any sites in the monitor which are consistent. It will generate export
files for the select sites as the export in 5.4.2 where for each selected site, the usecase CREATE_SITE is
assumed (even if no usecase or any other usecase is detected in fact). Contrary to the export in 5.4.2,
- the files will be directly stored on your filesystem in the selected path, not in the database
- the INTEGRATION_STATUS of the selected sites does not change
For the computation of ID’s when necessary, see 5.4.5.
5.4.6 History
Once a USE_CASE has been successfully implemented in the wirk network, the corresponding site will
have NO_OPERATION in the next monitor refresh. However, a history of formerly detected deltas can be
found in the “History”-tab.
More precisely, the History tab is filled from entries of the Monitor-Tab that before the refresh have
PREPARED as INTEGRATION_STATUS, and after the refresh either
-the detected USE_CASE differs (e.g. from CREATE_TRX to CREATE_CELL),
-the site becomes invalid,
-or there is no longer a delta detected (NO_OPERATION).
In each of these cases, the PREPARED entry in the monitor tab will be replaced by the new computed
entry, and will have OPEN (export file has to be computed again!)/NO_OPERATION as
INTEGRATION_STATUS, while the old entry with its export file can be found then in the History tab.
Also note in all other cases, a prepared entry together with its export file is kept in the monitor. So in
particular if the detected use case and consistency of a prepared site do not change during another
monitor refresh, the export file is preserved.
6 Glossary
ATOLL
Radio planning tool of O2/Epuls
ATOLL DATA
Often refers to the data set in CPCM, coming from Atoll
CCM
Common Configuration Management. Configuration part of CPCM.
CPCM
Common Plann & Configuration Management. The tool where this documentation is about.
CPM
D-DATA
Frozen states of raw data sets in the Integration Wizard. Relevant for the monitor refresh.
DATABROWSER
Component of CPCM to comfortably browse large tables, with powerful filter, sort and editing functions.
DELTA
There are two kinds of delta computation, one in CPM, one in CCM. The CPM-delta allows to compare two
CPM data sets which are in the same formar (both plan or both wirk format). The CCM-delta compares
the planning data coming from plan import, and the live net data coming from wirk import. This delta can
then be exported to the Network Managment System.
DTE
Data Engine. Pot in CPM, where data are in plan format. Data are separated from critical actions via its
working copy.
DWC
Data Engine Working Copy. Pot in CPM, where Data are in plan format. Can always be created from Data
Engine as 1-1 copy. Only when consistent, the working copy can become the new data engine.
EQUIPMENT DATA
Data pot in the Integration Wizard
FPT
Fixed Network Planning Tool (XAKTA)
FIT
Fixed Network Interims Tables
FWC
Fixed Network Interims Tables Working Copy
History
Place where formerly prepared monitor entries are stored that were either successfully integrated or are
no longer relevant.
IWZ
The Integration Wizard Component of CPCM.
Monitor
Central component of the Integration Wizard, which shows delta between plan and wirk and the
integration status of sites.
NET IMPORT
Imports the data from CCM’s wirk data tables (in wirk format) into CPM’s NET data tables (in wirk
format). These datasets then can be used to compute deltas between workspace global data (also in wirk
format).
NWP
Network Wide Parameters. For these parameters, sets of constant values (Templates) can be defined,
which can then be used in different situations.
PLAN
Plan always refers to data in the simplified model, i.e. a reduced set of objects and parameters.
Sometimes, a data set in plan format is also referred to as a plan. In CPCM, data in Data Engine (Working
Copy) and Workspace (Local) are in plan format.
PLAN IMPORT
RDE
Radio Data Engine. See Data Engine.
RULEEDITOR
Sub-tab of the tabs of many data-sets. Allows to create user defined consistency checks via SQL.
SCR
Software Change Request. Also a module in CPM which allows to modify parameters and adjacencies
between cells.
T-DATA
Raw data sets in the Integration Wizard
USECASE
Usecases in CPM define how an import from ATOLL data into Data Engine Working Copy data is
performed in detail, and which information of ATOLL data is used for it.
WIRK
Refers to data which are in the actual NBI-Format of the vendor. The data of workspace global, and the
data in CCM are in wirk format.
WIRK IMPORT
Import the data from the live-network in CCM’s wirk data tables.
WORKSPACE
Pot in CPM for Workspace data, which are still in plan format
WORKSPACE GLOBAL
Pot in CPM for data in wirk format. An activated data set can be exportet through to CCM via Plan-Import.
WORKSPACE LOCAL
Pot in CPM which is the subset of activated data sets in workspace, in plan format.
XAKTA
Fixed network planning tool of O2/EPLUS.
XAKTA DATA
Often refers to the data set in CPCM coming from XAKTA.
MicroNova AG
Unterfeldring 17
85256 Vierkirchen
Telefon: 08139/9300-0
Telefax: 08139/9300-80
Ansprechpartner: (evtl.)
Vertrieb:
Technik etc.
Anlagen/Beiblätter etc.
© 2017 MicroNova AG
* Weitergabe sowie Vervielfältigung dieses Dokuments, Verwertung und Mitteilung seines Inhalts sind
verboten, soweit nicht ausdrücklich gestattet. Zuwiderhandlungen verpflichten zu Schadenersatz. Alle
Rechte für den Fall der Patent-, Gebrauchsmuster- oder Geschmacksmustereintragung vorbehalten.
Projekt/Titel: CPCM Filename: CPCM High Level User
Guide.docx
Bezeichnung: CPCM High Level User Guide Version: 3V1