| United States-English |
|
|
|
![]() |
HP Domain Commerce Installation Guide > Chapter 3 Installation and Configuration ExampleAn Example of Installing and Configuring HP Domain Commerce |
|
This chapter provides detailed instructions on how to install and configure a working example of HP Domain Commerce on a single system.
The details for each of these steps are provided in the next five sections.
When installing the Oracle database, follow the instructions in Oracle's installation guide. The following set of instructions is an example of how to install the database. “Other Installation Information” for information about Oracle requirements. Directory layout affects the performance of the Oracle database. In this example, four directories are planned. The four directories will contain the following:
Complete the following steps to install the Oracle database. Installation of the Oracle database may take over two hours to complete. On the local system, do the following:
As root, do the following:
As user oracle, do the following:
As root, do the following:
As user oracle, do the following:
The vPOS software must be installed before configuring the Netscape Enterprise Server. To install the vPOS software, do the following:
In order to configure your Netscape Enterprise Server to use vPOS, you must complete the following steps (you must be logged in as the root user for each step):
When you swinstalled the Netscape Enterprise Server, a default server was configured for you. You will need to delete this default server. Do the following:
Once you have removed the default instance of the Netscape you need to change the ownership of the Netscape Enterprise Server binaries to make the installation and configuration of the vPOS administration and payment servers easier. Although this is not a required step, you will avoid any problems that might occur when altering the configuration of the vPOS servers. To change the ownership, from a terminal window (you do not have to exit the Netscape Administration Server), type the following: /usr/bin/chown -R vpos:vpos /opt/ns-enterprise3/* Typically, a configured Netscape Enterprise Server is run as user www. The Netscape Enterprise Server binaries are installed with the appropriate files with the appropriate ownership such that user www can change information in all the necessary files. In the case of the vPOS servers, the administration and payment servers are run as user vpos. User vpos cannot change information in all the necessary files as they are owned by user www. To correct this problem, you can either change ownership of all the Netscape Enterprise Server binaries ensuring that there will be no ownership problems or, as ownership errors occur, you can determine which files need to have their ownership changed and change them individually. Changing ownership of the Netscape Enterprise Server binaries is the best and easiest way to avoid unnecessary errors.
You have completed the configuration of the vPOS administration server. You are now ready to configure the vPOS payment server.
You have completed the configuration of the vPOS payment server. Please, follow the vPOS instructions in the order presented here so you can access the 'sample' store configured in the tar vPOS file without inadvertently updating other configuration data.
Please note that when the instructions say "log-in as xxx" it means that you have to be the user xxx, not just invoke "su -u xxx" to execute the command. The components being installed here are very sensitive to ownership of files and directories and you may experience problems if you do not follow the steps below. There are several things that you can do now to prepare for the Installation and Configuration steps that follow. By doing these things now, you will have the necessary information for later use.
To see if the vPOS server process is running you may use the commands:
Access the vPOS Admin server using your browser: http://<hostname>:8081/index.html The frames will navigate you through the screens. For example, you press "Configuration Editor" and you can change the default values for the vPOS server. Note that other screens have not been initialized yet. Do not attempt to access them at this time. This will show a form with the current default values that MUST be updated by the user before proceeding with the next steps. Change values and click on "Update" key (under vPOS INI File section). Form: ...................................................................... Engine Service: ../cgi-bin ServicePort 7777 ServiceIP <hostname> LOGGING errorLog LOG_LOCAL1 DATABASE SID vpos HOME ${ORACLE_HOME} (replace by its value) BIN ${ORACLE_HOME}/bin (replace by its value) vPOS INI File Update ...................................................................... You cat get context-sensitive help by clicking on one of the four frames (Configuration editor; Environment editor; Site administration; vPOS Service) and then clicking on the Help button. Select: "Site administration" from the left-hand frame. Click: "add". It will show you a form and let you enter the encryption string. For example, enter string "vpos123" (and enter "vpos123" again to confirm it) and press NEXT. The following is a simple example. Be careful when selecting the actual user password! The user should enter the appropriate values to match those shown on the following table. Table 3-17 Encryption String Configuration Parameters
Click: "CONFIGURE". The user should enter the appropriate values to match those shown on the following two tables. Table 3-18 Acquirer(s) Configuration Parameters — Screen 1
Enter the following text into the large text box (with no name): "This is the first shs id screen." Note: The system does not care what you enter into this box, but it does check to be sure that you put something here. Click: OK This will take you to the second screen. Table 3-19 Acquirer(s) Configuration Parameters — Screen 2.
Enter the following text into the large text box (with no name): "This is the second shs id screen." Note: The system does not care what you enter into this box, but it does check to be sure that you put something here. Click: OK. If you edit the Site Administration screen at a later date, you will be able to update the stores. Click: "vPOS Services". Access the vPOS server to see the initial page of a store front: Go to: http://<hostname>:8085/stores/shs/shs.html Note that you will need a vWALLET to complete this transaction. You can browse through this screen and the next screen to see the user interaction but you will not be able to place the order. Go to: http://<hostname>:8085/vpos/cgi-bin/termint.exe/@shs@/ You will be prompted for a password. Enter VPOS as the password. Go to "Operator" and follow the instructions. For example, enter the following "Sale" transaction: Invoice number 123 Credit Card Number 4242 4242 4242 4242 Expiration Date 05/2000 Transaction Amount 9.99 Street Address 11000 N. Wolfe Rd. Cupertino CA Zip Code 95014 Customer Reference 1234 Destination ZIP 95070 Local tax .82 Click: "Submit."
You may go back to the Environment Editor and see that vPOS is partially configured. Instead of using the configuration form, you can update a file. Note that the values updated at this screen are stored in the file /domain/vpos/admin/vpos.ini. The initial values stored in the file are:
As said earlier, a reason to have the web server owned by user vpos is that the owner of the web server has to have write permission to the /domain/vpos/admin/vpos.ini file. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||