Purge add-ins from the GN4 database

Build 1501 on 14/Nov/2017  This topic last edited on: 13/Sep/2015, at 14:30

Should you make a mistake to load in the GN4 database 64-bit add-ins for 32-bit applications and vice versa, any GN4 applications may crash on startup. This includes EdAdmin4 that is normally used to manage add-ins.

In that case, follow those steps to identify and remove wrong add-ins from the database.

IMPORTANT

No user should be logged in with GN4 applications when you are performing the procedure.

This is a destructive procedure that will remove add-ins from your database so no user will be able to use the GN4 applications until you reload add-ins in the database.

STEP 1: Identify add-ins ids in the GN4 database by means of GN4 browser

1.Run GN4 browser and log on to the system.

2.Duplicate a tab of the GN4 browser, and then type this command:

http://<your_server_name>/<your_GN4_path>/do.ashx?cmd=tree&type=addIn

This will list all add-ins in the following format:

<TreeIdName xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<TreeIdName Id="190274" Name="EdAdminCustomAddIn" ObjectType="addIn"/>

<TreeIdName Id="190271" Name="EdAdminCustomAddIn" ObjectType="addIn"/>

<TreeIdName Id="190275" Name="EdAdminSystemAddIn" ObjectType="addIn"/>

<TreeIdName Id="190270" Name="EdAdminSystemAddIn" ObjectType="addIn"/>

<TreeIdName Id="190272" Name="FredCustomAddIn" ObjectType="addIn"/>

<TreeIdName Id="190269" Name="FredCustomAddIn" ObjectType="addIn"/>

<TreeIdName Id="190273" Name="FredSystemAddIn" ObjectType="addIn"/>

<TreeIdName Id="190268" Name="FredSystemAddIn" ObjectType="addIn"/>

<TreeIdName Id="190278" Name="ShellCustomAddIn" ObjectType="addIn"/>

<TreeIdName Id="190267" Name="ShellCustomAddIn" ObjectType="addIn"/>

<TreeIdName Id="190279" Name="ShellSystemAddIn" ObjectType="addIn"/>

<TreeIdName Id="190266" Name="ShellSystemAddIn" ObjectType="addIn"/>

<TreeIdName Id="190276" Name="TedCustomAddIn" ObjectType="addIn"/>

<TreeIdName Id="190265" Name="TedCustomAddIn" ObjectType="addIn"/>

<TreeIdName Id="190277" Name="TedSystemAddIn" ObjectType="addIn"/>

<TreeIdName Id="190264" Name="TedSystemAddIn" ObjectType="addIn"/>

</TreeIdName>

Write down all 16 numbers in Id="...".

STEP 2: Purge add-ins from database

1.Open the Administrator command prompt on the server.

2.Type this command:

srv4 purge -ids 190274,190271,190275,190270,190272,190269,190273,190268,190278,190267,190279,190266,190276,190265,190277,190264

Note: You need to enter ids of all 16 add-ins.

IMPORTANT: MAKE SURE THAT YOU ENTERED CORRECT IDS AS PURGE CANNOT BE UNDONE!

STEP 3: Reload add-ins in the database

This is described in Load add-ins in the GN4 database.