Java on the james

JAMES – A Java Metaheuristics Search Framework

JAMES is a modern Java framework for discrete optimization using local search metaheuristics. Various optimization algorithms are provided that can be applied to any user-defined problem by plugging in a custom solution type and corresponding neighbourhood. Predefined components are included for subset selection.

A major advantage of metaheuristics is that they are generally applicable to various optimization problems. A framework like JAMES enables the user to apply existing algorithms to newly defined problems with minimum effort. The performance of different algorithms and influence of parameter values can easily be studied and the focus can go to what really matters: carefully defining the problem and selecting an appropriate optimization strategy – not implementation.

Get started with JAMES

Download and install the latest version of the JAMES framework. You can either add a Maven dependency to automatically pull in all required packages or you can manually download and install the JAR files.

Read the documentation

Scroll through the list of available optimization algorithms, consult the Javadoc API or take a look at the GitHub wiki pages for more detailed information about the architecture of the framework.

Look at some examples

Step-by-step implementation guides are provided for a series of example problems. In these examples, several different optimization algorithms are applied to obtain solutions for the specified problems.

References

If you use JAMES for your research, please cite:

De Beukelaer H, Davenport GF, De Meyer G, and Fack V. JAMES: An object-oriented Java framework for discrete optimization using local search metaheuristics. Software: Practice and Experience. 2016; DOI: 10.1002/spe.2459

De Beukelaer H, Davenport GF, De Meyer G, and Fack V. JAMES: A Modern Object-Oriented Java Framework For Discrete Optimization Using Local Search Metaheuristics. 4th International Symposium And 26th National Conference On Operational Research. Chania: Hellenic Operational Research Society, 2015; 134–138.

Source code repository

The JAMES framework is fully open source, visit GitHub to view the JAMES source code repository.

License and copyright

The source code and binaries of JAMES are licensed under the permissive Apache License, Version 2.0 with a joint copyright (see below). For a quick summary of what can, cannot and must be done according to the Apache license we recommend looking at tl;drLegal. Unused modules can be dropped from the copyright statement.

JAMES Core Module JAMES Extensions Module Copyright 2014-2017 Ghent University Bayer CropScience

The documentation and website are licensed under the Creative Commons Attribution 4.0 International License © 2014-2017 Ghent University. The website is built using Bootstrap released under the MIT license © 2011 — 2017 Twitter (with icons from Font Awesome © Dave Gandy).

Источник

Java on the james

• ASF
• Get Involved
• FAQ
• License
• Sponsorship
• Thanks
• Security

Requirements

Java Virtual Machine

James 3.8.0 requires a Java Runtime Environment. Java version 11 is required to run the James application. The exact JREs available depends on the platform. In addition, the environment variable JAVA_HOME should be set to the JRE home directory before running James.

James 3.8.0 has been successfully tested on OpenJDK 11

User Privileges

On Linux/Unix platforms, root access will be required to run James (access to ports below 1024 is generally restricted to the root user). As SMTP, POP3, and IMAP4 need to open server sockets on such ports in standard configurations, James requires root access.

On Windows platforms, you also need to run James as Administrator privilege.

Libc6

On Linux, to run the startup/shutdown script via the ‘james’ command, you also need libc6 (on Ubuntu for example: sudo apt-get install libc6-i386 libc6-dev-i386).

System Resources

Obviously James also requires sufficient disk space, processor power, and network bandwidth. But, other than what’s been discussed here, it has no additional special requirements.

James is configured to run with 512 MB RAM (-Xmx512M in the bat/sh) available, but may need more or less depending on the load. With the default configuration, JVM can use until 512M (It does not mean it will do). It really depends on your traffic, and also which mailbox you will use (you can save much memory if you don’t use the default embedded derby database but an external database of your choice). Work is still done to minimize the needed memory.

Build instructions

Checkout code from the chosen version on GitHub. Follow README instructions about compilation.

Using these instructions, you can build the following images:
• Guice + JPA + Lucene
• Guice + Cassandra + OpenSearch
• Guice + Cassandra + OpenSearch + LDAP
• Spring

Alternatively, if you don’t want your build to be handled via Docker, you can follow Guice Cassandra quick-start

Note that install instructions from command line are available for Cassandra-Guice, JPA-Guice and JPA-SMTP-Guice.

A docker-compose is available for Guice + Cassandra + OpenSearch + RabbitMQ

Install Step by Step

Step 1: Download James

Obtain the full James binary (or source) distribution from the James release mirrors.

If you have downloaded a binary distribution, you do not need to build James. Proceed directly to Step 2.

If you have downloaded a source package, process first to the build and come back to Step 2.

Step 2: Deploy James

Unpack the archive into your James installation directory.

Step 3: Configure James

After unpacking the binary, the next step is to adjust the initial configuration. All configuration files are embedded in jars. We ship in the conf folder the configuration files that can be edited to match your needs.

Additional system files reside under the./conf/META-INF folder.

The out of the box configuration makes certain assumptions and has some default values that are unlikely to be appropriate for real-world servers. There are a few issues that should be addressed immediately upon installation:

• Postmaster Address — Change according to your need — read more.
• Most UNIX systems require superuser privileges to open sockets below 1024, which includes the IANA-standard SMTP (on port 25), POP3 (on port 110) and IMAP4 (on port 143). These default ports can be changed in the conf file (read for pop3, smtp and imap4. Obviously, you would then need to reconfigure your clients. This may not be an option if you want to receive mail from external mail servers.

In addition to adjusting these parameters, you may wish to consult the documentation for a discussion of all other configurations. A list of such configurations, as well as the steps necessary to configure them, can be found here.

Step 4: Start James

Go to the bin subdirectory of the installation directory and run $ ./james start.

Running $ ./james help help will provide the list of commands you can invoke.

Once started, you’ll see in the log file (./log/wrapper.log) that James is running. This means that Spring has loaded James and is now waiting for a request.

Step 5: Create Domains and Users

Finally, after launch, it will be necessary to create domain and user accounts before the James server will be fully operational. Read instructions on creating domains and user accounts.

Since at the beginning James is empty, it will not have any domain (except the default one)nor local users registered.

To register a local domain and user, cd bin and type james-cli.sh. Follow the given instructions

Invoke «james-cli.sh adddomain is the domain name of the domain you wish to create.

Invoke «james-cli.sh adduser » where is the user name and is the password of the account you wish to create.

Please note that the user name MUST be a complete email address of the form @ (where is any of the values specified in the block of XMLDomainList or a domain defined via the domain management).

Step 6: Test James

Once you have some local users registered, try sending mail to one of them with SMTP (port 25).

$ telnet 127.0.0.1 25 Trying 127.0.0.1. Connected to localhost. Escape character is '^]'. 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0.0) ready Wed, 20 Jul 2017 17:31:33 +0100 (CET) ehlo test 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1]) 250-PIPELINING 250-ENHANCEDSTATUSCODES 250 8BITMIME mail from: 250 2.1.0 Sender OK rcpt to: 250 2.1.5 Recipient OK data 354 Ok Send data ending with . subject: test this is a test . 250 2.6.0 Message received quit Connection closed by foreign host.

Try now to retrieve that mail using POP3 (port 110) or IMAP (port 993 with OpenSSL).

$ openssl s_client -connect 127.0.0.1:993 CONNECTED(00000003) Can't use SSL_get_servername depth=0 C = FR, ST = Unknown, L = Puteaux, O = James, OU = Linagora, CN = Benoit Tellier verify error:num=18:self signed certificate verify return:1 depth=0 C = FR, ST = Unknown, L = Puteaux, O = James, OU = Linagora, CN = Benoit Tellier verify error:num=10:certificate has expired notAfter=Nov 24 07:32:55 2015 GMT verify return:1 depth=0 C = FR, ST = Unknown, L = Puteaux, O = James, OU = Linagora, CN = Benoit Tellier notAfter=Nov 24 07:32:55 2015 GMT verify return:1 --- Certificate chain 0 s:C = FR, ST = Unknown, L = Puteaux, O = James, OU = Linagora, CN = Benoit Tellier i:C = FR, ST = Unknown, L = Puteaux, O = James, OU = Linagora, CN = Benoit Tellier --- Server certificate -----BEGIN CERTIFICATE----- MIIDeTCCAmGgAwIBAgIEXaLC/zANBgkqhkiG9w0BAQsFADBtMQswCQYDVQQGEwJG UjEQMA4GA1UECBMHVW5rbm93bjEQMA4GA1UEBxMHUHV0ZWF1eDEOMAwGA1UEChMF SmFtZXMxETAPBgNVBAsTCExpbmFnb3JhMRcwFQYDVQQDEw5CZW5vaXQgVGVsbGll cjAeFw0xNTA4MjYwNzMyNTVaFw0xNTExMjQwNzMyNTVaMG0xCzAJBgNVBAYTAkZS MRAwDgYDVQQIEwdVbmtub3duMRAwDgYDVQQHEwdQdXRlYXV4MQ4wDAYDVQQKEwVK YW1lczERMA8GA1UECxMITGluYWdvcmExFzAVBgNVBAMTDkJlbm9pdCBUZWxsaWVy MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAhW0GWSgkK44XQpwLn8KX q9kJ3zgDYllEX7W8p+3sBYMAP0JC+lzh42mX/8XHti0vkmv/vjk0paAsB9s5uYhv /W94sdqjexi3L213+OD5Kcy+2tTgXN1ucF65d/dDeqGHAyBs1rm6LgyRwQ5ye8Cl OtXbSkz5qujmnFDDzrDIgzefxFsTHHIBTsdyttq2Atqzgdg2LHaFbIntwr6lfl9v puXr8p+CY6PfehX8mdmaJ7J/gfAll3zzdgeNUoAW0eDvcsphJ06elsDahieo0n/o XVhy+TGWtAQRDZQDjeK2BX/vVSPAlGOW7hVTv7WycAolzKlXZyiJMnwTWJl6YoUP vQIDAQABoyEwHzAdBgNVHQ4EFgQU7tDLswRlOJqoX4aVgrXRQbmOYbIwDQYJKoZI hvcNAQELBQADggEBAGmzK2i2H5D6xITyN1iNQhXbABQ/3rz9K5dEvy0ZLgYOUqyw 1WD43Do/A3eZuEZbuuYAlbvDEUNgS7rJ5HCrwIKFbPHWmfRX2j59UX+R8fI6G9wB qqcRYWpert347rGT/7MFLHk55LL6Tf//fwoWu6GWRj3wTvosVuunUiiC6zTS4MN9 moJp+IF03Q6JOPWu7/tfaKfXQHxG/hK492oV2vBG2r29UUJW6YO1S0DK+/cU0cCu +jqbY1ZOIAk906onRUFoPGuypOm3vmbE6mo5o49rNtp+VmZagZ7GsjJ4KWJB1c6d SFNIFlH2VlS8Lywr2tesClWO5tqtMswRsoA9GeU= -----END CERTIFICATE----- subject=C = FR, ST = Unknown, L = Puteaux, O = James, OU = Linagora, CN = Benoit Tellier issuer=C = FR, ST = Unknown, L = Puteaux, O = James, OU = Linagora, CN = Benoit Tellier --- No client certificate CA names sent Peer signing digest: SHA256 Peer signature type: RSA-PSS Server Temp Key: X25519, 253 bits --- SSL handshake has read 1425 bytes and written 363 bytes Verification error: certificate has expired --- New, TLSv1.3, Cipher is TLS_AES_256_GCM_SHA384 Server public key is 2048 bit Secure Renegotiation IS NOT supported Compression: NONE Expansion: NONE No ALPN negotiated Early data was not sent Verify return code: 10 (certificate has expired) --- --- Post-Handshake New Session Ticket arrived: SSL-Session: Protocol : TLSv1.3 Cipher : TLS_AES_256_GCM_SHA384 Session-ID: 92D136BF8C9E3E09C4FF7946A2AFDC8ED6E395A1729532D3544E58F688B787F9 Session-ID-ctx: Resumption PSK: C4E09FF3045720EE910AEA5300D87FDE2200A56F218AC3F75748BE794F73F32790FC8DD35CA70869FBD075727779BA73 PSK identity: None PSK identity hint: None SRP username: None TLS session ticket lifetime hint: 86400 (seconds) TLS session ticket: 0000 - 03 d2 89 8a 32 48 28 a2-99 24 99 47 b2 05 e8 99 . 2H(..$.G. 0010 - 6b 9b a9 0b 59 95 dd 2c-fb ba 46 b9 94 ad 36 63 k. Y. F. 6c Start Time: 1630033038 Timeout : 7200 (sec) Verify return code: 10 (certificate has expired) Extended master secret: no Max Early Data: 0 --- read R BLOCK * OK JAMES IMAP4rev1 Server 2e73ecd482f4 is ready. a login bob@domain.com 1234 a OK LOGIN completed. 1 logout * BYE IMAP4rev1 Server logging out 1 OK LOGOUT completed. closed

Trace out James actions in ./log/wrapper.log.

Actions that will be taken by James on incoming mail are configured in the mailet pipe line (./conf/mailetcontainer.xml). Look at it if you want to understand what’s happening.

Источник