Steps involved in the installation using administration tools on your web server.¶

See Installation Troubleshooting and the Leginon Forum searching for "admin" if you run into problems.

Go to administration page¶

Open a web browser. Go to 'http://yourhost/myamiweb/admin.php'
If the login system is activated, you will have to log in as administrator user. its password is the same as the username if you used autoinstaller.

If you are using installed using the auto-installation script or myamiweb setup wizard, you should have a number of default groups and users already in your database:

Default Groups and Privileges:¶

Group name	Description	Privilege
administrators	may view and modify all groups, users, projects and experiments in the system	All at administration level
power users	may view and modify anything that is not specifically owned by the default Administrator User	View all but administrate owned
users	may view and modify project that they own and view experiments that have been shared with the user	Administrate/view only owned projects and view shared experiments
guests	may view projects owned by the user and experiments shared with the user	View owned projects and shared experiments

Default users¶

Username	Firstname Lastname Displayed	Group	Description
administrator	Leginon-Appion Administrator	administrators	Default leginon settings are saved under this user
anonymous	Public User	guests	If you want to allow public viewing to a project or an experiment, assign it to this user

1. Change Leginon/Appion Administrator password¶

This user has access to everything. You need to keep it for setting default settings. Don't delete it. However, its password is the same as the host root password if you used autoinstaller. Therefore, if you want to change it for production, just choose the user, make the change, and then submit.

2. Add yourself as a User¶

Set up for a new regular user¶

A Leginon user set in the adminstration tool defines his/her own preferences once changed from the "adminstrator" user default above. It is also not related to the computer login user. Therefore, it is is necessary to go through the following steps to set up an existing computer user as a new Leginon user. With login feature activated in myamiweb, this user is also used for logging into the web server to see and process data belong to him/her:

Add a User From Administration web page¶

• Open a web browser. Go to 'http://yourhost/myamiweb/admin.php'.

• Click on Users.

• Click on Add A New User (Only users in Administrator group can do this if login feature is activated)

• Add a "username" (required) for the user. (This is like a one-word username that people use to log into a computer).

• Enter all required information.

• Add this user to a previously created group. Or, add a new group for this user. (required)

• Click Save.

Create individual configuration if not set globally¶

• Copy leginon.cfg from an existing user to the home directory of the new user.

• Modify leginon.cfg

  Modify the [user] "Fullname" field in leginon.cfg to correspond to the "firstname"+" "+"lastname" fields in the Leginon Administration User Tools.

3. Import Applications¶

• Click on Applications.

If you have used auto-installation tool to install, you should have a few applications imported already. These include Calibrations, Manual, and a few flavors of MSI applications.

• Enter the name of the Leginon application XML file. These are files in a subdirectory of your leginon installation called "applications" starting from Leginon v1.3.

The most commonly used Leginon applications are included as part of the Leginon download. These XML files are in subdirectory of your Leginon download and installation called "applications". The XML files should be imported using the web based application import tool. Each application includes a version number "(1.5)" in its name to indicate the MInimal Leginon version that it will work with.

If your system uses separate computer to control the digital camera from the one controlling the scope, please use the application that carries "2" in its name, such as MSI-T2. Otherwise, import ones without the "2", such as "MSI-T"

To find Leginon installation path on Linux:

 >start-leginon.py -v

• 

• Select the name of the "To" Host the application will be imported to.

• Click Import.

3. Import Additional Application Settings¶

For some of the newer applications, you may find json files in /your_git_clone/leginon/applications. These should be imported if you imported the application with the same name.
See Import_Export_Application_Settings_as_json_file

Proceed to Next Chapter to Add a new project for testing installation¶

The rest of this chapter is for references.

---

Installation instruction: Add a new project for testing installation >
Chapter thread: < Recommandation for setup at a new institute | Set up for a new regular user >

---