COSMOS Installation (POSIX)

Author: Hirohisa Mori / joshua at globalbase.org + [Transrate]Reiko Inoue Bendtsen c/o Suzaku Translations / (http://www.suzaku-translations.com/) +

* Abstract
* System Requirements
* [Step 1] Installer Download
* [Step 2] Execution of Installer
* [Step 3] Installer Options
* [Step 4] Settings for Each User
* [Step 5] Confirmation of COSMOS Execution

Abstract

This page explains how to download and install the POSIX version of the COSMOS installer.

[UP] Go To Page Top

System Requirements

POSIX ( Linux, Solaris)

[UP] Go To Page Top

[Step 1] Installer Download

From the GLOBALBASE download page ( (http://sourceforge.jp/projects/globalbase/)), download the latest version appropriate for your machine, such as gbs-client-linux.general or gbs-client-solarisX. The download page consists of mirror sites of sourceforge.jp, from which the basic system can be downloaded, and is basically the same as the download pages for MacOSX and Windows. Please refer to those pages as well.

In cases of ver.B.b16.05 and earlier, a file named cosmos.t is downloaded; store the file in the directory where you wish to install COSMOS. In the following we shall assume that you create a new directory called cosmosdir and use it for your COSMOS-related activities. The installer creates two directories in this directory, bin and peripheral.

In case of ver.B.b16.06 or later, a file named cosmos.tar.gz is downloaded. If you unzip the file using gzip or tar, the unzipped file contains files named cosmos.t and README. la


% gzip -d cosmos.tar.gz
% tar xvf cosmos.tar
% ls
cosmos.t README.en.txt README.sjis.txt
%

[UP] Go To Page Top

[Step 2] Execution of Installer

Change the working directory to cosmosdir and execute cosmos.t as root ( super-user). In case of ver.B.b16.05 and earlier, it is necessary to change the execution privilege of cosmos.t, but that is not necessary for ver.B.b16.06 and onward.


% cd cosmosdir
% chmod 0755 cosmos.t
% su root
# ./cosmos.t -app

The installation is successful if you find the bin and peripheral directories under the cosmosdir directory. The bin directory contains the cosmos executable file and the cosmos_installer.t executable file.

[UP] Go To Page Top

[Step 3] Installer Options

cosmos.t and cosmos_installer.t are the same types of executable files, and can be executed with the following options.

-all
In this case, when you decompress the executable file, all the peripheral environment settings are performed automatically, including registration to browser helper applications. This is the best choice when COSMOS is installed in an individual user's directory.
-app
This option decompresses only the executable file. Use this option to install COSMOS if you only install it once on a single machine and plan to share it.
-env
COSMOS first needs to be installed on a machine with the -app option; that is, each user should first execute the following once before using COSMOS:
./cosmos.t -app
This option sets up the user browser and other peripheral applications. It is also all right to execute cosmos_installer.t in the bin directory. In this case, it is not necessary to supply any options.

[UP] Go To Page Top

[Step 4] Settings for Each User

Each user must then add the directory named cosmosdir/bin to her/his PATH environment variable.
Each user should then execute cosmos_installer.t in her/his own directory.
```
% cosmos_installer.t -env
 
```

[UP] Go To Page Top

[Step 5] Confirmation of COSMOS Execution

Then, by executing the following command, the viewer can be launched.


% cosmos v

[UP] Go To Page Top