diff --git a/src/site/xdoc/setup.xml b/src/site/xdoc/setup.xml index 67229761b..ebd7d028c 100644 --- a/src/site/xdoc/setup.xml +++ b/src/site/xdoc/setup.xml @@ -1,7 +1,7 @@ - Installation of the Fess + Fess Installation Shinsuke Sugaya @@ -10,73 +10,74 @@

This page is generated by Machine Translation from Japanese.

-

Any operating system, it is possible to Fess any Java runtime environment. Work environment is as follows.

+

Fess can run on any operating system with Java runtime environment. Requirement detail is as follows.

-
-

If Java is not installed please install Java by following these steps.

- -

With JavaScript enabled for OracleJava SE Downloads pageTo access the.

-

* Different versions and follow these steps butJava 7u25Install (recommended). [2014 / 3 / 13]

-

Click the 'Download JDK' JavaSE7. (JavaScript is disabled and download is valid and must)

+
+

If Java is not installed please following these steps below to install Java.

+ +

Browsers with Javascript enable are required to access Oracle'sJava SE Downloads page.

+

* We recommend Java 7u25. [2014 / 3 / 13]

+

Click the 'Download JDK' tab. (Without Javascript enable, download will become invalid)

Access
-

Whether JavaScript is enabled you can check below. (If the Internet Explorer 9)

+

To check whether JavaScript is enabled, you can as follows. (In case of Internet Explorer 9)

  1. Click [tools] on the menu bar.
    2. -
  2. Click the [Internet Options].
    3. -
  3. Click the Security tab.
    4. -
  4. Click the [custom level].
    5. -
  5. Scrawl to the [scripts] section is displayed.
    6. -
  6. In the Active Scripting section radio button to enable a check to confirm.
    7. -
  7. Turn on and off if it is, click OK.
    8. +
  8. Click [Internet Options].
    9. +
  9. Click Security tab.
    10. +
  10. Click [custom level].
    11. +
  11. Scrawl to [scripts] section.
    12. +
  12. In the Active Scripting section, confirm whether button is checked.
    13. +
  13. Turn on to enable Javascript and off to disable Javascript. Then click "OK" button to save change.
 -

When you accept the license, read 'The Oracle Binary Code License Agreement for Java SE' turn to Accept License Agreement check.

+

Java SE's license detail is as 'The Oracle Binary Code License Agreement for Java SE'. Check "Accept License Agreement" to agree Java SE's license.

License - -

Do the JDK download according to the OS you install. Windwos 64-bit if you select Windows 86 x 64 Windows, for Windows 32-bit (Windows 64-bit version of the example is below).

+ +

Different Operating System requires different version of Java SE. In case of Windows 64-bit, you must select Windowsx64 version. In case of Windows 32-bit, you must select Windowx86 version. Java SE's Windowx64 version is used in the following example.

-

PCs are used whether the you can check below. (For Windows 7)

+

You can check whether your window is 32 bits or 64 bits by following these steps below. (In case of Windows 7)

    -
  1. In Control Panel-> system and security → [System] appears to the type of system.
    2. +
  2. In Control Panel, select "system and security"
    3. +
  3. [System] appears to the type of system.
Download -

(XX is the downloaded update release version) run the JDK Installer (jdk-7uXX-windows-x64.exe). The following is an example Windows 64-bit Edition.

+

After downloading, JDK Installer file (jdk-7uXX-windows-x64.exe or jdk-7uXX-windows-x86.exe) is archived. xx is Java SE's version. The following image shows icon image of Java SE 7 version 7's JDK Installer.

Run -

Depending on settings in Windows, see allow changes to this computer to the following program? "That may receive dialog. If so, please click the [Yes] button.

+

Double click JDK Installer to start installing Java SE. Depending on Windows settings, there is case where "Accept dialog" is appeared. In that case, click "Yes" to continue installation

 -

The installer will launch. Press the [next] button.

+

The installer shows first dialog. Press [next] button to continue.

Run -

You can change the destination folder. Left at default without problem, press the [next] button.

+

You can change the installation's destination folder. We recommend using default options. Press [next] button to continue.

Directory -

Start installing the JDK, so wait.

+

JDK installer starts installing. Wait until installation finishs.

JDK installation -

Run the JRE installation after installing the JDK, JRE installed on your PC. In the JDK as well to change the destination folder is possible, but basically the same JDK folder no problem. Press the [next] button.

+

After JDK installation is finished. JRE installation will be started automatically. JRE will be installed in the same folder as JDK's installed folder. We recommend using the default options. Press [next] button to continue.

JRE -

JRE installation starts, so wait a while.

+

JRE installer starts installing. Wait until installation finishs.

JRE installation -

The installation complete message appears. Press the [close] button.

+

After the installation finishes, following dialog will appear. Press [close] button to finish installation.

JRE installation

Installation is complete.

-

The components is the following two. In the following you can check. (For Windows 7)

+

Installed components (JDK and JRE) can be checked by using following step. (In case of Windows 7)

    -
  1. [Control Panel] → [programs] → [programs and features] listed will be. +
  2. [Control Panel] → [programs] → [programs and features]. Two new installed components appear inside installed components' list.
    • Java SE Development Kit 7 Update XX (64-bit)
    • Java (TM) Update 7 XX (64-bit)
      • @@ -86,101 +87,101 @@
-

This is the setting information and environment variables passed to the program. In order to run the JDK command at the command prompt after the Java installation, setting environment variables is required.

-

Windows 7 sets the following. Select the control panel → system and security → [System] → advanced system settings → environment variables.

+

Fess requires Windows command prompt with runable JDK command. These steps below set up environtment variables to use JDK command from command prompt

+

In case of Windows 7, do as following steps. Select "Control panel" → "System and security" → "System" → "Advanced system settings" → "Environment variables".

Control Panel -

Click system and security.

+

Click "System and security".

System and security -

Click the 'system'.

+

Click "System".

System -

Click the 'advanced settings'.

+

Click "Advanced settings".

Advanced system settings -

Click environment variables.

+

Click "Environment variables".

Environment variables -

New system environment variables button at the bottom of screen.

+

Click "New system environment variables" button which is located at bottom of setting dialpg

-

Enter "JAVA_HOME" variable name.

+

Variable name: "JAVA_HOME".

+

Variable value: installed JDK location.

-

Describes the directory where you installed the JDK to the variable value.

-

Open the C:\Program Files zone\scripting in the Explorer, ' jdk... ' that describes its addresses, looking for a folder.

-

For example if you have installed the jdk version 1.7.0_XX will be C:\Program Files \Java\jdk1.7.0_XX. (Contains the portion of the XX version)

-

Description and then press 'OK'.

-

Locate the row from a list of system environment variables, see variables 'Path'.

+

To check JDK's installed folder do as following steps.

+

Go to C:\Program Files zone\scripting in the Explorer. Then searching for folder with keywor: ' jdk... '.

+

For example if you installed JDK version 1.7.0_XX, installed folder will be C:\Program Files \Java\jdk1.7.0_XX. (XX is JDK version number

+

Parse folder location and then press 'OK' to close dialog.

+

Scroll down list of system environment variables and select variables 'Path'.

-

And then push open the Edit button, the row at the end of the variable value "; %JAVA_HOME%\bin ' that adds a string, click the 'OK'.

+

Click Edit button. Then add "; %JAVA_HOME%\bin ' to the end of Path value. Click the 'OK' to close dialog.
-
- -

http://sourceforge.jp/projects/Fess/releases/ From the download the latest Fess package.

-

Release file list of the destination URL and then 'fess-server-9.x.y.zip'.

+
+ +

http://sourceforge.jp/projects/Fess/releases/ Download latest Fess package.

+

Expand file list of the destination URL, then download 'fess-server-9.x.y.zip'.

 -

Unzip the zip file you downloaded. If the Windows environment expand the zip decompression tool, in.

+

Unzip downloaded zip file. In case of Windows environment, we recommend using 7-zip. In case of Unix, we recommend using unzip command.

-

If you installed in the UNIX environment, in the bin added the performing rights to a script.

+

In case of Unix environment, start up script "startup.sh" need to be executable. Execute following command to add executable access permission to script files.

-

Open the unzipped folder by double-clicking.

+

Double-click to open un-zipped folder.

-

Open the bin folder by double-clicking.

+

Double-click to open bin folder.

-

Double-click the startup.bat file in the bin folder, Fess up.

+

In case of Windows environment, double-click the startup.bat file in the bin folder to start Fess.

-

Run the startup.sh for UNIX environments.

+

In case of Unix environments, run startup.sh to start Fess.

-

Will start the command prompt appears. In the last sentence "Server startup... ' is Setup complete appears.

+

After starting Fess, at the end of console message "Server startup... ' willbe appeared. If this message is not appeared, check Java environment's validity.
-

access to / http://localhost:8080/Fess ensures startup.

-

Management UI is / http://localhost:8080/fess/admin. Default Administrator account user name / password is admin/admin. Administrator account is managed by the application server. In the management UI of the Fess, authenticate with the application server in fess role determine as an administrator.

+

Go to http://localhost:8080/Fess to check whether Fess started normally.

+

Fess' management UI is located at / http://localhost:8080/fess/admin. Default Administrator account's user name / password is admin/admin. Administrator account is managed by the application server. Administrators of Fess' management UI are users whose rolls are certificated by applicatoion server .

-

stop the Fess, double-click shutdown.bat file in the bin folder.

+

To stop Fess, in case of Windows environment double-click shutdown.bat file in the bin folder.

-

Run the shutdown.sh for UNIX environments.

+

To stop Fess, in case of Unix environment run the shutdown.sh.

 - -

Administrator account is managed by the application server. Fess Server standard available Tomcat, as well as to the user changing the Tomcat. Modify the password for the admin account of the conf/tomcat-user.xml if you want to change.

+ +

Administrator account is managed by the application server. Fess' standard server is Tomcat. So to change administrator password, you need to modify conf/tomcat-user.xml.

]]> - +

-To access the Solr into Fess server is password becomes necessary. -Change the default passwords in production, etc.

+Password is required to access Solr of Fess. +Change the default passwords in production.

-How to change the password, you must first change the password attribute of the conf/tomcat-user.xml solradmin. +To change Solr password, first you must change solradmin password attribute of conf/tomcat-user.xml.

]]>

-Modifies the following three files webapps/fess/WEB-INF/classes/solrlib.dicon, fess_suggest.dicon and solr/core1/conf/solrconfig.xml. -Write what you specified in tomcat-user.xml to the following password.

+Modifies the following three files webapps/fess/WEB-INF/classes/solrlib.dicon, fess_suggest.dicon and solr/core1/conf/solrconfig.xml. These there files' user / password are as same as user / password which are specified in tomcat-user.xml.

-modify the following areas of the solrlib.dicon. +In case of solrlib.dicon, detail is as follows.

@@ -189,7 +190,7 @@ modify the following areas of the solrlib.dicon. ]]>

-fess_suggest.dicon is the following. +In case of fess_suggest.dicon, detail is as follows.

@@ -198,7 +199,7 @@ fess_suggest.dicon is the following. ]]>

-SOLR/core1/conf/solrconfig.XML is the following. +In case of SOLR/core1/conf/solrconfig.XML, detail is as follows.