Difference between revisions of "Server Setup Help"

Latest revision as of 15:55, 9 February 2019

Java

Java Home: select the JRE/JDK Java Home location (e.g. /usr/lib/jvm/java-11-openjdk-amd64).

iDempiere

iDempiere Home: is the base directory where the distribution files are located (e.g. /opt/idempiere-server).

KeyStore Password: iDempiere requires a SSL certificate. It automatically creates a certificate in the key store $IDEMPIERE_HOME/jettyhome/etc/keystore with the keystore password entered.

The self certified certificate created has the alias idempiere and uses the same password as the keystore.

You can replace the certificate used with the Java "keytool" (see Java tool documentation).

Application Server

Application Server: is the name, URL or IP of your server PC. The Application Server defaults to 0.0.0.0, normally this default is OK

Web Port: The port where jetty attends http requests, defaults to 8080 Must be an unused port, please note some oracle installations can use this port and you would need to use a different one.

SSL: The port where jetty attends https requests, defaults to 8443

Please keep in mind that under Linux/Unix ports under 1000 need root privileges. It is recommended to use apache/nginx as a front end for ports 80 and 443, and configure it as a proxy for the iDempiere server.

Database Server

DB Already Exists: This flag is to indicate if the database already exists (it was imported previously), or is intended to be created later using the iDempiere tools.

Database Server: The Database Server defaults to localhost. If your database is located in a different server, then it must point to where the database is located.

Database Type: select the database you have installed (Oracle or PostgreSQL).

Database Name:

PosgreSQL: PostgreSQL database name
Oracle: SID/Service name - Oracle 11g/12c normally uses orcl, and OracleXE defaults to xe

Database Port: select the port for connect to database.(e.g. Oracle use 1521 as standard port, PostgreSQL 5432, etc.)

DB Admin Password:

Oracle: Password for the system user.
PostgreSQL: Password for the postgres user.

Database User: The application database user name, default is adempiere. Note in Oracle this is the schema name, while in PostgreSQL usually you can just use the default adempiere.

Database Password: The application database password, default is adempiere.

Mail Server

The EMail connection here is used as the default. You maintain the EMail connection in the Application on a Client basis.

It is not required that at this point.

If you don't want to enter or don't have an SMTP server, just leave the defaults (server localhost and the other fields empty).

If the server exists, but does not provide POP3, SMTP or IMAP, the setup finishes successfully. If the server is invalid, then fails.

@@ Line 1: / Line 1: @@
-[[Category:TBD]]
-[[Category:OnLineHelp]]
 [[Category:Installation]]
-<big>'''WARNING: Outdated - pending to be documented properly'''
-</big>
 __NOEDITSECTION__
@@ Line 15: / Line 10: @@
 ==Java==
-'''Java Home''': select the SDK Java Home location (e.g. C:\jdk1.5.0_05).
+'''Java Home''': select the JRE/JDK Java Home location (e.g. /usr/lib/jvm/java-11-openjdk-amd64).
-'''Java VM''': the Java Virtuel Engine Vendor (Default= Sun).
-Please, note that ADempiere requires the Java System Development Kit (JDK), not just the runtime environment (JRE).
-==Adempiere==
+==iDempiere==
-'''ADempiere Home''': is the base directory where the distribution files are located (e.g. C:\Adempiere).
+'''iDempiere Home''': is the base directory where the distribution files are located (e.g. /opt/idempiere-server).
-'''KeyStore Password''': ADempiere requires a SSL certificate. It automatically creates a certificate in the key store
+'''KeyStore Password''': iDempiere requires a SSL certificate. It automatically creates a certificate in the key store
-''$ADEMPIERE_HOME/keystore/myKeystore'' with the keystore password entered.
+''$IDEMPIERE_HOME/jettyhome/etc/keystore'' with the keystore password entered.
-The self certified certificate created has the alias ''adempiere'' and uses the same password as the keystore.
+The self certified certificate created has the alias ''idempiere'' and uses the same password as the keystore.
 You can replace the certificate used with the Java "keytool" (see Java tool documentation).
@@ Line 34: / Line 25: @@
 ==Application Server==
-'''Application Server''':  is the name, URL or IP of your server PC (Don't use localhost). The Application Server defaults to the server you started the program. Avoid using IP addresses - use the DNS name of the server.
+'''Application Server''':  is the name, URL or IP of your server PC.  The Application Server defaults to 0.0.0.0, normally this default is OK
-Please keep in mind that under Linux/Unix ports under 1000 need root privileges. The default ports are:
+'''Web Port''':  The port where jetty attends http requests, defaults to 8080
-* 80  for http connections and
+Must be an unused port, please note some oracle installations can use this port and you would need to use a different one.
-* 443 for SSL connections.
-If you use Apache as a front end, you could use port 8080 and 8443.
+'''SSL''':  The port where jetty attends https requests, defaults to 8443
-Your options are to use another Web port, e.g. 8888. If you are using Oracle and depending of your setup, port 8080 might be used.
+Please keep in mind that under Linux/Unix ports under 1000 need root privileges.
+It is recommended to use apache/nginx as a front end for ports 80 and 443, and configure it as a proxy for the iDempiere server.
-JNP (RMI): Default ports are 1099 (1098).
+==Database Server==
-==Database Server==
+'''DB Already Exists''': This flag is to indicate if the database already exists (it was imported previously), or is intended to be created later using the iDempiere tools.
-'''Database Server''': The Database Server defaults to the server you started the program. Avoid using IP addresses - use the DNS name of the server. Don't use localhost unless the server is running on the same machine as the client software.
+'''Database Server''': The Database Server defaults to localhost.  If your database is located in a different server, then it must point to where the database is located.
-For Oracle, the Service names are discovered. You an overwrite the entries, if they are not correct.
+'''Database Type''': select the database you have installed (Oracle or PostgreSQL).
 '''Database Name''':
 * PosgreSQL: PostgreSQL database name
-* Oracle: SID/Service name. Oracle 10g/11g default: orcl, OracleXE default: xe
+* Oracle: SID/Service name - Oracle 11g/12c normally uses orcl, and OracleXE defaults to xe
-'''Database Type''': select the database you have installed (i.e. Oracle 10g, Oracle 10gXE, PostgreSQL).
-'''Database Port''': select the port for connect to database.(i.e. Oracle use 1521 as standard port, PostgreSQL 5432, etc.)
+'''Database Port''': select the port for connect to database.(e.g. Oracle use 1521 as standard port, PostgreSQL 5432, etc.)
-'''System Password:
+'''DB Admin Password:
 * Oracle: Password for the system user.
 * PostgreSQL: Password for the postgres user.
 '''Database User''': The application database user name, default is ''adempiere''.
+Note in Oracle this is the schema name, while in PostgreSQL usually you can just use the default adempiere.
 '''Database Password''': The application database password, default is ''adempiere''.
@@ Line 72: / Line 62: @@
 The EMail connection here is used as the default. You maintain the EMail connection in the Application on a Client basis.
-It is not required that at this point, the program can read your emails. But, you need an IMAP server for Request processing.
+It is not required that at this point.
-If you don't want to enter or don't have a SMTP server, just enter a valid server. If the server exists, but does not provide POP3, SMTP or IMAP, the setup finishes successfully. If the server is invalid, then fails.
+If you don't want to enter or don't have an SMTP server, just leave the defaults (server localhost and the other fields empty).
-== Common Issues ==
+If the server exists, but does not provide POP3, SMTP or IMAP, the setup finishes successfully. If the server is invalid, then fails.
-See [[InstallServer#Other_Common_Issues|'''here''']] for some common problems and how to fix them.