Tag/tag.png

Style Cleanup Required
This article does not follow the style standards in the Wiki Guide. More info...

Oracle Express Edition / on Ubuntu Edgy 6.10

I am using the Edgy Server, so I will show you how to set things up so that they work whether you have X-Windows installed or not. This has also been successfully tested on:

Version

Release Name

Comments

6.10

Edgy

8.04

Hardy LTS

9.10

Karmic

10.04

Lucid

10.10

Maverick

Requirements

As usual, Oracle needs a lot of resources, with a minimum for the server of 512 MBytes of Ram and 1024 MBytes of Swap and 1.5 Gbytes of free disk space. These requirements are checked by the install package.

As the amount of swap isn't the default value for a fresh install, be aware of that. A workaround for that is described in http://www.oracle.com/technology/tech/linux/install/xe-on-kubuntu.html

Oracle10gDapper mentions a dependency on libaio1 and bc - but I don't recall it being a problem on my Edgy installation (the latest oracle-xe package lists them as dependencies inside the package and apt-get will install them for you should they not already be installed).

Requirements for NFS

If you are installing onto nfs (ie, if /usr/lib is on an nfs volume), oracle is very picky about the mount options you must use. You won't get any error message during the configure step - oracle just won't work. These mount options seem to make oracle happy:

rw,nfsvers=3,noatime,rsize=32768,wsize=32768,hard,intr,nolock,tcp,async,noac,suid

It's best to create a new oracle mountpoint (/usr/lib/oracle) and mount a separate nfs export to there (since you might not want all those options on the rest of your nfs mounted filesystem).

Fundamentals

Install the Oracle XE database server using the instructions at Oracle.

As root, type:

/etc/init.d/oracle-xe configure

Edit your .bashrc file to include the lines:

ORACLE_HOME=/usr/lib/oracle/xe/app/oracle/product/10.2.0/server
PATH=$PATH:$ORACLE_HOME/bin
export ORACLE_HOME
export ORACLE_SID=XE

export PATH

Start a new bash shell for the changes to take effect.

To log in as a database administrator:

sqlplus sys as sysdba

It will then be possible for you to create and unlock user accounts using Oracle SQL commands. The details of which are beyond the scope of this doc.

Testing the Oracle-supplied example database

Oracle have thoughtfully provided a dummy database for you to play with. There is a user called HR with some tables in them. It provides a good test to check that everything is up-and-running.

Gain admin access using 'sqlplus sys as sydba' (shown above). Choose a password for user HR (which I will denote by $password) and then type

alter user HR account unlock ;
alter user HR identified by $password ;
exit

Now attempt to examine the database as user HR:

sqlplus HR/$password
SELECT table_name FROM user_tables;
SELECT * FROM regions ;
INSERT INTO REGIONS (REGION_ID, REGION_NAME) VALUES (666, 'Outer Mongolia') ;
COMMIT ;

The first SELECT statement should give you a list of user tables that you can play with (in this example, they are: REGIONS, LOCATIONS, DEPARTMENTS, JOBS, EMPLOYEES, JOB_HISTORY, COUNTRIES). The second SELECT statement shows a list of entries in the REGIONS table. Hopefully everything will show up fine. In the INSERT INTO line, I add a record to the database so that we can prove what database we are connected to. COMMIT just commits the new item.

Connecting via Windows

If the above works, we should be on the home straight. Let's try to connect to our Ubuntu box from Windows. I have assumed that you have set up Oracle on Windows.

Edit the file TNSNAMES.ORA, which may typically be found in the directory C:\oracle\product\10.1.0\Db_1\NETWORK\ADMIN and add the following lines:

$CONNID=
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = $IP)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = XE)
    )
  )

where $CONNID is whatever connection ID you want to use. You could use a name like UBUNTU; but I prefer to give it the name of the server that is running Oracle. $IP is the IP address of your Ubuntu box, typically something like 192.168.30.123 - but you'll have to decide the actual address for yourself (hint: run ip addr, look at eth0 section, inet addr address). Save and exit.

Start a DOS shell, and enter the command:

sqlplus HR@$CONNID

where, of course, you'll have to enter whatever connection ID $CONNID is. You will also need to supply the password that you created for HR.

Examine what's in the database. See the "Testing ..." section above to see what tables are available. If you performed the actions specified in that section, then, if you type

SELECT * FROM regions ;

you should see the 'Outer Mongolia' entry that you created.

And that's about it! Everything should now be set up, ready for you to do proper adminning of the database in accordance with standard procedures.

Tips

Some random tips which mostly appeared in Oracle10gDapper.

HTTP Interface

Now for creating users / schema / ... you have a nice http interface to do it :

http://localhost:8080/apex/

No more need of java.

If like me you install this Oracle database on a server without a graphic X server, you may need to use a SSH port forwarding

ssh -L 8080:localhost:8080 user@IP_of_your_server

Personally, I (MarkCarter2), use Edgy Server, and use putty from Windows to connect to my Ubuntu box. I then do "sqlplus sys as sydba" to administer accounts that way. For me, it's much less fiddle than either method mentioned above

It is also possible to use the administration console remotely, even if it's not recommended for security reasons (better using SSH port forwarding as previously said):

sqlplus sys as sysdba
EXEC DBMS_XDB.SETLISTENERLOCALACCESS(FALSE);

Installation Troubleshooting

NFS: see Requirements for NFS, above.

Others: the directory /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/config/log contains the logfiles of the sql scripts run to initially set up the database. If you are having problems with oracle not starting up, check these files.

ORA-27101: shared memory realm does not exist

If this Error appears while connecting, check the following thing: If the command "bc" is installed. if not type

  • sudo apt-get install bc
  • aptitude purge oracle-xe-universal
  • apt-get install oracle-xe
  • or (apt-get install oracle-xe-universal)

If you now get an error saying that your Swap space is to small please look at the Swap Documentation Entry.

See Also

Oracle How to Install on kubuntu : http://www.oracle.com/technology/tech/linux/install/xe-on-kubuntu.html

Oracle10gDapper - Oracle Express Edition 10g R2 / on Ubuntu Dapper 6.06 LTS

RevTech Zero's Database Blog - Oracle 10g R2 / Enterprise / Standard on Ubuntu Gutsy Gibbon 7.10 http://revtech0.webonsites.com/blog.html

http://mapopa.blogspot.com/2006/03/installing-oracle-on-ubuntu-breezy.html

Oracle FAQ, Forum, Wiki, etc. at http://www.orafaq.com/

Howto install Oracle 10g (enterprise or standard edition) on Ubuntu 64 bits

Another Howto install Oracle 10g on Ubuntu Karmic 64 bits

Pythian Oracle and Ubuntu Howto

Oracle10g (last edited 2011-05-16 15:34:18 by jengelh)