Common Operations Within the DPF System¶

This chapter describes common operations when using the DPF system:

Change to the DPF Environment¶

This is how you change to the DPF environment:

Windows: Click the DPF Shell desktop link, or select DPF Shell in the start menu.
Linux: Log on as the user used for installing DPF. Via .login and .profile, the settings required for the DPF environment will be set.
Hint - Linux user

The common user used for DPF has changed with DPF 4.0.0.
- old: plossys
- new: seal
The command to change into the DPF environment is therefore:
- old: su - plossys
- new: su - seal

The welcome message shows that the DPF environment has been loaded.

Screenshot of the welcome message in DPF Shell

This is how you start the DPF system.

Literature - administrate services

For how to administrate the services, refer to Administrate Services.

Make sure, NATS and MongoDB are running. Otherwise start them with the following command in a shell or command line:
- Windows: Start-Service seal-nats seal-mongodb
- Linux: systemctl start mongod seal-nats
Call DPF CLI in a shell or command line to start the DPF system.
```
dpf service start
```
Start the Apache Web server used for the DPF Tracker by entering the following command in the DPF environment:
```
sysstart apache
```

This is how you stop the complete DPF system.

Literature - administrate services

For how to administrate the services, refer to Administrate Services.

Enter the following command in a shell or command line:
```
dpf service stop
```
The running DPF system processes will called to stop working. The jobs being processed will be completed. After restarting, the DPF system continues processing here.
Stop the Apache Web server by entering the following command in the DPF environment:
```
sysstop apache
```
Stop MongoDB and NATS with the following command in a shell or command line:
- Windows: Stop-Service seal-nats seal-mongodb
- Linux: systemctl stop mongod seal-nats

This is how you display the status of the DPF system:

Enter the following command in a shell or command line:
```
dpf service status
```
The processes and their current states are listed.
To check the status of MongoDB and NATS use the following command in a shell or command line:
- Windows: Get-Service seal-nats seal-mongodb
- Linux: systemctl status mongod seal-nats

The DPF environment provides you with commands for navigating through the directory structure of the DPF system quickly:

Command	Description
`dd`	`dd` changes into the DPF Director directory, `server\director\tomcat\webapps\director`.
`dpf`	`dpf` changes into the directory, `server\dpf`.
`dpfd`	`dpfd` changes into the data directory specified with the `DPFDATA` environment variable.
`dpfs`	`dpfs` changes into the `server\dpf\scripts` directory containing the working unit scripts.
`dpft`	`dpft` changes into the `server\dpf\templates` directory containing the configuration modules.
`log`	`log` changes into the `data\log directory` containing the log files.
`scd`	`scd` changes into the `data\sysstat` directory containing the lock files of the programs.
`stat`	`stat` changes into the `SEAL_CUSTOMDIR` directory containing the customer specific files.
`tmp`	`tmp` changes into the `data\tmp directory` containing the temporary files.