-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.install
executable file
·92 lines (60 loc) · 2.9 KB
/
README.install
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
USERHELP DEVELOPEMENT INSTALLATION INSTRUCTIONS
----- OVERVIEW -----
The basic steps of installing the userhelp product are:
a) check the userhelp out of cvs
b) set the proper configuration settings
c) run the install
d) setup web-based access
----- PRE INSTALL DECISIONS -----
First, decide where this product will be installed.
Suggested location is in a "/work/" directory, within your home
directory (/home/yourUserID/work/)
Throughout the following steps, this value will be referred to as:
INSTALL_LOCATION
When checking out the userhelp from CVS, we have the option to dictate the
name of the directory in which the userhelp will "live". We will use this
functionality to help the developer track the status (branch/trunk/tag)
of the given userhelp install by the naming convention used. Suggest the use
of directories named "userhelp-trunk" when checking out the trunk and
"userhelp-branchName" (userhelp-tr9993) when checking out a branch.
Throughout the following steps, this value will be referred to as:
INSTALL_DIR_NAME
------- STEP 1 -------
Checkout the userhelp product - From the Unix Command Line:
1) when working on the trunk
cd INSTALL_LOCATION
cvs checkout -d INSTALL_DIR_NAME userhelp
example: cvs checkout -d userhelp-trunk userhelp
2) when working on a branch, we need supply the branch name (usually 'tr####')
cd INSTALL_LOCATION
cvs checkout -d INSTALL_DIR_NAME -r BRANCH_NAME userhelp
example: cvs checkout -r tr8087 -d userhelp-trunk userhelp
------- STEP 2 -------
Only a default configuration file is provided. The installer must
copy the file named Configuration.defaults to another file named
Configuration.
From the Unix Command Line:
cd INSTALL_DIR_NAME
cp Configuration.defaults Configuration
------- STEP 3 -------
The install specific parameters have to be set for each install. The most
important parameters (and will probably be changed for each install) have
been left at the top of the Configuration file for convenience.
------- STEP 4 -------
Now, it's time to install the product...
From the Unix Command Line: Run the Install script by typing "Install".
This will generate the server side includes, set permissions, etc...
------- Step 5 -------
Now that the product is installed, we need to setup the web-based access.
For developers, this is accomplished by creating a soft link within the
"/yourUserID/public_html/" directory, that points to the full
path of this userhelp installation.
From the Unix Command Line:
cd ~/public_html/
ln -s /home/yourUserID/INSTALL_LOCATION/INSTALL_DIR_NAME/www/ INSTALL_DIR_NAME
...for example...
ln -s /home/yourUserID/work/userhelp-trunk/www/ userhelp-trunk
Enter "http://cardolan/~yourUserID/" into the browser, and you should see the
"userhelp-trunk" link (will look like a folder)
This step may not be needed if the soft link has already been made and the
same directory naming conventions are used.