Child pages
  • Server Scripts

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Server

...

Scripts

...

The

...

Location

...

for

...

each

...

of

...

these

...

scripts

...

is

...

both

...

where

...

they

...

should

...

live,

...

but

...

also

...

where

...

the

...

most

...

recent

...

copies

...

can

...

currently

...

be

...

found.

...

Statistics

Note: These scripts are dependent on the timestamp scheme currently being used (MMM dd yyyy HH:mm:ss.SSS).

...

These

...

scripts

...

assume

...

that

...

administrators

...

will

...

want

...

to

...

break

...

down

...

usage

...

into

...

the

...

groups

...

In

...

Music

...

Library,

...

On

...

Campus,

...

Off

...

Campus,

...

and

...

Totals

...

which

...

are

...

specified

...

by

...

IP

...

addresses.

...

These

...

scripts

...

only

...

deal

...

with

...

UI

...

and

...

Darwin

...

Streaming

...

Server

...

log

...

processing

...

and

...

analyzing.

...

generateStats.pl

...

Location:

...

/home/dmlserv/bin/

...

Language:

...

Perl

Usage:

generateStats.pl

...

Mmm

...

dd

...

yyyy

...

filename

...

(Analyze

...

only

...

specified

...

date)

...


generateStats.pl

...

filename

...

(Analyze

...

an

...

entire

...

file)

...


generateStats.pl

...

(Analyze

...

today)

...

When

...

to

...

run:

...

Nightly

...

or

...

Hourly

...

Notes:

...

 

Configuration:

...

configure

...

dml.statistics.path

...

in

...

dml/conf/server/dmlscript.conf

...


configure dml.statistics.uilogpath in dml/conf/server/dmlscipt.conf
configure dml.statistics.ipfile.inlibrary in dml/conf/server/dmlscipt.conf

...


configure dml.statistics.ipfile.oncampus in dml/conf/server/dmlscipt.conf

...

generateQTStats.pl

Location:

/home/dmlserv/bin/

Language:

Perl

Usage:

generateQTStats.pl filename (Analyze an entire file)
generateQTStats.pl (Analyzes the logfile /var/streaming/logs/StreamingServer.*.log

...

that

...

corresponds

...

to

...

the

...

current

...

date

...

or

...

/var/streaming/logs/StreamingServer.log)

...

When

...

to

...

run:

...

Nightly

...

or

...

Hourly

...

Notes:

...

 

Configuration:

...

configure

...

dml.statistics.path

...

in

...

dml/conf/server/dmlscript.conf

...


configure dml.statistics.dsslogpath in dml/conf/server/dmlscipt.conf
configure dml.statistics.ipfile.inlibrary in dml/conf/server/dmlscipt.conf

...


configure dml.statistics.ipfile.oncampus in dml/conf/server/dmlscipt.conf

...

viewStats.cgi

Location:

/home/dmlserv/public_html/stats/

Language:

Perl

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="9ee2ac3f-6bae-4438-bcc6-f9b117feae25"><ac:plain-text-body><![CDATA[

Usage:

viewStats.cgi?[current][year=yyyy][month=Mmm][day=dd][location=In+Music+Library

...

|On+Campus

...

|Off+Campus

...

|Totals

...

]

...

[view=yearly

...

|monthly

...

|daily

...

]

]]></ac:plain-text-body></ac:structured-macro>

When to run:

Whenever an administrator wants to view statistics

Notes:

For this script to work dml.statistics.path

...

should

...

be

...

linked

...

into

...

an

...

apache

...

viewable

...

directory

...

that

...

is

...

specified

...

with

...

dml.statistics.urlpath

...

.

...


This

...

script

...

now

...

displays

...

both

...

UI

...

and

...

Darwin

...

statistics.

...

Configuration:

...

configure

...

dml.statistics.path

...

in

...

dml/conf/server/dmlscript.conf

...


configure dml.accesspage.urlpath

...

in

...

dml/conf/server/dmlscipt.conf

...


configure dml.statistics.urlpath

...

in

...

dml/conf/server/dmlscipt.conf

...


configure dml.statistics.abouturl in dml/conf/server/dmlscipt.conf
configure dml.statistics.cssurlpath in dml/conf/server/dmlscipt.conf

...

Reference Movie Generation

generate-ref-movie.mov

Location:

/home/dmlserv/public_html/cgi-bin/

Language:

Perl

Usage:

generate-ref-movie.mov?path=leasedir/mediafile

...

When

...

to

...

run:

...

Whenever

...

an

...

user

...

wants

...

to

...

access

...

a

...

media

...

file

...

Notes:

...

This

...

script

...

is

...

adapted

...

from

...

the

...

generate-ref-movie

...

shell

...

script

...

that

...

called

...

Java

...

code.

...


The

...

script

...

currently

...

generates

...

a

...

reference

...

movie

...

for

...

any

...

derivative

...

files

...

of

...

supported

...

bitrates

...

located

...

in

...

the

...

lease

...

directory.

...


The

...

script

...

does

...

not

...

check

...

that

...

QTAtom

...

children

...

added

...

to

...

a

...

QTAtom

...

are

...

of

...

the

...

allowable

...

types.

...

Configuration:

...

configure

...

dml.leases.rtspurl

...

in

...

dml/conf/server/dmlscript.conf

...


configure dml.leases.path

...

in

...

dml/conf/server/dmlscipt.conf

...

V2X Generation

variationsURL.v2x

...

Location:

...

/home/dmlserv/public_html/cgi-bin/

...

Language:

...

Perl

Usage:

variationsURL.v2x?type=timeline&ref=urlthatholdsv2xfile

...


variationsURL.v2x?type=opus&instatiation_id=LIB/Instantiation/xxx=&start_offset=xxx&work_start=xxx&work_end=xxx&work_id=LIB/Work/xxx

...


variationsURL.v2x?type=anything&container_id=LIB/Container/xxx&start_offset=xxx

...

When

...

to

...

run:

...

When

...

a

...

link

...

is

...

clicked

...

on

...

from

...

an

...

access

...

page

...

or

...

when

...

directed

...

to

...

from

...

another

...

source

...

Notes:

...

Most

...

references

...

to

...

Variations1

...

has

...

been

...

deleted

...

and

...

support

...

dropped

...

for

...

simplicity.

...


Query

...

string

...

parameters

...

vary

...

widely

...

as

...

can

...

be

...

seen

...

in

...

the

...

usage

...

above

...

and

...

thus

...

are

...

currently

...

gathered

...

into

...

a

...

hash

...

from

...

$ENV

...

{'QUERY_STRING'

...

}

...

as

...

opposed

...

to

...

using

...

$cgi->param('paramname])

...

like

...

in

...

the

...

other

...

scripts.

...

This

...

may

...

want

...

to

...

be

...

changed

...

for

...

standardization

...

or

...

to

...

be

...

used

...

under

...

mod_perl.

...


MIME

...

types

...

are

...

set

...

to

...

application/x-variations2-*

...

and

...

might

...

want

...

to

...

be

...

generalized

...

if

...

there

...

is

...

a

...

name

...

change

...

to

...

Variations

...

3

...

or

...

any

...

other

...

name.

...

Configuration:

...

configure

...

dml.v2x.supporturl

...

in

...

dml/conf/server/dmlscript.conf

...


configure dml.v2x.whereurl

...

in

...

dml/conf/server/dmlscript.conf

...

Access Pages

access.pl

...

Location:

...

/home/dmlserv/public_html/cgi-bin/

...

Language:

...

Perl

Usage:

access.pl?id=notisSyleID

...

When

...

to

...

run:

...

When

...

a

...

link

...

is

...

clicked

...

on

...

from

...

a

...

catalog

...

page

...

or

...

from

...

another

...

source

...

Notes:

...

Depends

...

on

...

access.xsl

...

and

...

score-access.xsl

...

which

...

have

...

entries

...

below

...

as

...

well

...

as

...

access.css

...

and

...

v2-logo.jpg.

...


This

...

script

...

depends

...

on

...

Notis

...

style

...

identifiers.

...

Configuration:

...

configure

...

dml.access.recording.dir

...

in dml/conf/server/dmlscript.conf
configure dml.access.recording.xslfile in dml/conf/server/dmlscript.conf

...


configure dml.access.score.dir in dml/conf/server/dmlscript.conf
configure dml.access.

...

score.xslfile

...

in

...

dml/conf/server/dmlscript.conf

...


configure dml.access.supporturl in dml/conf/server/dmlscript.conf

...

access.xsl

Location:

/home/dmlserv/data/accessPages/

Language:

XSLT

Usage:

 

When to run:

When called by access.pl for rendering an audio access page

Notes:

This script depends on the name Variations2 and will need to be changed whenever a name change occurs.

Configuration:

configure dml.xslt.access.v2xurl in dml/conf/server/dmlscript.conf

...


configure dml.xslt.access.cssurl in dml/conf/server/dmlscript.conf
configure dml.xslt.access.logourl in dml/conf/server/dmlscript.conf
configure dml.xslt.access.subtitle in dml/conf/server/dmlscript.conf
configure dml.xslt.access.catalogurl in dml/conf/server/dmlscript.conf
configure dml.xslt.access.cataloghelp in dml/conf/server/dmlscript.conf
configure dml.xslt.access.

...

whereurl in

...

dml/conf/server/dmlscript.conf

...


configure dml.xslt.access.userguideurl in dml/conf/server/dmlscript.conf
configure dml.xslt.access.

...

supporturl in

...

dml/conf/server/dmlscript.conf

...


configure dml.xslt.access.institutionname in dml/conf/server/dmlscript.conf

...


Line 266: "IU Music Library"
Line 268: "Indiana University Cook Music Library"

score-access.xsl

Location:

/home/dmlserv/data/accessPages/

Language:

XSLT

Usage:

 

When to run:

When called by access.pl for rendering an audio access page

Notes:

This script depends on the name Variations2 and will need to be changed whenever a name change occurs.

Configurations:

configure dml.xslt.access.cssurl in dml/conf/server/dmlscript.conf
configure dml.xslt.access.logourl in dml/conf/server/dmlscript.conf
configure dml.xslt.access.subtitle in dml/conf/server/dmlscript.conf
configure dml.xslt.access.catalogurl in dml/conf/server/dmlscript.conf
configure dml.xslt.access.cataloghelp in dml/conf/server/dmlscript.conf
configure dml.xslt.access.whereurl in dml/conf/server/dmlscript.conf
configure dml.xslt.access.userguideurl in dml/conf/server/dmlscript.conf
configure dml.xslt.access.supporturl in dml/conf/server/dmlscript.conf
configure dml.xslt.access.institutionname in dml/conf/server/dmlscript.conf
configure dml.xslt.access.score.v2xurl

...

in

...

dml/conf/server/dmlscript

...

.conf
configure dml.xslt.access.score.htmlurl

...

in

...

dml/conf/server/dmlscript.conf

...


Line 266: "IU Music Library"
Line 268: "Indiana University Cook Music Library"

generateAccessPage.sh

Location:

/home/dmlserv/bin/

...

Language:

sh calling Java

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="feb3d93b-0dd8-4fd6-825b-eb89cd3430ff"><ac:plain-text-body><![CDATA[

Usage:

generateAccessPage.sh service_name [variationsID | variationsID_file] out_directory

]]></ac:plain-text-body></ac:structured-macro>

When to run:

Whenever a new Container is created or updated (not currently setup)

Notes:

Calls v2run on edu.indiana.dml.util.AccessPageGenerator.

...


variationsIDs

...

(notis-style)

...

passed

...

to

...

this

...

script

...

must

...

be

...

for

...

Containers

...

Configuration:

 

Database

dumpDB.sh

Location:

/home/dmlserv/bin/

...

Language:

...

sh

...

calling

...

Java

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="6b8d611d-eed4-40ca-b488-d3f80a47ebad"><ac:plain-text-body><![CDATA[

Usage:

dumpDB.sh <library_name> <filename> [{-after <date>} | {-lastdays <num>} | {-contributors_and_works

...

}

...

|

...

{-in_digitization

...

}

...

|

...

{<list_of_entity_ids>

...

}

...

]
]]></ac:plain-text-body></ac:structured-macro>
<date> must be in Timestamp format, eg. 2002-08-29

...


The

...

-lastdays

...

option

...

will

...

only

...

dump

...

the

...

last

...

num

...

days

...

worth

...

of

...

edits.

...


The

...

-in_digitization

...

option

...

will

...

include

...

records

...

that

...

have

...

a

...

status

...

"In

...

Digitization"

...

and

...

MediaObjects

...

that

...

do

...

not

...

have

...

the

...

status

...

"Complete".

...

Otherwise,

...

these

...

records

...

and

...

MediaObjects

...

are

...

left

...

out

...

by

...

default.

...

Examples:

...

dumpDB.sh

...

RHS_CAT2

...

rhs_data

...

-lastdays

...

10

...

When

...

to

...

run:

...

When

...

data

...

needs

...

to

...

be

...

dumped

...

from

...

a

...

database

...

for

...

backup

...

or

...

copying.

...

Notes:

...

Command

...

for

...

dumping

...

the

...

data

...

from

...

a

...

metadata

...

database

...

into

...

a

...

file

...

in

...

XML.

...


This command is used with loadDB.sh

...

to

...

copy

...

new

...

data

...

from

...

the

...

cataloging
schema to the production schema.
This command accesses the database as a client, so
the specified server must be running for this command to work.

Configuration:

(question)

initDB.sh

Location:

/home/dmlserv/bin/

...

Language:

...

sh calling Java

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a38ae510-a901-40d1-aa56-ce7b796c424f"><ac:plain-text-body><![CDATA[

Usage:

initDB.sh [-user_only

...

]

...

service_name

...

]]></ac:plain-text-body></ac:structured-macro>

Examples:

initDB.sh IU_TEST2
initDB.sh -user_only

...

RHS_A

...

When

...

to

...

run:

...

When

...

the

...

tables

...

in

...

a

...

database

...

need

...

to

...

be

...

created.

...

Notes:

...

Command

...

for

...

creating

...

the

...

Variations

...

tables

...

in

...

a

...

database.

...


The specified server must be running for this command to work.
The "-user_only"

...

option

...

only

...

initializes

...

the

...

Access

...

Manager

...

database;

...

by

...

default
both the Access Manager and Metadata databases are initialized.

Configuration:

configure dml.server.sqlRepository.userid

...

in

...

dml/conf/server/dmlscript.conf

...


configure dml.server.userProfileManager.userid

...

in dml/conf/server/dmlscipt.conf

varGroup.sh

Location:

/home/dmlserv/bin/

Language:

sh calling Java

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="b142cbed-01b6-4161-a27c-b3f563fc8a78"><ac:plain-text-body><![CDATA[

Usage:

varGroup.sh delete [-f] <group_name>
]]></ac:plain-text-body></ac:structured-macro>
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="54ced5e4-90dc-43d9-9432-08400ce14c13"><ac:plain-text-body><![CDATA[ | dump [-f] [-g <group_name>] <file_name> | -dir <dir_name>
]]></ac:plain-text-body></ac:structured-macro>
| list
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="35e57757-317f-49a4-ad8a-f8efe3b95199"><ac:plain-text-body><![CDATA[ | load <file_name1> [<file_name2> ...]

]]></ac:plain-text-body></ac:structured-macro>

When to run:

As needed.

Notes:

Command line utility for the Access Manager Database that is used for authorization. For more information see varGroup.sh

Configuration:

configure dml.server.script.library in dml/conf/server/dmlscript.conf

Server

serverTools.sh

Location:

/home/dmlserv/bin/

Language:

sh calling Java

Usage:

serverTools.sh <service_name> {showUsers | showStats | garbageCollect | uiLogMessage <message> | delete <idNum>}

When to run:

The following is run at 12:00am (midnight) and 12:01am daily as a cron job:
serverTools.sh IU_4 uiLogMessage "Forced log file rollover."

Notes:


Configuration:

(question)