JCS is mainly developed using the Netbeans IDE
I use the Adoptium JDK 17
The program is build using Maven
Create a folder where you clone the repository. Create a folder in your home folder called jcs (~/jcs).
In Netbeans open the project en perform a build On the command line cd into the model-railway folder run mvn install
The configuration and layout data is stored in an embedded (H2) database. The database files are placed in the $HOME/jcs directory. When the database does not exist it is created on startup.
Run the jcs.JCS class an database should be created on first run.
JCS has some extra properties which can control the program. These properties have to be stored in a properties file in the user.home/jcs folder and is called jcs.properties.
The following properties are supported
Retrieval of the locomotives either via CAN (default) or http works on both CS-2 and 3 locomotive.list.via=can / http default is can
Accessories retrieval via CAN, http or JSON. the ltter only works on a CS-3 accessory.list.via=can / http / JSON
Debug of the zlib inflator. When files are retrive via CAN this controls
the debugging of the inflation. When true the raw and decompressed files are
written to the file system
inflate.debug=true (default false)
JCS uses an embedded H2 database. On de first startup, when ther are no files in the jcs home directory (~/jcs) database is created. The database is created as user SA (pass jcs) this user creates the jcs schema and user( user jcs pass repo); Inside the jcs schema the tables are created.
It is possble to connect to the embedded JCS database using an SQL tool like Squirrel SQL or DBeaver Community Ensure you are using the same driver version as JCS so use the one from the maven repository like so:
JCS: jdbc:h2://jcs/jcs-db;AUTO_SERVER=TRUE;DATABASE_TO_LOWER=TRUE;SCHEMA=jcs User: jcs pass: repo
SA: jdbc:h2:/home/frans/jcs/jcs-db;AUTO_SERVER=TRUE;DATABASE_TO_LOWER=TRUE User: sa pass jcs