Mersenne.ca download mirror

• https://www.mersenneforum.org/node/1057120
• https://github.com/tdulcet/AutoPrimeNet

AutoPrimeNet: Automated PrimeNet assignment handler for GIMPS software

Quick start

❤️ Donate Please consider making a donation to support the continued development of AutoPrimeNet.

What AutoPrimeNet is for

Prime95/MPrime has built-in PrimeNet support. Many other GIMPS programs are faster or specialized for particular hardware, but they need a separate assignment handler. AutoPrimeNet fills that gap.

• It keeps your machine supplied with work. It can request new assignments before your current ones finish.
• It allows your systems to get much smaller Category 0 and 1 exponents, which can be completed faster.
• It reports progress automatically. You can monitor your systems on the mersenne.org CPUs page.
• It submits results and proof files. You do not need to manually copy results into web forms or upload PRP proofs by hand.
• It helps prevent accidental expiration. New assignments are acknowledged and progress is reported automatically.
• It supports advanced workflows. Examples include per-worker work preferences, assignment recovery, specific exponent registration, proof archiving, e-mail/text notifications, proxy support, and mersenne.ca assignments above the PrimeNet 1G exponent limit.

Which GIMPS programs are supported?

Download

First-time setup

Run the setup wizard once. It creates a prime.ini configuration file and registers this machine with PrimeNet.

The setup wizard will ask for a few values:

• PrimeNet user ID: use your mersenne.org/GIMPS user ID, or type ANONYMOUS if you do not want to use an account.
• Computer name: any short name that helps you recognize this machine on the CPUs page.
• GIMPS program: choose the program you plan to run in this same folder.
• Workers: the number of CPU or GPU workers or worker directories that you configured the GIMPS software to use.
• Work preference: if unsure, use the default suggested by the wizard. Advanced users can choose LL, PRP, PRP cofactor, trial factoring, P-1 or ECM depending on their software.
• Optional features: proof archive directory, proxy server, e-mail/text notifications, disk-space limits, minimum/maximum exponents, and per-worker work preferences.

Running AutoPrimeNet day to day

1. Start AutoPrimeNet and leave it running. By default, it watches the results files and proof directories using the operating system's file notification feature, so it can submit results and upload proof files shortly after they are created instead of waiting for the next --timeout interval. Assignment fetching and periodic progress check-ins still happen on their configured intervals.
2. Start your GIMPS program in the same directory, or in the worker directories you selected during setup.
3. AutoPrimeNet writes assignments to the work file used by your GIMPS program, watches for progress and results, and contacts PrimeNet/mersenne.ca as needed.
4. Check the output or autoprimenet.log file if something does not look right.

To run AutoPrimeNet once and exit, use --timeout 0. This is useful for testing setup, submitting pending results, or manually fetching a small amount of work.

Common tasks

Upgrading AutoPrimeNet

To upgrade, simply replace autoprimenet.exe or autoprimenet.py with the new version. Keep your existing prime.ini configuration file, work files, result files, and logs. Check the release notes on Mersenne Forum for any breaking changes.

Troubleshooting

Advanced notes

python3 autoprimenet.py --timeout 0 --username ANONYMOUS --computer-name example --workpref 150 --prpll

More information and support

AutoPrimeNet is an automated assignment handler program that also uses the PrimeNet API. It supports most GIMPS software, including Mlucas, GpuOwl, PRPLL, PrMers, CUDALucas, mfaktc, mfakto and PrimePath, and can additionally report results from Prime95/MPrime, CUDAPm1, cofact and gvtf. It is written and maintained by Teal Dulcet, with previous contributions from Daniel Connelly (CUDALucas) and Tyler Busby (mfaktc/mfakto). It was originally adapted from an older script for Mlucas by Loïc Le Loarer and Ernst W. Mayer.

• AutoPrimeNet README, source code and issue tracker on GitHub
• AutoPrimeNet support thread on Mersenne Forum (may require a sign in)