This space is archived

For current information please use the current ExamSys documentation

9. Command Line Install/Update

ROGO 7.0.0


Recommend for experience users only. The web browser install interface may be more suitable - Installing the Application.


Install

Rogō can be installed on the command line using the init.php script.

init.php
$ php init.php -h
Rogo initialisation script options

-h, --help      Display help

-u, --user,     Database username

-p, --passwd,   Database password

-s, --host,     Database host

-t, --port,     Database port

-n, --name,     Database name

User/Passwd:  Username and password for database - must have full access to db.

Host/Port: Server and port database is running on.


Before running the init.php script the admin user should create a config/settings.xml file. It is advised to copy and update the config/settings.example.xml file.

settings.xml
<?xml version="1.0" encoding="UTF-8"?>
<settings>
    <company>University of Testing</company>
    <server>
        <host>127.0.0.1</host>
        <data>/rogodata</data>
        <temp>/tmp/</temp>
        <root></root>
        <site_address>https://localhost/</site_address>
    </server>
    <database>
        <prefix>rogo</prefix>
        <engine>InnoDB</engine>
        <help_engine>MyISAM</help_engine>
    </database>
    <timedate>
        <mysqlshortdate>%d/%m/%y</mysqlshortdate>
        <mysqllongdate>%d/%m/%Y</mysqllongdate>
        <mysqllongdatetime>%d/%m/%Y %H:%i</mysqllongdatetime>
        <mysqlshortdatetime>%d/%m/%y %H:%i</mysqlshortdatetime>
        <phplongdate>d/m/Y</phplongdate>
        <phpshortdate>d/m/y</phpshortdate>
        <phplongdatetime>H:i:s</phplongdatetime>
        <phpshortdatetime>H:i</phpshortdatetime>
        <timezone>Europe/London</timezone>
    </timedate>
    <sysadmin>
        <username>testuser</username>
        <password>password</password>
        <title>Mx</title>
        <forename>Test</forename>
        <surname>Tester</surname>
        <email>test@example.com</email>
    </sysadmin>
    <authentication>
        <lti>0</lti>
        <internaldb>1</internaldb>
        <ldap>1</ldap>
        <summativeguestlogin>1</summativeguestlogin>
        <userimpersonation>1</userimpersonation>
    </authentication>
    <ldap>
        <server>ildap.example.ac.uk</server>
        <searchdn>OU=University,DC=ac,DC=uk</searchdn>
        <username>user</username>
        <password>password</password>
        <prefix>pre</prefix>
    </ldap>
    <supportemail>support@example.com</supportemail>
	<paperanomalyemail>anamoly@example.com</paperanomalyemail>
    <contact1>
        <name>Test Tester</name>
        <telephone>1234 567890</telephone>
    </contact1>
    <contact2>
        <name>Test Tester</name>
        <telephone>1234 567890</telephone>
    </contact2>
    <contact3>
        <name>Test Tester</name>
        <telephone>1234 567890</telephone>
    </contact3>
    <help>1</help>
    <translations>0</translations>
    <lookup>
        <ldap>1</ldap>
        <xml>0</xml>
    </lookup>
    <labsecurity>
        <type>ipaddress</type>
    </labsecurity>
</settings>
SettingDescription
companyName of the institute Rogo is running for
server/hostIP address of web server. Probably 127.0.0.1.
server/dataLocation of rogo data direcotry on server. i.e. /rogodata
server/tempLocation of temp directory on server. i.e. /tmp/
server/root

Path to Rogo from web root directory. Will be '/' unless using sub directory's.

server/site_addressThe url to the root of Rogo (from Rogo 7.5.0)
database/prefixPrefix appending to rogo tables and users in database. i.e. rogo
database/engineThe MySQL database engine to use for the core database
database/help_engineThe MySQL database engine to use for the help database
timedate/mysqlshortdateThe short date format returned by the database
timedate/mysqllongdateThe long date format returned by the database
timedate/mysqllongdatetimeThe long atetime format returned by the database
timedate/mysqlshortdatetimeThe short datetime format returned by the database
timedate/phplongdateThe long date format returned by the application
timedate/phpshortdateThe short date format returned by the application
timedate/phplongdatetimeThe long time format returned by the application
timedate/phpshortdatetimeThe short time format returned by the application
timedate/timezoneThe timezone the application should use.
sysadmin/usernameSysadmin username
sysadmin/passwordSysadmin password
sysadmin/titleSysadmin title
sysadmin/forenameSysadmin forename
sysadmin/surnameSysadmin surname
sysadmin/emailEmail address for sysadmin
authentication/ltiEnable LTI authentication
authentication/internaldbEnable internal database authentication
authentication/ldapEnable LDAP authentication
authentication/summativeguestloginEnable guest login accounts
authentication/userimpersonationEnable sysadmin user impersonation
ldap/serverLDAP server address
ldap/searchdnLDAP dn
ldap/usernameLDAP username
ldap/passwordLDAP password
ldap/prefixLDAPprefix
supportemailComma seperated list of support emails
paperanomalyemail
The address that anomaly reports should be sent to (from Rogo 7.5.0)
contactX/nameSupport contact full name
contactX/telephoneSupport contact email address
helpEnable loading of help files
translationsEnable installation of language packs
lookup/ldapEnable LDAP lookup
lookup/xmlEnable XML lookup
labsecurity/typeLab computer validation type


Once installation is completed it is recommended that the config/settings.xml file is removing from the system as it contains user details.

Update

Rogō can be updated on the command line using the upd.php script.

upd.php
$ php upd.php -h
Rogo initialisation script options

-h, --help     Display help
-u             Database username
-p             Database password
-s             Web server address. It should be in the form https://www.example.com/path/
               It is only used on upgrades to version 7.5.0 to avoid a command line prompt (optional)
-o             Load staff help (0/1, default 0)
-q             Load student help (0/1, default 0)
-l             Load language packs (0/1, default 0)

Note to Developers

When updating you may need to update both composer and npm.


Filter by label

There are no items with the selected labels at this time.