Taking backup and restoring the workspace directory

This section guides you on how to take a backup and restore the workspace directory.

Backup the workspace directory

Notes:

Before upgrading to the next PTF version, perform the steps in this section to backup your workspace directory.
After you upgrade and before you roll back, repeat the same steps if you want to save a copy of the changes made after an upgrade.

To backup the workspace directory, perform the following:

Go to your workspace directory and check the owner and group of the directory by using the command:

cd {components.izp.workspaceDirectory}
ls -ld *

You can submit all the following UNIX commands with any of the following users:

A user within the same group as your workspace directory.
A substitute user (sudo) or root user.

In this example, the vdata is the workspace directory, NWTSTC is the owner, and IZPUSS is the group.

bash-5.2$ cd /proj/izp/ums/vdata
bash-5.2$ ls -ld
drwxrwxr-x  12 NWTSTC   IZPUSS      8192 Nov  2 06:55 conf
drwxrwxr-x   2 NWTSTC   IZPUSS      8192 Sep 23 11:17 log
drwxrwxr-x   8 NWTSTC   IZPUSS      8192 Nov 18 10:27 policy
drwxrwxr-x   3 NWTSTC   IZPUSS      8192 Nov  2 06:55 run
drwxrwxr-x   2 NWTSTC   IZPUSS      8192 Sep 23 11:16 tmp

Go to the following location of the workspace directory:
```
/proj/izp/ums/vdata then navigate to /proj/izp/ums
```
Copy your workspace directory to a pax file by using the command:
```
pax -x os390 -wpe -f {path_to_pax}/{name_of_pax}.pax {workspace_directory}
```
You need to replace the following variables:
- {path_to_pax} with the location you want to place the pax file.
  Note: This must not be in the current directory or any subdirectory.
- {workspace_directory} with the relative path name of your workspace directory (in the example above, it is vdata).
- {name_of_pax} with a name of your choice for the backup pax file of your workspace directory.

Restore the workspace directory

To restore a workspace directory that you backed up to a pax file, perform the following:

Note: You must run the commands with the super user permissions as a sudo or root user. If you cannot use a sudo or root user, check with IBM Support for the required permissions.

Go to the location of the workspace directory:

/proj/izp/ums/vdata then navigate to /proj/izp/ums)

Rename your current workspace directory to have a clean restore (that is, no files from the current workspace directory) by using:
```
mv {workspace_directory} {different_name}
```
Restore your old workspace directory from the pax file you created earlier by using:
```
pax -pe -rvf {path_to_pax}/{name_of_pax}.pax
```
Note: Monitor the output and check for errors that indicate an imperfect restoration. For example,
```
pax: FSUM7171 {some file name}: cannot set uid/gid: EDC5139I Operation not permitted.
```
Verify if the workspace directory is properly restored and has the same owner and group as before the restoration. For example,
```
cd {components.izp.workspaceDirectory}
ls -ld *
```

This should produce the same output as the initial listing before you archived the original workspace directory by using the pax file.