User guide v5.x

Printer Tool allows users to print documents in PDF format and upload them to OpenKM.

Configuration

1. Go to the notification area of the Windows taskbar.
2. Right-click the OKMPrinter icon.
3. Go to the “Configuration” option. 

First, you must choose the Configuration menu item to set your configuration values:

Property	Type	Description
Language	Select	User interface language.
User	String	User ID for accessing OpenKM. user1
Password	String	The password of the user. pass1
Host	String	OpenKM URL. http://localhost:8080/openkm/
Request path to upload	Bool	When it is enabled, the user will be asked if they want to change the default destination path.
Default path to upload	String	Set the default destination path. This option is enabled when the “Request path to upload” option is disabled.
Use personal token	Bool	The authentication will be done with the access token.
Personal token	String	The personal access token. okmpat-Ky1t16O2Rwx4ttPmOK0R

After you set your configuration values, a folder called OpenKM is created in your user My Documents folder. In this OpenKM folder, there is a configuration file named openkm.xml

Alternative configuration of the main file folder

To configure a custom path for storing key application files such as:

• The log file (openkm.log)
• The configuration file (openkm.xml)
• Temporary files generated during runtime

This configuration is done using the okm.folder.path property, located in the app.properties file within the installation directory.

Example:

okm.folder.path=C:\\New_folder_path

Note

When to Use This Configuration:

This option is especially useful when there are issues using the default file paths, such as:

• Insufficient file system permissions

• Limited disk space or access restrictions in the default location

• Need to separate system files from configuration and data

• IT infrastructure policies or organization requirements

After making the changes, you must restart the app.

Print and upload

1. Open a document from any application.
2. Print the document.
3. Choose “OKMPrinter” as the destination printer.
4. The application will show a message “The document has been successfully uploaded” to indicate the process is finished.

The uploaded document will be saved with the pattern: “OKMPrinter_YearMonthDay_Hour.pdf”.