Install Portfolio-synode
This document is the 0.7.0 demo version. Some function in the UI is still in developing.
Prerequisit
Portfolio-synode requires Python 3.9 and JDK 17.
For Linux, please also install Exiftool.
Follow the document or use apt to install:
sudo apt install exiftool
And make sure “exiftool -ver” is running.
The services are acturally started by command:
java -jar bin/jserv-album-0.7.0.jar
java -jar bin/html-service-0.1.1.jar
Please make sure your JDK is running.
Install Steps
Download synode registry, registry.zip from the project’s releas page.
Unzip the Synode registry.
Portfolio Synode 0.7.0 can only work as a stand alone service node. Registry is used in the future for synchronizing register.
Download jserv-album-0.7.1.zip or check lastest version at the project’s releas page.
Unzip in a floder, say, protfolio-synode
Setup Portfolio-synode’s Python module
in portfolio-synode, run:
pip install bin/synode_py3-0.7-py3-non-any.whl
To check if it’s installed successfully, run:
pip show synode.pye
Start Portfolio-synode
Don’t run this in VS Code Termnial in Linux. See the issue & troubleshootings if you have to, while it’s recommended to run this in VS Code in Windows.
Run
python3 -m src.synodepy3
Click the top button for opening registry dir.
User Id, password and Login function are not available in demo version. Leave the fields untouched.
Click Setup if everything is OK.
Click Start. The data service should be running now.
Or run “java -jar bin/jserv-album-#.#.#.jar” in the folder.
There should be a QR Code showing in the GUI. You can scan with a Portfolio client, e.g. the Portfolio Android, to connect to this service node.
Test Run
Check firewall configurations
Protfolio-synode by default will listening on TCP port 8964, the data service, and port 8900, the web page server.
Open the webpage in a browser
Open the home page for listing uploaded files, e.g.:
url: http://127.0.0.1:8900
There should be the files once are uploaded with Portfolio Android.
Install Windows Services
Portfolio-Synode must be installed as Windows serices if is running in Windows. Click the install Windows Service button to install. This process requires administrator permission, which will asks for 4 times, 2 separate service for Web pages and data service, each requires a install and a start permissions.
Please also be aware of the permission confirmation’s dialogs can be hidden behind current Window.
Uninstall Portfolio-synode
For Windows:
In CMD Termnial, or VS Code Bash Termnial,
# cd portfolio-synode
synode-uninstall-srv
This will uninstall the Windows services.
Then uninstall python modules:
pip uninstall synode.py3
pip uninstall anson.py3
No it’s safe to delete the portfolio-synode folder. The files saving location is specified by the volume path. You can delete the folder if you don’t need the files anymore.