메뉴얼: 환경 설정 스크립트

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Config script and the translation is 41% complete.
MediaWiki-2020-icon.svg 매뉴얼:설치 가이드 미디어위키에 대해
Help-browser.svg 특징 설치 조건
Preferences-system.svg 다운로드 설치 설정

The 1.13alpha Config script

Once you have uploaded/installed MediaWiki on your web server, the first thing you need to do is complete the basic setup by running the supplied configuration script. This script allows you to tell MediaWiki the information it needs in order to get the wiki up and running.

미디어위키 설정 폼 열기

In the following examples, it is assumed that your website is located at http://www.example.com/ which is physically located on your server at /home/example/web. You will need to adjust the examples to use the appropriate locations for your situation.

  1. Use your web browser to browse to the main wiki page. This is index.php inside the web-accessible folder that you installed MediaWiki into, and is typically /w/index.php (e.g. http://www.example.com/w/index.php, assuming you installed MediaWiki to /home/example/web/w). (You should not have used /wiki/ if you want to use it as a Short URL).
  1. You will see the version of MediaWiki installed and a link to "Please set up the wiki first." Click on the link to begin the configuration script. For reference (in case you want to go there directly), this is located in the wiki's mw-config directory (so using the example above you would go to http://www.example.com/w/mw-config/index.php).
    • Installer directory was called config before version 1.17.
  1. If the script spots any configuration errors then it will not allow you to continue. See below for details about the error messages you might encounter, and what to do if you do.
  1. If all the tests pass, you will be presented with a form to fill in the information that MediaWiki now requires.

환경 설정 스크립트 사용하기

Follow the instructions on the form to fill in the required entries (refer to the following table if you're uncertain what to enter) and after that click on the "Install MediaWiki!" button. The script will now populate the database and write a configuration file.

After the setup script has finished running successfully, a file called LocalSettings.php is created in the mw-config (config for older versions) directory. This file contains all the information needed by MediaWiki to run. Since it stores the specified database user's password in plain text, it is strongly suggested that you create a wiki specific database account (i.e. not root). (see Database username in the table below)

  1. Move this file to the main wiki directory (if you installed MediaWiki to /home/example/web/w, move it there).
  1. Set stringent permissions on the LocalSettings.php file.
    • Set chmod 600 and chown <webserver owner> (Owner read and write, no other permissions).

Once you have done the above, your wiki should be ready to use. Browse to the address you installed it to (in our example http://www.example.com/w/index.php) and start editing!

Field 설명
위키 이름 The name of the wiki. This will appear as the main title for meta pages, as well as throughout the interface itself. It cannot contain the term "MediaWiki' or the "#" symbol. A short word without punctuation is preferred.
연락 이메일 This is the main administrative email address for the wiki, and usually appears as "admin@localhost". It will be displayed on some error messages and on all email notifications.
언어 This drop down menu sets the language for the wiki interface. Be aware that not all localizations are complete. Unicode (UTF-8) is the default character set for all choices.
저작권과 라이선스 세 가지 옵션:
  • 라이선스 없음 (공개 위키에 추천하지 않음)
  • GNU 자유 문서 사용 허가서
  • 크리에이티브 커먼즈 라이선스

이 중, 크리에이티브 커먼즈 라이선스 - 동일 조건 변경 허락 만이 위키백과와 양방향 호환 가능하며, 이 외에는 단방향으로만 가능합니다.

관리자 사용자 이름과 비밀번호 사용자명과 비밀번호를 만드세요. 관리자는 사용자들이 편집하는 것을 막거나 위키를 유지하는 행위를 할 수 있습니다.
Object Caching 두 가지 옵션:

캐싱하지 않음


Memcached will provide a performance boost. Provide the server addresses and ports in field provided, separated by a comma. MediaWiki will also detect Turck MMCache, eAccelerator, and APC. However, these programs are not recommended if the wiki will be running on multiple application servers.

데이터베이스 호스트 데이터베이스가 있는 호스트입니다. 데이터베이스가 웹서버와 같은 호스트에 있다면, "localhost"를 사용하세요.
If running MySQL using a different socket file (e.g. MySQL on localhost, using --socket=/tmp/mysocketfile), set the database host to:"localhost:/tmp/mysocketfile". Sometimes sockets are called ports. If you have a port number for your database host, follow the same syntax:"my.host.url:port".
데이터베이스 이름 위키에 사용할 MySQL이나 Postgres의 데이터베이스 이름입니다.
If you have superuser account of DB Server and will be using it on this form page then enter the name of the DB that you would like to be created for your wiki.

만약 Yahoo에서 호스팅된 사이트에 설치한다면, 데이터베이스 이름을 "mysql"로 설정해야 합니다.
데이터베이스 사용자 이름 위키 데이터베이스에 접근할 사용자명.
If you have superuser account of DB Server and will be using it on this form page then simply fill the db username that you would like to be created for your wiki. Otherwise, create the db user and ensure that the user has SELECT, INSERT, UPDATE, and DELETE permissions on the MediaWiki database. For installation the user must also have CREATE and INDEX permissions. It is strongly suggested that you do not use a superuser account since the user password is stored in plain text.
데이터베이스 비밀번호 위키 데이터베이스에 접근할 사용자 비밀번호.
If you have superuser account of DB Server and will be using it on this form page then just fill the db username that would like to be set on the database for your wiki. Alternately, supply a user password for the database that is already created to serve your wiki.
관리자 계정 / 관리자 비밀번호 The root database user and password, if you have it. If you don't have this password, leave it as it is. If you have the password, you may be able to skip the above stages of creating the database and user manually since this form will be able to do this for you.
데이터베이스 테이블 접두사 (MySQL only) An optional prefix to prepend to the name of every table that will be created within your wiki database. If you plan to have several wikis, you might want use a prefix such as "w1_", so that all the tables associated with your first wiki will have "w1_" prepended. This allows you to install multiple wikis using the same databases by making the name unique. For example the generic name "archive" becomes "w1_archive", so that it is possible to add another MediaWiki installation without overwriting the tables.
데이터베이스 포트 번호 (Postgres만) Postgres가 설치된 포트 번호입니다. 대부분의 경우에 작동할 기본 값은 5432입니다.
Schema for mediawiki / Schema for tsearch2 (Postgres only) The name of the schema to put your wiki inside of. The default value of "mediawiki" should be fine for most purposes. To use more than one wiki on the same database, both this schemaname and the username should be changed, preferably to the same name to lessen confusion. The default value of "public" for tsearch2 should almost never have to be changed.
데이터베이스 문자 인코딩 3가지 옵션:

하위호환 UTF-8: 보통 이 옵션은 미디어위키 소프트웨어를 업그레이드할 때 사용합니다. 추가적으로, 이 옵션은 좀 더 오래되고 안정적인 문자 인코딩을 사용하려는 사용자에게 좋은 옵션입니다.

실험적인 MySQL 4.1/5.0 UTF-8: 새 버전의 UTF-8 버전입니다, 사용자가 MySQL 4.1과 5.0에서 유니코드를 사용할 수 있게 해줍니다. 이 버전은 알아 보기 쉽지만, 더 많은 용량을 차지합니다.

실험적인 MySQL 4.1/5.0 바이너리: 이 버전은 유니코드지만, 알아 보기가 어렵습니다.

위 두 실험적인 문자 인코딩은 잘 문서화되있지 않으며, 미디어위키 설정에 문제를 일으킬 수 있습니다.

설치 오류

When you run the config script it makes various checks of your system, and tells you if there are any problems.

  • After installation if your server is redirecting to a non-existant url try and go back and hit stop before the page redirects and grab Localsettings.php.

Add the following line after $wgSitename: $wgServer = http://your.servername.com;

  • Parse error: parse error, expecting `T_STRING' in [...]\wiki\includes\Namespace.php on line 52
  • Make sure you have the appropriate version of PHP for the version of MediaWiki you are installing.
  • Attempting to connect to database server as wikiuser...failed with error [2004] Can't create TCP/IP socket (10106).
  • Often found in the internet that you should turn on named pipes in the MySQL configuration, but this did not help me (this appeared under Win2000 with MySQL 5.0)
  • "Warning: main() [function.main]: open_basedir restriction in effect. File(/convertLinks.inc) is not within the allowed path(s):"
  • Apparently the include path sometimes needs to be set. Put [ php_value include_path '/var/www/vhosts/yourhost.com/httpdocs/pathtowiki' ] in your .htaccess file.
  • (MediaWiki 1.10.1&1.11.2) After 'Running the script' 1. The text is: 'Setup has completed, your wiki is configured.' Selecting 'your wiki' opens a new screen with the address: http://localhost:8080/mediawiki/index.php and the error '404: The page cannot be found'.
  • Path to php5isapi.dll is incorrect. In IIS manager go to web sites right click on web site go to properties then go to home directory tab and then click on configure find php in the list and then click edit and fix the path (C:\progra~1\php\php5is~1) Should be ("C:\program files\php\php5isapi.dll")
  • Warning: getrusage() is not supported in this PHP build
  • We do function_exists checks for getrusage, so if you see this error message, probably means you should file a bug.
  • Parse error: syntax error, unexpected T_LNUMBER, expecting ';' in .../wiki/includes/GlobalFunctions.php on line 75
  • Creating tables...Query "CREATE TABLE `user` ( user_id int" ..."You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'TYPE=InnoDB' at line 20 (localhost)".
  • In the latest version of MySQL, TYPE= syntax has been changed to ENGINE=. Modify the entire tables.sql script.
  • Warning: domdocument::domdocument() expects at least 1 parameter, 0 given in C:\xampp\htdocs\w\includes\Preprocessor_DOM.php on line 566
    Fatal error: Call to undefined method domdocument::loadXML() in C:\xampp\htdocs\w\includes\Preprocessor_DOM.php on line 568
  • Set $wgParserConf ['preprocessorClass'] = 'Preprocessor_Hash'; in LocalSettings.php.
  • Creating tables... using MySQL 4 table defs...Query "CREATE TABLE `v_job` ( job_id int(9) unsigned NOT NULL auto_increment, job_cmd varchar(255) NOT NULL default , job_namespace int NOT NULL, job_title varchar(255) binary NOT NULL, job_params blob NOT NULL default , PRIMARY KEY job_id (job_id), KEY (job_cmd, job_namespace, job_title) ) TYPE=InnoDB " failed with error code "Specified key was too long; max key length is 1024 bytes (h41mysql79.secureserver.net)
  • Warning: ini_set() has been disabled for security reasons in .../includes/AutoLoader.php on line 5
  • If there is MySQL 'DB connection refused' error, it is possible the default port in Apache's PHP file ('php.ini') is incorrect.
  • Your system has a combination of PHP and libxml2 versions which is buggy and can cause hidden data corruption in MediaWiki and other web apps. Upgrade to PHP 5.2.9 or later and libxml2 2.7.3 or later! ABORTING (http://bugs.php.net/bug.php?id=45996 for details).
    Well as the error says, either upgrade one, or downgrade one.

[TODO: This section should list all potential error messages and how to fix them. Or perhaps they should be on a separate page (depends how many there are, I guess... --HappyDog 22:05, 29 August 2007 (UTC)]

환경 설정 에러

[TODO: This section should list all errors that can occur when submitting the form, and how to handle them. Or perhaps on a separate page, if necessary]

  • What about the $wgSecretKey e.g.

Warning: $wgSecretKey key is insecure, generated with mt_rand(). Consider changing it manually.

a) what is this and b) what is the solution ?

Answer: It means your system doesn't support /dev/urandom so the key was generated with mt_rand(). You can manually edit the wgProxyKey field in LocalSettings.php.

  • Specified key was too long

Advanced configuration

같이 보기