JonDoConsole.jar

From JonDonym Wiki
(Difference between revisions)
Jump to: navigation, search
(moved)
 
Line 1: Line 1:
<iimg>[[JonDoConsole.jar]]![[Image:en2.png]]</iimg><iimg>[[JonDoConsole.jar/de]]![[Image:de2.png]]</iimg>&nbsp;[[Main_Page|Main Page (en)]] | [[tips and tricks|Information for JonDonym users]]
+
moved to [https://anonymous-proxy-servers.net/en/help/jondoconsole.html online help]
 
+
== JonDoConsole for Windows, Linux and MaxOS ==
+
 
+
JonDoConsole is a Java application. You have to install a Java Runtime Environment (JRE) before you start using it. Because no GUI functions are used, you can install a headless version of the JRE:
+
 
+
* For Windows you may download Java from the website [http://www.java.com http://www.java.sun.com].
+
* For Linux/UNIX, you may install the package ''sun-java6-jre'' or ''openjdk-6-jre-headless'' with the package manager of your distribution.
+
* MacOS contains a Java Runtime Environment by default.
+
 
+
==Download==
+
 
+
'''JonDoDaemon for Debian/Ubuntu (DEB)''' and '''JonDoConsole.jar''': [https://anonymous-proxy-servers.net/en/jondoconsole.html jondoconsole.html]
+
 
+
==Usage==
+
 
+
==== JonDoConsole command line options ====
+
You can start the console client JonDoConsole at the command line. Add the full path if required.
+
 
+
<code>> java -jar JonDoConsole.jar [Options]
+
JonDoConsole> </code>
+
 
+
Currently implemented options are the following ones:
+
 
+
*'''''-c,--configuration <arg>''''': A custom file path to the configuration file. Its default name is '.jondoconsole.conf'.
+
*'''''-s,--sqliteCache <arg>''''': Sets an arbitrary file path as sqlite cache database for InfoService data. 'cache.sqlite' is recommended as file name. This will speed up startup but will take some mega bytes of disk space.
+
*'''''-t,--daemonAuthentication''''': Sets the authentication password for the daemon. It will be stored in the configuration. The daemon won't start without a password in its configuration. Stop the daemon before resetting the password!
+
*'''''-d,--daemon <arg>''''': Start as daemon server process at [host]{:port}. Default host is localhost. You may access the daemon via telnet or using the built-in client interface, option -i,--clientInterface (recommended).
+
*'''''-i,--clientInterface <arg>''''': Starts as client interface and try to connect to a daemon running at [host]{:port}. Default host is localhost.
+
*'''''-defaultService <arg>''''': {hostname}{:port} of the default service. This is for testing purposes only (no certificate verification is done for this service in the automatically chosen filter!).
+
*'''''-f,--forwarder <[port]>''''': Activates the anti-censorship forwarding server to help other people connecting to JonDonym. You may enter a [port] (if you don't, a random port is chosen) on which the server should listen. If you do not have root/admin privileges, you might need to choose a port higher than 1024.
+
*'''''-h,--help''''': Prints this message.
+
*'''''-l,--logFile <arg>''''': The path to a file where the log messages are stored. Only the log level ALERT will then be visible on the console. 'jondoconsole.log' is recommended as file name.
+
*'''''-m,--multiple''''': Allow multiple instances of JonDoConsole.
+
*'''''-n,--networkInterface <arg>''''': The network interface [hostname][:port] where the local JonDo proxy should listen on. You may enter either host name or port, or both. Enter ALL_HOSTS for the host name if you want to listen on all interfaces. Default is localhost:4001.
+
*'''''-noConfiguration''''': Do not use any configuration. Warning: Accounts will not be stored. Use this for testing purposes only!
+
*'''''-noJonDonymProxy''''': Does not start the JonDonym proxy. Only usable together with the -f,--forwarder option.
+
*'''''-p,--proxy <arg>''''': {hostname}{:port}[s] of the compulsory proxy that you have to use. Add 's' to the port for specifying the proxy as SOCKS. Default is HTTP.
+
*'''''-a,--proxyAuthentication <arg>''''': {username}[:password] of the compulsory proxy if any is defined. You may leave out the password if you would like to enter it in a hidden console on startup.         
+
*'''''--defaultNoInfoServiceUpdate''''': When creating a new configuration, do not automatically update InfoService data by default. This option has no effect if a configuration already exists.
+
*'''''--defaultNoAccountUpdate''''': When creating a new configuration, do not automatically update account data by default. This option has no effect if a configuration already exists.
+
*'''''-v,--version''''': Prints the program version.   
+
 
+
During the first start a configuration file will be created: $HOME/.jondoconsole.conf.
+
 
+
==== JonDoConsole commands ====
+
To get all the possible commands at the JonDoConsole command prompt, type ''help'' just after you started the client successfully and any time later. You will have the following options to control the behavior from within the client:
+
 
+
*'''''help''''': Shows all the commands you may use to configure JonDoConsole after you have started it.
+
*'''''exit''''' or '''''quit''''': Closes JonDoConsole and saves the configuration.
+
*'''''status''''': Gives you some details about the current cascade and the balance you have (if you surfing via a premium cascade).
+
*'''''info''''': Prints detailed information about available services and their operators.
+
*'''''choose''''': Offers you some cascades to choose; if you have a valid account the premium cascades otherwise the free ones.
+
*'''''switch''''': Typing this you may switch to another cascade.
+
*'''''start''''': Connects to a mix cascade.
+
*'''''stop''''': Disconnects from a mix cascade.
+
*'''''reload''''': Use this command to obtain the latest InfoService information.
+
*'''''reloadPay''''': Use this command to update the balances of your JonDonym accounts.
+
*'''''autoReload''''': Enable/disable automatic updates of InfoService information.
+
*'''''autoReloadPay''''': Enable/disable automatic updates of JonDonym account balances.
+
*'''''blacklist''''': Allows you to disable/enable the usage of one or more mixes.
+
*'''''http''''': Enables/disables the JonDo HTTP-Filter.
+
*'''''autoswitch''''': Enables/disables the option to let JonDoConsole switch between mix cascades automatically.
+
*'''''pi''''': Offers you different payment instances to choose.
+
*'''''coupon''''': Allows you to enter a coupon code and thus use the premium services.
+
*'''''import''''': You may import an account.
+
*'''''export''''': You may export an account.
+
*'''''delete''''': You may delete an account.
+
*'''''password''''': You may alter the password that is securing your account(s).
+
*'''''requestMonthlyBytes''''': You may request additional bytes for a monthly volume account by using bytes of future months.
+
*'''''paymentProxy''''': You may choose how you want to connect to payment instances (directly; only directly if it is not possible via mix cascades; always use mix cascades).
+
*'''''infoserviceProxy''''': You may choose how you want to connect to InfoServices (directly; only directly if it is not possible via mix cascades; always use mix cascades).
+
*'''''logdetail''''': You may determine how detailed your log messages will be.
+
*'''''loglevel''''': You may determine which kind of problems (if problems at all) will be reported.
+
*'''''logtype''''': You may determine which subsystems' messages you want to receive.
+
 
+
You do not have to remember all those explanations given above. If you have started JonDoConsole just type '''''help <command>''''' to get more information about a specific command.
+
 
+
==== Using premium services with JonDoConsole ====
+
 
+
For using premium services, you have to enter a coupon-code or import an account created with the GUI client. To create a new account, use JonDo, the GUI client, export the account and afterwards import it into JonDoConsole. The account creation system of JonDo will not be ported into JonDoConsole, it's rather going to be changed anyway.
+
 
+
If a premium account is available, JonDoConsole uses only premium cascades by default. You can modify the list of cascades used by JonDoConsole editing the blacklist with the command ''blacklist''.
+
 
+
==== Remote control ====
+
You can start JonDoConsole as a daemon in background. It is possible to control the running daemon using the controler interface. The remote control interface is a simple Telnet interface.
+
 
+
At first you have to set a password for the remote control interface using the option ''-t''.
+
 
+
<code>> java -jar JonDoConsole.jar -t
+
Please enter a password to protect the daemon from hacking or enter 'break' to cancel.
+
Use at least 10 characters: letters, numbers, upper and lower case. Special characters are allowed.
+
JonDoConsole#password>
+
Please type your daemon password a second time.
+
JonDoConsole#password>
+
Exiting...</code>
+
 
+
Afterwards you may run JonDoConsole as a daemon in background using the option ''"-d [host]{:port}"''.
+
<code>> java -jar JonDoConsole.jar -d localhost:4004</code>
+
 
+
You may use the option ''" -i [host]{:port}"'' to connect to a running daemon.
+
<code>> java -jar JonDoConsole.jar -i localhost:4004
+
Please enter the daemon password or type 'break' to cancel.
+
JonDoConsole#password> *******
+
You are logged in...
+
JonDoConsole></code>
+
 
+
But you can use a simple telnet client too:
+
 
+
<code>$ telnet localhost 4004
+
Connected to localhost.
+
Escape character is '^]'.
+
Type 'login' to log into JonDoConsole.
+
.
+
JonDoConsole> login
+
Received login request! Please wait some seconds for the authentication request...
+
Please enter the daemon password or type 'break' to cancel.
+
JonDoConsole#password> <passwort>
+
You are logged in...
+
...
+
JonDoConsole> status
+
State:CONNECTED, AutoSwitch:ON, ServiceFilter:'Default Filter', HTTPFilter:ON
+
...
+
JonDoConsole> exit</code>
+

Latest revision as of 16:19, 13 May 2013

moved to online help

Personal tools