Using SakaiAdminX

Information

This guide will show you how to perform the various functions within SakaiAdminX. Before we begin, a term you should know:

  • modal window: a child window that requires you to interact before you can return to the parent window. SakaiAdminX uses lots of these, its a handy way to perform large inline edits.

Login

In order to do anything in SakaiAdminX, you must first login. Click the button to login and you will be presented with a modal Login window:
Login window

Login with your Sakai username and password. If the login fails you will be notified:
Failed login

If you are successful, the modal window will fade away and you will get your customised site list.

Site List

Your site list is customised to what sites you are attached to, or a complete searchable list of all sites if you are an administrator or helpdesk user (See the Administrative functions section below)
Site list

You can view the site profile by clicking the Site ID, or go to the site in Sakai, by clicking the Site title. You can also view other information about the site, like what client it is attached to, and what type it is.

Site Profile

The site profile is the main part of SakaiAdminX and is the place where all administration of a site occurs. Here you can add and remove instructors, add and remove participants, upload a list of participants, edit the site title, edit the site skin, and much more.

Adding users to a site

There are several types of users in a Sakai site managed by SakaiAdminX. Instructors are the equivalent of the 'maintain' role in Sakai and can change everything in a site. They can also mange the site profile in SakaiAdminX. Guests are generally temporary users that the instructor has allowed access to, and they have the same level of access as normal participants. Participants are the equivalent of the 'access' role in Sakai and are a normal user of the site.

Instructors and Guests are grouped at the top whilst Participants are listed in the bottom section.

Adding instructors or guests

To add an instructor or guest, click the 'Add a user' button.

You will be presented with a modal window where you can enter the username and role (Instructor or Guest) for the new user, then click 'Add User'.
Adding a user window

The username must be a valid username for your Sakai server (either a local Sakai account or provided via LDAP etc). If it fails, you will be notified.
If you want to quit without adding a user, Click 'Cancel' or the red X.
Adding a user that failed

Adding participants

To add participants, click the 'Add a participant' button and enter the username of the user you want to add.

Uploading a list of participants

You can also upload a comma separated list of users by clicking the 'Upload Participants' button and browsing for the file. The file needs to be correctly formatted according to username, role_id where role id is generally 'student'.
Uploading participants

Changing site properties

As an instructor you can change many of the site properties like the site title, the site skin, the site icon etc. Click the 'Edit' button next to the property you want to edit. You will be presented with a modal window where you can enter the new value, then 'Save' the changes.

Edit the title of a site

Edit the site skin, from the list of available skins


Support functions

Super helpdesk users are able to view all sites and change some aspects of the sites (see above) but can also search for users. In future releases this list will be expanded.

Query users

SakaiAdminX allows helpdesk and admin users to query for other users. At present this is limited by the Sakai API and only returns either local Sakai accounts, or users that are attached to sites in Sakai but as new methods are introduced this will be more inclusive.
To query for a user, click 'Query a user' from the side navigation bar, enter the search criteria and click 'Search'.

This will return any records that match:
User query


Administrative functions

This section of the guide is aimed towards system administrators who are listed in SakaiAdminX as super admin users. IF you have no super admin users, you will need to login as the Sakai 'admin' user, and add some normal users to the list of super admin users.

Creating a site

Creating a site is as simple as filling out a form and clicking a button. This will create a site with a default set of tools, based on the template you choose. You should already have a template site created, with the roles and tools all setup (see the Installation Guide if you have not done this).

Choose 'Create a site' from the side navigation bar, fill out the form and click 'Create Site':
Create a site

Deleting a site

Deleting a site is also very simple, choose 'Delete a site' from the side navigation, enter the siteid of the site, and click 'Delete Site':
Delete a site

Creating a user

To create a user account in Sakai, choose 'Create a user' from the side navigation, fill out the form and click 'Create User'. If you want the new user to be notified of their details, click the checkbox 'Send details' and an email will be sent out to the user with their username and password and instructions on how to login and navigate around their 'My workspace' site. You should assign them a random password, or use the 'Generate password' helper button to automatically do this for you.

Create a user

The contents of the email that the user receives if you check the box to send it, looks like this:

Sample email

Dear Tessy McTest,

An account has been setup for you and your access details are:

Username: tessy123
Password: 12qwAS9*
First Name: Tessy
Last Name: McTest
Email: tessy@mctest.com

You can login to Sakai here:
http://your.sakai.server

Once logged in, from the 'My Workspace' site you can edit your
account details including changing your password via 'Account',
you can setup your personal profile including adding a picture
of yourself via 'Profile' and you can view your site membership
via 'Membership'.

Any sites you have access to will be listed across the top
navigation bar and you can customise this list via 'Preferences'.

You can also setup personal preferences for email notifications,
your time zone and your preferred language in 'Preferences'.

—
Your institution

...where the URL to your Sakai server and 'Your institution' are setup when SakaiAdminX is configured and built

Deleting a user

To delete a user account that you have created, choose 'Delete a user' from the side navigation, enter the username of the user account you want to delete, and click 'Delete User':
Delete a user

Note: This will only delete accounts that have been created in Sakai. Provided accounts from LDAP etc are not affected.

Managing clients

The concept of clients in SakaiAdminX is that every site is attached to a client, or owner. This was born out of the idea of running one Sakai installation for multiple institutions or 'clients' - then one instance of SakaiAdminX could administer these multiple clients. You need at least one client to create sites. In a future release, if you have only one client, you will not need to choose clients when administering SakaiAdminX.

To view the list of clients, click 'Client Management' in the 'Admin' section of the side navigation bar:
Client management

Here you can add new clients by clicking 'Add a client', edit existing clients by clicking the edit icon and delete clients by clicking the delete icon.

When editing a client you can change the client's name and its sort order, the position it appears in lists:
Editing a client

Managing client admin/helpdesk users

Client admin/helpdesk users have access to all sites that are attached to the particular client. Client admin users have write access to all client sites and to the site profile in SakaiAdminX for these sites, and helpdesk users have read only access, but can change some things in the site profile. These users are synchronised via the set of Quartz jobs that run on the Sakai server (see the Installation guide for more info on the Quartz jobs).

To view the list of Client admin/helpdesk users click 'Client admin users' from the side menu and then choose the client:

Client admin/helpdesk users

To add a new client admin, click 'Add a client admin/helpdesk user', enter the username and role for the new user in the modal window, and click 'Add user':

Adding a client admin/helpdesk user

To delete a client admin/helpdesk user, click the remove icon next to their name.

Managing super admin/helpdesk users

Super admin/helpdesk users have access to all Sakai sites. Super admin users have write access to all sites and to the site profile in SakaiAdminX for these sites, and helpdesk users have read only access, but can change some things in the site profile for all sites. Admin users have instant access to all sites, whereas the helpdesk users are synchronised via the set of Quartz jobs that run on the Sakai server (see the Installation guide for more info on the Quartz jobs). The reason for this is in the design of admin users in Sakai.

To view the list of super admin/helpdesk users click 'Super admin users' from the side menu:
Super admin/helpdesk users

To add a new super admin, click 'Add an admin/helpdesk user', enter the username and role for the new user in the modal window, and click 'Add user':
Adding a super admin/helpdesk user

To delete a super admin/helpdesk user, click the remove icon next to their name.

Managing SakaiAdminX internal data

As a super admin user you can manage the data that SakaiAdminX uses to render lists, as well as maintain the mapping between the user roles in SakaiAdminX and Sakai itself.

Be Careful

Editing this data could render the integration between SakaiAdminX and Sakai unstable, especially when editing the role mappings. Be careful, and try out any new changes on a development server first.

You can view the data that SakaiAdminX uses by clicking 'Data management' from the side navigation bar:
Data management

You can edit the values here by clicking the edit icon next to the item you want to edit. This is useful for changing the display values or changing the sort order of values in lists, ie skins or the site type:
Editing a data item

You can add a new item to an existing category by clicking 'Add a new item', choosing the category and filling in the values:
Adding a new data item

You can also add a new category of data items, but unless you are creating a new module for SakaiAdminX, you don't need to do this:
Adding a new data category

Site skins

SakaiAdminX allows an instructor/admin/helpdesk user to change the skin of their site in the Site Profile. In order to do this, the Sakai skin needs to be located on your Sakai server in the right spot.
Skins are located at:

SAKAI-SRC/reference/library/src/webapp/skin/YOURSKIN/

then built using Maven and deployed to:

http://your.sakai.server/library/skin/YOURSKIN/

In order to allow a user to switch between skins, you need a corresponding entry in the 'sakai_skins' category for YOURSKIN. The list value should be YOURSKIN (which matches YOURSKIN on your Sakai server) and the list display can be anything you like, its what will be displayed on the Site skin dropdown list:

eg:
list value=newskin
list display=My new cool skin!

will render the new skin dropdown list like so:

with the value 'newskin' being updated in Sakai for the site.