Zum Ende der Metadaten springen
Zum Anfang der Metadaten

PicApport has been written in the Java programming language.

The good news: The PicApport server runs on almost every modern operating system platform (Lächeln).
The bad news: Because of the high number of installation options for us it's not possible to document all installation details for all operating systems (Zwinkern).

We are happy to receive any information or experience with the installation of PicApport that we can publish and share with other users.

Thanks to some PicApport users we have already received a lot of information that we publish in this guide.

 

Hardware Requirements for the Server

Photo collections are real data monsters. Depending on the number of photos and concurrent users we recommend at least 512 MB free memory for the server.

For large collections > 100.000 (One hundred thousand) photos we recommend a 64-Bit JVM (It is very important to test)

Important

If PicApport is not installed with the Windows-Installer then the memory configuration must be set while starting the PicApport Server. (e.g. java -Xms512m -Xmx1024m)

For examples see: PicApport-Server Guide or How can I control the memory that PicApport uses?

Oracle documentation see: https://docs.oracle.com/javase/8/docs/technotes/tools/windows/java.html

Experience values (reported by PicApport users)
Memory settings

Java-JM
32/64 Bit

Operating systemPicApport VersionNumber of photosConcurrent usersRemarks

-Xms4048m -Xmx4048m

Even if these values work fine for 10 users,
for one million photos we recommend higher values

Oracle java version "1.8.0_111"
Java(TM) SE Runtime Environment (build 1.8.0_111-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.111-b14, mixed mode)

Windows 10 pro 64bit
Intel(R) Core(TM) i7-4900MQ CPU 2.80GHz
RAM 16GB

6.3.001.000.00010

All 1.000.000 photos have been stored on a USB3 connected magnetic harddisk.
The .picapport directory was located on the built-in SSD

  • Total photo space on USB-drive: ~2,5TB
  • Size of .picapport directory including db:

-Xms2048m -Xmx2048m

Even if these values work fine for 10 users,
for 400.000 photos we recommend higher values

Oracle java version "1.8.0_111"
Java(TM) SE Runtime Environment (build 1.8.0_111-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.111-b14, mixed mode)

Windows 10 pro 64bit
Intel(R) Core(TM) i7-4900MQ CPU 2.80GHz
RAM 16GB
6.2.2400.00010

All 400.000 photos have been stored on a USB3 connected magnetic harddisk.
The .picapport directory was located on the built-in SSD

  • Total photo space on USB-drive: ~920GB
  • Size of .picapport directory including db: 5,3GB

-Xms512m -Xmx1024mOracle Java JRE 1.8.0_102, 64bitUbuntu 16.04 LTS, Desktop-Version6.225.0004 
-Xms2048m -Xmx2048m

Oracle jre1.8.0_91 64-Bit
Oracle jre1.8.0_91 64-Bit

Windows 10
Windows 10
6.2
6.2
50.000
7.000
4
10
Zwei Server auf einem PC

-Xms1024m -Xmx2048m -Xss4m -XX:MaxMetaspaceSize=128m

32-Bit

QNAP NAS TS-653 Pro with 8 GB RAM
and Intel Celeron J1900 (4 cores, 2 GHz)

6.1100.000 
100.800 photos and about 11.500 generated thumbnails:
2 hours from start until NotifyStopCrawl.
another 3 hours for initial thumbnail creation so far.
Almost one GB for the database.
       

 

Installation under Windows

For the installation under Windows we provide a comfortable installer. See Installation of PicApport on a Windows System.

More advanced users or administrators can install PicApport as a Windows service (Daemon). See Installation of PicApport as a Windows-Service.

Of course you can also run PicApport with an existing Java installation under Windows.

Installation under Linux

Installation on NAS-Systems

Installation under OS X

Installation in a Docker-Container

The directory structure of the PicApport Server

By default PicApport stores all variable data-files below the home-directory of the current user in the directory .picapport. The name and location of this directory can be changed. See also: PicApport-Server Guide.

Under Windows this is normaly C:\Users\YOUR-USERID\.picapport

Under Linux this is normaly  /home/YOUR-USERID/.picapport

If PicApport is started for the first time on a server, this directory will be created automatically and populated with standard default values.

The PicApport directories

Directory NameContent
.picapport
  • picapport.properties (encoding=ISO_8859-1)
    Server configuration. Documentation of the parameters see: PicApport-Server Guide
  • picapport.ks
    Keystore. Generated automatically if SSL is configured.
  • PicApport.lck
    Interne lock file (used to prevent that server is started multiple times)
  • palicense.properties
    Optional license file for commercial users
picapport/cacheContains the optional photo cache of PicApport. see also parameter  foto.jpg. usecache and foto.jpg.cache.path.
picapport/db

Contains the database of PicApport. If not present, the directory and its contents is created automatically when the server starts. All contents of the database are generated exclusively from the photo metadata. The db directory therefore must not be saved.

picapport/designsContains optional designs. See: PicApport - Designs
picapport/logfilesContains server log-files
picapport/maildefContains configuration files of email subsystem.
picapport/pluginsContains optional plugins. See PicApport Plug-in Guide
picapport/queries

Contains xml-files of saved dynamic collections.
Subdirectories:

  • user - Further subdirectories with user-specific collections
  • roles - Further subdirectories with role-specific collections

picapport/themes

Contains theme adjustments for commercial use.
picapport/uploadtempDirectory for temporary files during user uploads.
picapport/usersContains all files required for the user-management: See PicApport - Usermanagement

Important

PicApport requires unlimited write access to the directory .picapport.

  • Create, change and delete files
  • Create, change and delete subdirectories

Eine detaillierte Beschreibung der Verzeichnisstruktur findet sich hier: Die Verzeichnisstruktur des PicApport Servers

  • Keine Stichwörter