Opened 8 years ago

Closed 4 years ago

Last modified 4 years ago

#28 closed defect (fixed)

Installation Manual Errors (rewrite Manual please!)

Reported by: volkervonnathusius@… Owned by: pbaumann
Priority: major Milestone: 8.4.1
Component: manuals_and_examples Version: 8.0
Keywords: Cc:
Complexity: Very Hard

Description

There are two installation manuals: One for Rasdaman, one external product guide for postgreSQL. It is very confusing to find out in which order the steps described in these manuals have to be done. Maybe the manuals should be merged together so that the order is obvious.

Errors in Main Installation Manual:

[...]Roughly speaking, base DBMS configuration is ok if an SQL interpreter can successfully connect to the base DBMS when logged in as user rasdaman. If this does not work then you may have to reconsider settings in .rmanrc (see above).[...]

Error: .rmanrc is not existent anymore.

[...]Edit file ~rasdaman/rasmgr.conf and adapt[...]

rasmgr.conf is not located in folder ~rasdaman, but in folder ~rasdaman/bin.

Errors in PostgreSQL-Manual (External)

[...]PostgreSQL configuration
To allow for flawless communication between rasdaman and PostgreSQL, the following option needs to be set in the PostgreSQL configuration file postgresql.conf:
tcpip_socket = true[...]

Above should be mentioned that you need to be superuser for editing this file.

[...]rasdaman Variables
A set of variables must be set as described in the rasdaman Installation and Administration Guide.[...]

Error: Could not find these descriptions there.

[...]Where to Set
The above settings conveniently are stored in the resource file .rmanrc which is delivered as part of the rasdaman distribution. Local adaptations can be made there. Following the recommendation in the rasdaman Installation and Administration Guide, this resource file is intended to be read during rasdaman login, thereby making available all the settings.[...]

Error: Again mentioning .rmanrc, which is not existent anymore.

Note: From this point on it is unclear if the postgreSQL settings are done now and we can resume with the Main Installation Manual.

[...]In ~rasdaman/admin, a script named create_db.sh is provided which accomplishes database initialisation. [...]

Error: create_db.sh is not located in folder ~rasdaman/admin, but in folder ~rasdaman/bin

[...]This script assumes that a database cluster has been generated and that the pertaining server process is accessible from user rasdaman.[...]

How should this database cluster been generated? Is there any description how to do this?

[...]The script performs creation of a PostgreSQL database named RASBASE does and rasdaman initialization via rasdl. Running rasdl does not require the rasdaman server to be up.[...]

running rasdl is also mentioned in the Main Manual Guide. Again: Which of the manuals needs to be followed first?

Change History (4)

comment:1 Changed 7 years ago by pbaumann

  • Owner set to pbaumann
  • Status changed from new to assigned

comment:2 Changed 4 years ago by pbaumann

  • Milestone set to 9.0

comment:3 Changed 4 years ago by pbaumann

  • Resolution set to fixed
  • Status changed from assigned to closed

phew, quite some changes. In the end, I have merged the External Guide with the Installation Guide and resolved all the individual issues editorially.
Done in version 8.4.

comment:4 Changed 4 years ago by abeccati

  • Complexity set to Very Hard
  • Milestone changed from 9.0 to 8.4.1
Note: See TracTickets for help on using tickets.