Setup
Download
You can download the application from OpenKM Download center.
To run the application on your computer you will need Java 8 installed.
Linux configuration
Unzip the Import-station-1.0.zip file at /home/openkm/
The name of the zip file might be changed.
$ cd /home/openkm
$ unzip Import-station-1.0.zip
In the /home/openkm/import-station-1.0/ folder you will have the following contents:
- JAR file of the import-station application.
- plugins folder: which contains the list of available plugins.
- import-station.cfg: configuration file.
- translations.sql: contains the translation terms of the application.
Register translations
You must register the import-station translations in your OpenKM. The application is used for storing the import-station translations.
- Go to your OpenKM at Administration > Tools > Database Query.
- Copy all the sql contents into the text area.
- Choose jdbc option from the bottom right.
- Click on the "Execute" Button.
Configure connection
Edit the import-station.cfg file with the following values:
| Property | Description |
|---|---|
|
okm.url |
OpenKM URL http://localhost:8080/OpenKM/ |
|
okm.import.plugins.directory |
Path of the plugins directory /home/openkm/import-station-1.0/plugins |
Launch the application
To launch the application, use this command:
$ java -jar import-station-1.0.jar
This will deploy a web application on port 3000.
The application is running ? open the URL http://YOUR_SERVER_IP:3000 in a browser (for example http://localhost:3000/).
The first time you log in to the application, a file called import-station.db will be created in the /home/openkm/import-station-1.0/ folder.
The import-station.db file is an embedded database file used by the application, which contains relevant information. Do not delete it.
Launch with custom cfg file
You can launch the app with your custom config file. To do so, just set the absolute path to the configuration file as a parameter:
$ java -jar import-station-1.0.jar /home/user/myConfig.cfg
Application command line help
Running the application with the command help will print information about all available command-line options.
$ java -jar import-station-1.0.jar help
Windows configuration
Unzip the Import-station-1.0.zip file at c:\openkm\
The name of the zip file might be changed.
In the c:\openkm\import-station-1.0\ folder you will have the following contents:
- JAR file of the import-station application.
- plugins folder: which contains the list of available plugins.
- import-station.cfg: configuration file.
- translations.sql: contains the translation terms of the application.
Register translations
You must register the import-station translations in your OpenKM. The application is used for storing the import-station translations.
- Go to your OpenKM at Administration > Tools > Database Query.
- Copy all the sql contents into the text area.
- Choose jdbc option from the bottom right.
- Click on the "Execute" Button.
Configure connection
Edit the import-station.cfg file with the following values:
| Property | Description |
|---|---|
|
okm.url |
OpenKM URL http://localhost:8080/OpenKM/ |
|
okm.import.folder |
OpenKM default import path. /okm:root/import By default, documents are imported to /okm:root/import |
|
okm.import.plugins.directory |
Path of the plugins directory c:/openkm/import-station-1.0/plugins |
Launch the application
To launch the application, use this command:
C:\> java -jar import-station-1.0.jar
This will deploy a web application on port 3000.
The application is running ? open the URL http://YOUR_SERVER_IP:3000 in a browser (for example http://localhost:3000/).
The first time you log in to the application, a file called import-station.db will be created in the c:\openkm\import-station-1.0\ folder.
The import-station.db file is an embedded database file used by the application, which contains relevant information. Do not delete it.
Launch with custom cfg file
You can launch the app with your custom config file. To do so, just set the absolute path to the configuration file as a parameter:
C:\> java -jar import-station-1.0.jar c:/myConfig.cfg
Application command line help
Running the application with the command help will print information about all available command-line options.
C:\> java -jar import-station-1.0.jar help
