summaryrefslogtreecommitdiffstats
path: root/aai-resources/src/main/scripts/forceDeleteTool.sh
blob: cb87b38c3654f5cdb6f5ab8fb65905e987cbbfdd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
#!/bin/ksh
#
# ============LICENSE_START=======================================================
# org.onap.aai
# ================================================================================
# Copyright © 2017 AT&T Intellectual Property. All rights reserved.
# ================================================================================
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# ============LICENSE_END=========================================================
#
# ECOMP is a trademark and service mark of AT&T Intellectual Property.
#

#
# forceDeleteTool.sh  -- This tool is used to delete nodes that cannot be deleted using
#        the normal REST API because of internal DB problems.  For example, Phantom nodes
#        and duplicate nodes cause errors to happen in "normal" REST API codes and must
#        be deleted using this tool.  
#        Since it is not using the "normal" REST logic, it is also not invoking the "normal" 
#        edge rules that we use to cascade deletes to "child" nodes.  So - this tool can be dangerous.  
#        Ie. if you accidently delete a parent node (like a cloud-region) that has many dependent 
#        child nodes, there will be no way to get to any of those child-nodes after the cloud-region
#        has been deleted.  
#        There are several environment variables defined in aaiconfig.properties to help minimize errors like that.
#                aai.forceDel.protected.nt.list=cloud-region
#                aai.forceDel.protected.edge.count=10
#                aai.forceDel.protected.descendant.count=10
#
# Parameters:
#
#  -action (required) valid values: COLLECT_DATA or DELETE_NODE or DELETE_EDGE
#  -userId (required) must be followed by a userid
#  -params4Collect (followed by a string to tell what properties/values to use 
#  		as part of a COLLECT_DATA request.  Must be in the format
#  		of ?propertName|propValue? use commas to separate if there
#  		are more than one name/value being passed.
#  -vertexId - required for a DELETE_NODE request
#  -edgeId - required for a DELETE_EDGE request
#  -overRideProtection --- WARNING ? This over-rides the protections we introduced!
#       It will let you override a protected vertex or vertex that has more
#       than the allowed number of edges or descendants.
#  -DISPLAY_ALL_VIDS (optional) - in the rare case when you want to see the 
#       vertex-ids (vids) of all the CONNECTED vertices, you can use this.  By 
#       default, we do not show them.
#  
#  
#  For example:
#  
#  forceDeleteTool.sh -action COLLECT_DATA -userId am8383 -params4Collect "tenant-id|junk tenant01 ID 0224"
#  
#  forceDeleteTool.sh -action COLLECT_DATA -userId am8383 -params4Collect "cloud-owner|junkTesterCloudOwner 0224,cloud-region-id|junkTesterCloud REgion ID 0224"
#
#  forceDeleteTool.sh -action DELETE_NODE -userId am8383 -vertexId 1234567
#
#  forceDeleteTool.sh -action DELETE_EDGE -userId am8383 -edgeId 9876543
#
# 

COMMON_ENV_PATH=$( cd "$(dirname "$0")" ; pwd -P )
. ${COMMON_ENV_PATH}/common_functions.sh

start_date;

echo " NOTE - if you are deleting data, please run the dataSnapshot.sh script first or "
echo "     at least make a note the details of the node that you are deleting. "

check_user;
source_profile;

execute_spring_jar org.onap.aai.dbgen.ForceDeleteTool ${PROJECT_HOME}/resources/etc/appprops/forceDelete-logback.xml "$@"

end_date;

exit 0