OpenXM/doc/install.oxweave - diff

Return to install.oxweave CVS log

Up to [local] / OpenXM / doc

Diff for /OpenXM/doc/install.oxweave between version 1.31 and 1.44

version 1.31, 2000/04/03 05:59:01

version 1.44, 2001/12/21 00:33:50

Line 1

%% $OpenXM: OpenXM/doc/install.oxweave,v 1.30 2000/03/17 03:22:01 takayama Exp $

%% $OpenXM: OpenXM/doc/install.oxweave,v 1.43 2001/12/20 04:52:07 takayama Exp $

OpenXM/doc/install.oxweave

/*&C

OpenXM URL : http://www.math.kobe-u.ac.jp/OpenXM

http://www.openxm.org

Consult firstly the ERRATA section for your release on this web cite

for troubles.

OpenXM package : Getting started.

This document is for OpenXM version 1.1.3. (Draft)

----------- An instruction for a quick installation from the source code ---

(cd OpenXM/src ; make configure ; make install)

You will get binaries, libraries, and documents under

OpenXM/bin, OpenXM/lib, OpenXM/doc

(cd OpenXM/rc ; make install)

Shell scripts to start "asir", "sm1", ... will be copied to

/usr/local/bin

*********** If you need only asir and kan/(sm1, k0),

(cd OpenXM/src ; make install-kan-ox ; make install-asir-contrib)

You will get only asir (OpenXM version) and kan/sm1.

(cd OpenXM/rc ; make install)

-------------------------------------------------------------------

/*&jp

★ OpenXM GENERIC パッケージの利用方法

この節では, OpenXM package binary distribution のインストール法を説明します.

ソースからインストールする場合は

★ OpenXM パッケージの Make 法

を御覧下さい.

RPM, Debian などのパッケージでインストールする場合は

Web ページの説明どうりにパッケージをインストールするだけで

設定が終了します.

インストールに必要なシステムの仕様については, 動作環境を御覧ください.

/*&eg

***** HOW TO INSTALL OpenXM GENERIC PACKAGE?

In this section, we will explain how to install OpenXM package binary

distribution.

If you build from the source, see the section

* How to make OpenXM package?

If you install openxm by using RPM or Debian package,

install the system following the instruction given on our web page.

As to the required environment, see the section "System Requirement"

/*&jp

Line 123 If you use only OpenXM clients, skip (3) and (3').

Line 153 If you use only OpenXM clients, skip (3) and (3').

/*&jp

(3') bash を利用してる場合, 次の行を ~/.bashrc の最後に加えます.

(3') bash を利用してる場合, 次の行それぞれを ~/.bashrc および ~/.bash_profile

の最後に加えます.

/*&eg

(3') Append the following line to the end of ~/.bashrc when you are

(3') Append the following lines to the end of ~/.bashrc and ~/.bash_profile

using bash as your shell.

respectively when you are using bash as your shell.

/*&C

source /xxx/yyy/OpenXM/rc/dot.bashrc

source /xxx/yyy/OpenXM/rc/dot.bashrc (.bashrc)

source ~/.bashrc (.bash_profile)

/*&jp

Line 151 If you use only OpenXM clients, skip (3) and (3').

Line 184 If you use only OpenXM clients, skip (3) and (3').

//&C

/*&C

//&jp (4) asir の利用には key が必要です.

//&eg (4) You need a key to use asir.

//&C

/*&jp

asir の起動時のメッセージまたは OpenXM/lib/asir/asir_key を

参照して, key を取得して下さい (数秒しかかかりません).

Mail の利用ができて, /var/mail の下にメールを着信できれば,

FAQ

/xxx/yyy/OpenXM/rc/fetch_asir_key

を実行することにより asir_key を自動で設定できます.

FreeBSD の package, Redhat Package manager を利用している

場合は, /usr/local/OpenXM/lib/asir/asir_key がすでに存在して

いる場合, このファイルは保存されます.

/*&jp

Q. OpenXM の asir OpenXM client を icon でスタートするには?

A. 次の行を, .Xdefaults または, xrdb で読み込むファイルに書いておきます.

/*&eg

Please get the key by following the instruction from asir itself or

Q. How to start asir OpenXM clients in the iconic mode?

that in OpenXM/lib/asir/asir_key (it takes only a few seconds

A. Add the following line to .Xdefaults or a file you read by xrdb.

to get the key).

/*&C

If you can get your mails under /var/mail, you can automatically set

ox_xterm*iconic: on

your key by executing

/xxx/yyy/OpenXM/rc/fetch_asir_key

If you install the OpenXM package by the pkg_add of FreeBSD or

the redhat package manager, the old key file

/*&C

/usr/local/OpenXM/lib/asir/asir_key, if exists, is saved.

-------------------------------------------------------------

/*&jp

Line 190 If you use only OpenXM clients, skip (3) and (3').

Line 215 If you use only OpenXM clients, skip (3) and (3').

root になって,

pkg_add openxm-version.tgz

OpenXM は /usr/local/OpenXM にインストールされます.

あとは, 上の (4) へ.

ここで version は OpenXM の version 番号で, たとえば,

2000, 3/20(Mon) 版は 1.1.2

pkg_add に失敗した場合は, /var のサイズを大きくしてやりなおして

みて下さい.

java および linux emulation が実行に必要です.

java が, サーチパスのなかにある必要がありますので,

Line 203 If you use only OpenXM clients, skip (3) and (3').

Line 230 If you use only OpenXM clients, skip (3) and (3').

インストール終了後のメッセージにしたがい, 必要な設定を

おこなって下さい.

jdk は /usr/ports/lang/jdk よりインストールできます.

Linux emulation を有効にするには,

/etc/rc.conf に

linux_enable="YES"

と書き,

/usr/ports/emulators/linux_base を用いて, linux 用の共有ライブラリ等を

インストールしておきます.

(FreeBSD 3.x, 4.x)

/usr/local にインストールしなかった場合は,

(2) を実行して下さい.

Line 216 If you use only OpenXM clients, skip (3) and (3').

Line 253 If you use only OpenXM clients, skip (3) and (3').

Become the super user and type

pkg_add openxm-version.tgz

OpenXM will be installed to /usr/local/OpenXM

Go to (4) above.

Here, version is the version number of OpenXM.

For example, the version number of the OpenXM of May 20 (Mon), 2000

is 1.1.2

If you fail "pkd_add", increase the size of /var

java and linux emulation are required to run OpenXM packages.

Java needs to be in the search path. So, for example, execute pkg_add

Line 227 If you use only OpenXM clients, skip (3) and (3').

Line 265 If you use only OpenXM clients, skip (3) and (3').

set path=(/usr/local/jdk1.1.8 $path)

rehash

Following the message of pkg_add after the installation,

set asir_key and path.

set path.

jdk can be installed by /usr/ports/lang/jdk.

Add the line

linux_enable="YES"

to /etc/rc.conf and install shared libraries for linux

by /usr/ports/emulators/linux_base.

Then, you can emulate linux.

If you do not install under /usr/local,

goto (2).

Line 243 If you use only OpenXM clients, skip (3) and (3').

Line 289 If you use only OpenXM clients, skip (3) and (3').

rpm -i openxm-shared-version-suffix.noarch.rpm

rpm -i openxm-binary-version-suffix.i386.rpm

OpenXM は /usr/local/OpenXM にインストールされます.

あとは, 上の (4) へ.

ここで version は OpenXM の version 番号で, たとえば,

2000, 3/20(Mon) 版は 1.1.2

suffix は, RPM 版の minor version number.

Debian を利用している場合, コマンド alien で, rpm 形式を deb 形式に

変換できます.

/usr/local の下へインストールしなかった場合は, (2) を実行して下さい.

libgd のインストールが必要な場合もあります.

libgd がインストールしてない場合,

http://www.redhat.com/downloads へアクセスし, libgd をインストール

して下さい.

/*&eg

Line 265 If you use only OpenXM clients, skip (3) and (3').

Line 313 If you use only OpenXM clients, skip (3) and (3').

rpm -i openxm-shared-version-suffix.noarch.rpm

rpm -i openxm-binary-version-suffix.i386.rpm

OpenXM will be installed to /usr/local/OpenXM

Go to (4) above.

Here, version is the version number of OpenXM.

For example, the version number of the OpenXM of May 20 (Mon), 2000

is 1.1.2

suffix is the minor version number of the package.

If you are using debian, please use the command alien to translate

rpm to deb.

If you do not install under /usr/local, goto (2).

You might need to install libgd.

If it is not installed in your system, access to

http://www.redhat.com/downloads and get libgd.

/*&C

---------------------------------------------------------

/*&C

***** OpenXM client programs under OpenXM/bin or /usr/local/bin:

asir

oxmath

Line 303 If you use only OpenXM clients, skip (3) and (3').

Line 357 If you use only OpenXM clients, skip (3) and (3').

70%

OpenXM/bin/ox_math, OpenXM/bin/math2ox

OpenXM/bin/sm1, ox_sm1 on Linux libc6.

**** OpenXM server and client programs (under development)

included only in the source distribution

OpenXM/src/Macaulay2 ( M2 server and client )

OpenXM/src/ruby ( Ruby client)

**** Utilities

OpenXM/doc/oxlib ( how to link oxservers as libraries )

/*&C

Line 321 csh を利用している場合, .cshrc で

Line 384 csh を利用している場合, .cshrc で

set path=(/usr/local/jdk1.1.8/bin $path)

として, jdk の java, javac をサーチパスにいれます.

jdk の入手先: FreeBSD --- /usr/ports/java/jdk を見てください.

Linux --- http://java.sun.com/products/jdk/1.2/ja

http://java.sun.com/j2se/1.3/ja

注意:

なお, Kaffe 1.0.b4 の java は, class BigInteger に method

toByteArray が含まれてないため, OpenMath モジュールでは使用できません.

Line 337 Bash users put the following line to .bashrc

Line 404 Bash users put the following line to .bashrc

PATH=/usr/local/jdk1.1.8/bin:$PATH

export PATH

Where can I get jdk? : FreeBSD --- see /usr/ports/java/jdk

Linux --- http://java.sun.com/products/jdk/1.2/ja

http://java.sun.com/j2se/1.3/ja

Remark:

The Java interpreter of Kaffe 1.0.b4 does not contain the method

toByteArray in the class BigInteger.

Line 345 So, it cannot be used for the OpenMath module.

Line 418 So, it cannot be used for the OpenMath module.

/*&C

--------------------------------------------------------

/*&jp

★ 動作環境

Line 359 So, it cannot be used for the OpenMath module.

Line 432 So, it cannot be used for the OpenMath module.

/*&C

OS: FreeBSD 3.3 (Intel CPU),

OS: FreeBSD 3.3, 3.4, 4.x (Intel CPU),

Linux systems (Intel CPU):

Most Linux with libc5 and with libc6 (glibc 2.x).

Line 421 The installation is completed.

Line 494 The installation is completed.

/*&C

-----------------------------------------------------

/*&jp

★ 文書

Line 548 OpenXM/Copyright を御覧ください.

Line 627 OpenXM/Copyright を御覧ください.

See OpenXM/Copyright.

//&C

//&C ----------------------------------------------

//&C

/*&eg

Line 559 See OpenXM/Copyright.

Line 642 See OpenXM/Copyright.

★ OpenXM パッケージの Make 法

FreeBSD 2.2.8, FreeBSD 3.3, Linux で動作するものと期待してます.

FreeBSD 3.x, FreeBSD 4.x, Linux で動作するものと期待してます.

Linux glib6 では, いまのところ, /usr/include/features.h

(Linux glib6 では, いまのところ, /usr/include/features.h

で #define __FAVOR_BSD 1 してコンパイルする必要がありしたが,

一部のソースを

-D_BSD_SOURCE option をつけて gcc でコンパイルするように変えてます

(setjmp と sigsetjmp の問題, dirty trick).

(setjmp と sigsetjmp の問題, dirty trick) 現在では問題ありません. )

OpenXM, OpenXM_contrib, OpenXM_contrib2 が必要です.

ftp.math.kobe-u.ac.jp/OpenXM/1.1.3 より

openxm-1.1.3.tar.gz

を get して展開して下さい.

tar xzvf openxm-1.1.3.tar.gz

openxm-1.1.3/OpenXM openxm-1.1.3/OpenXM_contrib

openxm-1.1.3/OpenXM_contrib2

が生成されます.

cvs コミッタの場合次のようにしてソースをとりよせます.

/*&eg

* How to make OpenXM package?

We have tested the OpenXM package on FreeBSD 2.2.8, FreeBSD 3.3, Linux.

We have tested the OpenXM package on FreeBSD 3.x, FreeBSD 4.x, Linux.

On Linux glib6, we needed to define

(On Linux glib6, we needed to define

#define __FAVOR_BSD 1

in /usr/include/features.h,

but now we are compiling some sources with -D_BSD_SOURCE

(setjmp vs sigsetjmp).

(setjmp vs sigsetjmp). So, you do not need to make this change.)

Do you have directories OpenXM, OpenXM_contrib, OpenXM_contrib2?

get

openxm-1.1.3.tar.gz

from ftp.math.kobe-u.ac.jp/OpenXM/1.1.3

Expand it by

tar xzvf openxm-1.1.3.tar.gz

Then, you will get

openxm-1.1.3/OpenXM openxm-1.1.3/OpenXM_contrib

openxm-1.1.3/OpenXM_contrib2

If you are a CVS committer, then you can get all sources as follows:

//&C rcvs checkout OpenXM OpenXM_contrib OpenXM_contrib2

Line 598 OpenXM/src/OpenMath のコンパイルおよび利用には

Line 701 OpenXM/src/OpenMath のコンパイルおよび利用には

には, jdk (java 環境) が必要です.

Documents を生成するには, tex, ptex (ascii 日本語 tex), dvips, texinfo,

texi2html, nkf,

texi2html, nkf, jlatex2html

が必要です. 詳しくは Makefiles を見て下さい.

Document は, binary distribution の OpenXM/doc, OpenXM/lib

より得るのが簡単です.

Line 609 you need jdk (java environment).

Line 712 you need jdk (java environment).

In order to generate the full documentation including Japanese documents,

you need tex, ptex (ASCII Inc. Japanese tex), dvips, texinfo, texi2html,

nkf. See each Makefile.

nkf, jlatex2html. See each Makefile.

The generated documents are in OpenXM/doc and OpenXM/lib

in the binary distribution.

If you do not like to install Japanese environment such as ptex,

Line 619 prepare empty shell scripts ptex and nkf.

Line 722 prepare empty shell scripts ptex and nkf.

/*&C

/*&eg

To run the system, you need to read OpenXM/rc/dot.cshrc or

OpenXM/rc/dot.bashrc by the source

command for setting proper environmental variable values.

By the commands

cd OpenXM/rc

make

you can generate dot.cshrc and dot.bashrc.

Read these file by the source command in your .cshrc

or .bashrc (or .bash_profile).

/*&jp

システムを動かすには, OpenXM/rc/dot.cshrc または

OpenXM_contrib2/asir2000 の配布を受けてない場合 (ソースライセンスを

OpenXM/rc/dot.bashrc を source コマンドで

富士通より受ける必要があります),

よみこみ環境変数の値を適切に設定する必要があります.

OpenXM/src/Makefile の各モジュール名たとえば

make all-kan96xx

などと各モジュール名を指定してコンパイルして下さい.

または

コマンド

OpenXM/src/asir2000 の Makefile を Makefile.forSkip に置き換えて

cd OpenXM/rc

下さい.

make

で dot.cshrc および dot.bashrc が生成されます.

これらのファイルを source コマンドで,

.cshrc または .bashrc (または .bash_profile) より読むようにして下さい.

/*&C

//&C ---------------------------------------------------------

/*&eg

***** How to generate a subset of the full OpenXM package

If you cannot get a source liscence of OpenXM_contrib2/asir2000

from the head branch.

from Fujitsu labs,

* The souce tarball of the head branch is at

compile each modules independently, e.g.,

ftp.math.kobe-u.ac.jp/pub/OpenXM/Head/openxm-head.tar.gz

make all-kan96xx

Get this tarball by the ftp command. Extract the directories

OpenXM OpenXM_contrib OpenXM_contrib2

tar xzvf openxm-head.tar.gz

/*&jp

★ OpenXM package の一部分のみ生成する方法 (head branch より).

* Head ブランチの tarball は

ftp.math.kobe-u.ac.jp/pub/OpenXM/Head/openxm-head.tar.gz

にあります. これを ftp で取得してから

tar xzvf openxm-head.tar.gz

を展開してください.

OpenXM OpenXM_contrib OpenXM_contrib2 が作成されます.

/*&C

Or, replace Makefile by Makefile.forSkip in OpenXM/src/asir2000.

/*&eg

[Subpackage asir] If you want to generate only Risa/Asir,

type in as follows.

/*&jp

[部分パッケージ asir] Risa/Asir のみを生成したい場合は,

つぎのように入力します.

/*&C

(cd OpenXM/src ; make install-asir)

(cd OpenXM/rc ; make )

/*&eg

Copy the shell script "asir" at OpenXM/rc in your search path, e.g.,

/usr/local/bin or ~/bin

Or, read OpenXM/rc/dot.bashrc or OpenXM/rc/dot.bashrc by the source

command from your ~/.bashrc or ~/.cshrc.

/*&jp

OpenXM/rc の下のシェルスクリプト "asir" をサーチパスにコピーして

ください (たとえば, /usr/local/bin or ~/bin へ).

または OpenXM/rc/dot.bashrc か OpenXM/rc/dot.cshrc を

source コマンドで ~/.bashrc か ~/.cshrc より読み込んでください.

/*&C

/*&eg

[Subpackage kan-ox] If you want to generate only kan/k0, kan/sm1 and asir

type in as follows.

/*&jp

[部分パッケージ kan-ox] Kan/k0, Kan/sm1, asir のみを生成したい場合は,

つぎのように入力します.

/*&C

(cd OpenXM/src ; make install-kan-ox)

(cd OpenXM/rc ; make )

/*&eg

Copy the shell script "asir", "sm1" and "openxm" at OpenXM/rc

to your search path, e.g.,

/usr/local/bin or ~/bin

Or, read OpenXM/rc/dot.bashrc or OpenXM/rc/dot.bashrc by the source

command from your ~/.bashrc or ~/.cshrc.

/*&jp

OpenXM/rc の下のシェルスクリプト "asir", "sm1", "openxm" を

サーチパスにコピーして

ください (たとえば, /usr/local/bin or ~/bin へ).

または OpenXM/rc/dot.bashrc か OpenXM/rc/dot.cshrc を

source コマンドで ~/.bashrc か ~/.cshrc より読み込んでください.

//&C

//&C ------------------------------------------------------

//&C

/*&jp

[OpenXM 下のファイルの構成メモ]

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>