Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Install guide #39

Merged
merged 5 commits into from
Mar 30, 2020
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 39 additions & 30 deletions gettingstarted/InstallingEquella.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,39 +3,46 @@
# Installing openEQUELLA

## Environment setup
Assuming you are building and installing openEQUELLA in the same environment, the following should be setup. Details can be found in the [openEQUELLA Dev Setup](https://github.com/equella/Equella#download-required-software) guide.
The following dependencies are required to successfully install openEQUELLA.

- Java 8 (Oracle)
- ImageMagick
- Libav
- Database
- [Java 8 JDK](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)

edalex-ian marked this conversation as resolved.
Show resolved Hide resolved
Needed if you are building your own install binary:
- GIT
- SBT
- [ImageMagick](https://www.imagemagick.org/script/download.php)
edalex-ian marked this conversation as resolved.
Show resolved Hide resolved

edalex-ian marked this conversation as resolved.
Show resolved Hide resolved
## Build the Installer
- [LibAV](https://libav.org/download/) (**Note:** This is not a compulsory step if video file attachments will not be used in your
edalex-ian marked this conversation as resolved.
Show resolved Hide resolved
institution or you don’t require them to display in the Videos gallery view.)

If you don't have / don't want to use a pre-built binary, you can build openEQUELLA from source yourself by following the instructions on the main [openEQUELLA repo](https://github.com/equella/Equella).
- Database Server

## Install openEQUELLA
1. Unzip the openEQUELLA install zip binary.
1. Run the GUI installer:
- - PostgreSQL
edalex-ian marked this conversation as resolved.
Show resolved Hide resolved
- Microsoft SQL
- Oracle

edalex-ian marked this conversation as resolved.
Show resolved Hide resolved


## Installation

1. Download and unzip the openEQUELLA installer from [Github]( https://github.com/equella/Equella/releases)

1. Run installer:
```bash
~$ cd ~/equella-installer-{VERSION}
~$ java -jar enterprise-install.jar
```
You'll need to know where you've installed imagemagick, libav, java, and your database.
During the install process you will be asked to specify where you've installed imagemagick, libav, java, and your database. For Linux users run the following commands:
- Imagemagick in Ubuntu, run ```~$ whereis convert```.

- Libav in Ubuntu, run ```~$ whereis avconv```.

The 'Institution Administration URL' for local testing can be as simple as ```http://localhost:8080/admin/```

### Windows Install
Using the equellaserver and manager bat scripts, configure and install as Windows services.

## Starting openEQUELLA
The primary log to watch is located under ```{install_location}/logs/resource-centre/{current_date}/application.{X.}html```

### Windows

1. In the windows command prompt, navigate to **<install_location>/manager**
2. To register openEQUELLA as a windows service type **equellaserver install**
3. To start the openEQUELLA service type **equellaserver start**

### \*nix
```bash
Expand All @@ -44,24 +51,26 @@ The primary log to watch is located under ```{install_location}/logs/resource-ce
and/or
~$ ./manager start
```
To stop openEQUELLA or the manager, run the same command to start the application, but pass in 'stop' instead of 'start'.
To stop openEQUELLA, run the same command to start the application, but pass in 'stop' instead of 'start'.

### Windows
Assuming openEQUELLA and the openEQUELLA Manager have been installed as services, navigate to your services, and select openEQUELLA to start.
**Note:** The primary log to watch is located under:

{install_location}/logs/resource-centre/{current_date}/application.{X.}html
edalex-ian marked this conversation as resolved.
Show resolved Hide resolved

## Accessing openEQUELLA / Finish Setup
Use your browser to login to the openEQUELLA manager (default is <http://localhost:3000>)
From here you can click the "start" button to start the openEQUELLA app server if not already done from a Windows service or \*nix start script.

Once openEQUELLA has started you can log in to the server admin pages using the hostname and port you configured in the installer.

The installation process will need to be completed in the server admin pages. Please access the server admin pages, configure the fields presented, and once presented with the database screen, initialize the database.
## Accessing openEQUELLA / Finish Setup
Once openEQUELLA has started you can log into the server admin pages using the hostname and port you configured in the installer.

edalex-ian marked this conversation as resolved.
Show resolved Hide resolved
The installation process will need to be completed in the server admin pages. Please access the server admin pages, configure the fields presented, and once presented with the database screen, initialize the database.

At this point, openEQUELLA is 'running', but still needs an institution to be useful.



## Import an Institution
1. Download the [6.4 vanilla](https://github.com/equella/equella.github.io/blob/master/guides/6.4VanillaReferenceInstitution.tgz) institution.
1. Download the preconfigured [institution](https://github.com/equella/equella.github.io/blob/master/guides/6.4VanillaReferenceInstitution.tgz).
1. Using the server admin pages, import the institution
1. After the import completes, click 'Return to Institution Management'
1. Your newly imported institution should be enabled on the 'Institutions' page. Click 'Login' under 'Actions'
1. Login with the openEQUELLA super user ```TLE_ADMINISTRATOR```, and use the institution password you set when configuring the institution import.
1. After the import completes, click '**Return to Institution Management**'
1. Your newly imported institution should be enabled on the '**Institutions**' page. Click '**Login**' under '**Actions**'
1. Login with the openEQUELLA super user **TLE_ADMINISTRATOR**, and use the institution password you set when configuring the institution import.
13 changes: 4 additions & 9 deletions guides/MoodleIntegrationGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ openEQUELLA Moodle integration can be broken into the following steps:
3. Install the openEQUELLA Moodle Module to the Moodle directory.
4. Activate the openEQUELLA Resource Module in Moodle.
5. Test the installation.


## Configure openEQUELLA
This section describes the required configuration changes to openEQUELLA to support a seamless integration. To achieve this, an openEQUELLA LTI Consumer needs to be registered, along with a Shared Secret configuration.
Expand Down Expand Up @@ -125,16 +125,11 @@ The next step in the integration process is to download the openEQUELLA Moodle M
This section describes the required configuration changes to Moodle to support the integration. openEQUELLA provides a module that allows Moodle users to easily contribute, search and select openEQUELLA items, and link them to a course.

### Download and install the openEQUELLA Moodle Modules
The Moodle Modules are available from the Downloads page in the openEQUELLA Github repository

To download the Moodle Modules
1. Navigate to the [Downloads Page](../IntegrationsDownloads.md) in the openEQUELLA Github Repository

The openEQUELLA Moodle components are made up of three zip files. Each zip contains files relevant to specific sections of the Moodle site.
Download the **openEQUELLA Moodle Module** [here](https://github.com/equella/moodle-mod_equella/archive/master.zip). This module allows users to add openEQUELLA content as resources or activities zip are the files for the standard module functionality to integrate Moodle with openEQUELLA (referred to in this guide as the openEQUELLA Resource module).
edalex-ian marked this conversation as resolved.
Show resolved Hide resolved

Inside the Module to add openEQUELLA content as resources or activities zip are the files for the standard module functionality to integrate Moodle with openEQUELLA (referred to in this guide as the openEQUELLA Resource module).
Download the **openEQUELLA Search Block** [here](https://github.com/equella/moodle-block_equella_search.git). This block allows users to search openEQUELLA directly.

Inside the Block for users to search openEQUELLA directly and Block for users to view their openEQUELLA tasks and notifications zips are the files to add portlets to the Moodle front and course pages, allowing direct openEQUELLA access (openEQUELLA Blocks).
Download the **openEQUELLA Tasks Block** [here](https://github.com/equella/moodle-block_equella_tasks/archive/master.zip). This block users to view their openEQUELLA tasks and notifications zips are the files to add portlets to the Moodle front and course pages
edalex-ian marked this conversation as resolved.
Show resolved Hide resolved

For complete installation the contents of each zip file need to be extracted to the corresponding folder in the Moodle filesystem.

Expand Down