AdministratorGuide

From XtremWebCH Wiki

Administrator Guide

Deploy XWCH

Please see these instructions [1] to deploy XWCH.

User administration

• Users can create an account by the web interface.

• Once this is done, you can go to the user administration interface by login with an administrator and go to "Administration->Users->Edit".

• Here, select a user and click on "Edit". You can validate a user and/or name it as administrator. Validated users can use or modify modules, depending on their access rights. Administrators can do anything on the platform.

Module administration

Please see the definition of a "module" here[2]

To create modules and administrate their access rights, you have to be administrator.

Create a module

• Go to "Administration->Modules->Edit".
• Here, you can create a module. When you create a module, you have to choose its owner. The owner of the module can update it and run it.

Edit rights on a module

• Go to "Administration->Modules->Access rights".
• Choose "by users" or "by modules".
• Here, you can choose which users have which rights in which modules. A user can have :
  • no rights on a module
  • right to run a module (submit jobs belonging to this module)
  • right to run and modify a module (submit jobs and upload executables related to the module)

FAQ

How many workers can report to 1 coordinator?

The workers register, get jobs and report their state to the coordinator using web services. So, this question is almost like asking "how many http requests my Java container can handle". In our simulations with modern hardware, 200 - 300 requests per second has been a reasonable figure. This translates to 12000 - 18 000 workers.

The Derby database that comes with GlassFish uses all the CPU/memory? Can I use something else

Yes. If you are using the coordinator on Linux, you can use an installation package that support MySQL.

If you are using the coordinator on Windows or other non-unix, please follow these instructions: (change username and password).

1. Prepare glassfish

• Download the mysql-connector-java-x.x.x-bin.jar from http://dev.mysql.com/downloads/connector/j/3.1.html
• Extract the contents of the zip file unzip mysql-connector-java-x.x.x-bin.zip
• Copy mysql-connector-java-x.x.x-bin.jar to GLASS_FISH_INSTALL_DIR/lib folder.
• cd $GLASS_FISH_INSTALL_DIR
• Start (or restart) your GlassFish Application server : ./bin/asadmin start-domain domain1

2. Prepare mysql

• start the mysql database, e.g. /etc/init/d/mysql start
• create a database and a user for it: mysql --host=localhost --port=3306 --user=root --password=##### -e"CREATE DATABASE xwchdb; CREATE USER username IDENTIFIED BY 'password'; GRANT ALL PRIVILEGES ON dbname.* TO username@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;"

3. Prepare a connection pool

• cd $GLASS_FISH_INSTALL_DIR
• ./bin/asadmin create-jdbc-connection-pool --datasourceclassname com.mysql.jdbc.jdbc2.optional.MysqlDataSource --restype javax.sql.DataSource --property User=username:Password=password:URL=jdbc\\:mysql\\://127.0.0.1/dbname myxwchsqlpool

4. Test the connection pool

./bin/asadmin ping-connection-pool myxwchsqlpool

5. Create a database resource

./bin/asadmin create-jdbc-resource --connectionpoolid=myxwchsqlpool jdbc/xwchdb