Command Line Install/Update (pre 7)

ROGO 6.4.0


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


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.

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>
    </server>
    <database>
        <prefix>rogo</prefix>
    </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>
    <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.

database/prefixPrefix appending to rogo tables and users in database. i.e. rogo
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
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, --user,             Database username

-p, --passwd,           Database password

-o, --staff_help,       Load staff help (0/1, default 0)

-q, --student_help,     Load student help (0/1, default 0)

-l, --langpacks,        Load language packs (0/1, default 0)

-n, --npm,              Update NPM library (0/1, default 1)