Asset Deletion 3 - Configure server actions for deletion

There is an automatic server action to perform the deletion process in Asset Deletion 3. Besides that, an individual server action deals with single assets. This article explains how to configure server actions. It also covers different environments like a single server or master remote installations.

Context

• Asset deletion 3 is the successor of Asset Deletion 1 and 2.

The configuration for Asset Deletion 3 consists of three parts:

• Create asset version policies: Define, which asset types and domains are processed by the asset deletion process.

• Configuration of the Asset Deletion 3 report: Use the report to check how an asset version policy is applied for an asset. See all constraints that prevent versions to be deleted.

• Configuration of the two deletion server actions: The automatic server action cleans up the whole database and affected asset files. The individual server action executes on a single asset.

Prerequisites

• Administration rights for the Censhare Admin Client.

• Understanding of the deletion process in Asset Deletion 3.

• Basic understanding of censhare, especially assets, asset relations, asset types, and domains.

Introduction

You can configure two server actions:  

• Delete Asset Version (automatic): The server action executes the asset deletion process for the whole database. It runs in defined intervals defined by a cron pattern.

• Delete Asset Versions (individual): The server action executes the deletion process for individual assets and is started manually. The user action is available in the Censhare Client.

Both server actions execute the two parts of the deletion process:  

• Mark asset versions

• Delete asset versions

Each part of the deletion process has a limited execution time that is configured in the server action. If the time is over, the server stops the execution and continues with the next part. The server does not stop immediately but finishes all steps of the actual round of the actual executed deletion part.

The first and the second part of the deletion process run on the relational database. Therefore, they must be configured on one Server only.

The configuration also depends on the environment of your Censhare installation.

You can configure a third server action: 

Asset Deletion 3 Report: It reports all versions for an asset that have constraints and cannot be deleted as of that. For more information on the Asset Deletion 3 Report.

Server action: Delete Asset Versions (automatic)

Configure

1. In the Censhare Admin Client, go to the "Configuration/Modules/Asset Deletion 3" folder.

2. Open the Delete Asset Versions (automatic) entry.

3. Enter the desired values.

4. Click OK.

5. Update the Master Server and Remote Servers if existing.

Configuration settings

Set execution time

To run the automatic Server action, you must define a cron pattern. This is done in the Cron pattern field in the configuration dialog:  

Use an asterisk (*) for "first-last''. For example, the pattern "0 4 * * *" starts the command every day at 4 a.m. For more information, execute "man 5 crontab" in a terminal window.

Server action: Delete Asset Versions (individual)

To configure the server action, in the Censhare Admin Client, open Delete Asset Versions (individual) in the Asset Deletion 3 module in "Configuration/Modules/Asset Deletion 3".

Configuration

The configuration has the same settings as Delete Asset Versions (automatic), except for the cron settings.

Execute

censhare Client

1. In the Censhare Client, select the asset on which you want to run Asset Deletion 3.

2. Click Server actions and select Delete asset versions (individual): A report shows a summary of the action.

Note: If there is no asset version policy that matches, you do not receive a warning. No asset version is marked for deletion.

Note: Run the Asset Deletion 3 report before running Delete asset versions (individual). The report shows which asset versions are skipped. If no asset version policy applies, you receive a warning.

censhare Web

In Censhare 2019.2, the Delete Asset Versions (individual) server action is not available in Censhare Web.  

Configuration of the Server environment

Note: Asset Deletion 3 is supposed to run on the Censhare Server that accesses the database. Typically, this is the Master Server. The database must be located at the same place as the Censhare Server. This is to have low latencies in the communication between Censhare Server and the database.

Delete asset versions (automatic/manual)

The configuration of the server commands for Asset Deletion 3 depends on the setup of your Censhare Server environment. The following setups are possible:

• one single Censhare Server (Master)

• one central Censhare Server (Master) and one or more Censhare Servers (Remote) on other locations

• a cluster of Censhare Servers at one location

In any of the setups above, one Censhare Server must be configured as Master Server. This server maintains the configuration. All other servers are Remote Servers. They receive their configuration from the Master Server. 

In a single server environment, use the Update server configuration button in the Censhare Admin Client to update the Master Server. In a multiple server environment, use the Synchronize remote servers button. This server action updates the Master Server in the first step and afterwards all Remote Servers.

Single Master Server

This server connects to the database and the file system. Enable all steps of the deletion process in the configuration:

• Mark asset versions

• Delete asset versions

Distributed installation (automatic server action)

One Censhare Server connects directly to the database. Typically, this is the Master Server. Remote Servers connect to the database via the Master.

On the Master Server, enable both steps:  

• Mark asset versions

• Delete asset versions

For data integrity Mark asset versions and Delete asset versions must run on only one server.

Distributed installation (manual server action)

On the Master Server, enable both steps for the manual server action:

• Mark asset versions

• Delete asset versions

censhare Cluster

In a cluster, Censhare Servers share one storage system where all asset files are stored. Only one server must execute the deletion process. Typically, this is the Master Server. On that server enable both steps:  

• Mark asset versions

• Delete asset versions

On all other Censhare nodes of the cluster, Asset Deletion 3 must not be configured. This is to maintain data integrity. 

Result

You have configured the automatic and the individual server actions for Asset Deletion 3.

Next steps

• Define asset version policies.

• Check asset for constraints using the asset deletion report.