Download and upload sever files

You can use the Browse Server Files page to download files from and upload files to the <PPM_Home> directory.

Prerequisites

The Browse Server Files page is available to administrators with the following access grants:

  • Sys Admin: Server Tools: Execute Admin Tools

  • Sys Admin: Server Tools: Execute File Browser

Caution: Users can view contents of all the files in <PPM_Home> in read-only mode once they have access to the Browse Server File tool, we recommend that you provide the Server Tools: Execute File Browser access grant only to selected OpenText PPM administrators.

Note: The <PPM_Home>/security directory is not accessible through the File Browser and is not listed in the contents of <PPM_Home> as it contains the sensitive private key used for SSL encryption. You must connect directly to the PPM Server machine to access this folder.

Back to top

Browse and download server files

You can browse and download server files to your machine. You can also preview the file details.

To browse and download files from the <PPM_Home> directory:

  1. Click the Administration button in the masthead.

  2. From the Administration menu, click Support Task > Browse Server Files. The Browse Server Files page displays all the files and folders located in the <PPM_Home> directory.

  3. Perform the following actions:

    Action Details
    Browse files

    Click any folder to view its content.

    To navigate to other folders, click a desired bookmark on top of the Browse Server Files page, or click any element of the navigation path (path is relative to <PPM_Home>).
    Preview and download individual files

    Click a file to preview its details. On the preview page, click the file name link at the top to download it.

    Note:

    • The file types that can be previewed include the following: txt, css, conf, html, htm, xml, js, jsp, json, java, properties, yml, bat, xsl, sql, sh, log, jpg, jpeg, png, gif, webp, svg, ico, bmp, pdf, mp3, wav, mp4, webm, and ogg.
    • File types that cannot be previewed in the application are automatically downloaded.
    Download multiple files

    Select multiple files or folders, click Download selected file(s) as .Zip to download them in a zip file.

    The folder hierarchy in the zip file is rebuilt relatively to the
    <PPM_Home> directory. Empty folders in the zip file contains an empty file so that empty folders are not removed automatically from the zip file. These empty files are created dynamically when the zip file is generated and are not present in the server file system. File information displayed includes name, size, permissions (R for read, W for write, X for execute), and last modification date.
    Sort files and folders

    Click a column header to sort the displayed files and folders.

    Note:

    • When sorting files and folders, the folders are always displayed before the files, independent of the sorting criterion.
    • When viewing folders other than the <PPM_Home> folder, a [..] folder is displayed at the beginning of the list to let you access the parent folder.

Note:

  • When OpenText PPM is configured in cluster mode, the File Browser only displays the files of the <PPM_Home> directory that contain the OpenText PPM instance to which you are currently connected to.

  • If you want to access another <PPM_Home> of the cluster, you must manually connect to a OpenText PPM instance hosted in this <PPM_Home>> folder.

  • When zipping files and folders, you can only select files and folders located in the same folder. If you switch to another folder while some items are selected, the selected items are not included in the generated zip file.

Important considerations

Pay attention to the following when browsing and downloading server files:

Consideration Details
Cluster Configuration Considerations

  • When OpenText PPM is configured as a server cluster and there are multiple OpenText PPM instances in the same <PPM_Home>, you can access all the files of all the OpenText PPM instances located under the same <PPM_Home> folder as the instance you are connected to.

  • When selecting Logs or HotFix links in the bookmarks, you must manually choose the PPM instance you want to access. The folder is automatically displayed when the instance is selected.
Performance Concerns

It can take many seconds when there are many thousands of files to list in the folder which contents are displayed, for example, the
<PPM_Home>/cache folder, where images of PPM Charts are saved and only deleted after 7 days by default.

Note that there is no significant performance or memory impact on the PPM Server if you decide to download the entire contents of <PPM_Home> as a zipped file. This is a safe (though time-consuming) operation, but some temporary files might not be included in the resulting zip file if, for example, they are locked when you try to include them in the Zip file.

Back to top

Upload files

You can upload files to and create folders in the PPM_Home directory from the Browse Server Files page only when the server is running in Development mode.

Prerequisite:

To upload files, make sure the Upload files to PPM Server in File Browser feature toggle is turned on. For details, see Use feature toggles to turn on/off features.

Caution: By enabling this feature you may expose the system to increased security risks.

To upload files and create folders:

  • Click the folder where you want to upload a file or create a folder.

  • To upload a file, drag and drop it to the upload area. Or, click the upload area to browse and select the file to upload.

  • To create a folder, in the create folder area, provide a name for the folder and then click Create Folder.

Back to top