Creating the /opt/tectia Directory

Creating the `/opt/tectia` Directory

You can have Tectia Server for IBM z/OS installed into an existing HFS or zFS file system (see the section called “Option 2”) or you can create a separate file system for it (see the section called “Option 1”).

Tectia Server for IBM z/OS will always be installed to path /opt/tectia.

You need to create the /opt/tectia directory and mount the selected file system to it. If you do neither of the above, the product installation will be tried into the file system where /opt is.

Option 1

When you want to create a new HFS, or define a zFS file system for the installation, start by creating an empty tectia directory under /opt:

> cd /opt
> mkdir tectia

Ensure that the /opt/tectia directory is writable and that it is owned by the SSHD2 user:

> chmod 755 /opt/tectia
> chown SSHD2:0 /opt/tectia

Next, create the file system. You can use the CREAHFS example from opt/tectia/doc/zOS/SAMPLIB (shown below) to create a HFS file system, or CREAZFS to define and format a zFS file system.

CREAHFS:

//CREAHFS EXEC PGM=IEFBR14
//*
//* Allocate a data set for a USS file system. The space allocated, 250
//* cylinders, corresponds to about 200 MB on a 3390 device.
//*
//HFS      DD  DSN=SSZ.SRVR63.HFS,
//             UNIT=SYSALLDA,
//             SPACE=(CYL,(250,1,5)),
//             DSNTYPE=HFS,
//             DCB=(DSORG=PO),
//             DISP=(NEW,CATLG,DELETE)

To mount the file system on /opt/tectia use the MOUNHFS example from opt/tectia/doc/zOS/SAMPLIB as shown below.

MOUNHFS:

//* REPLY nn,dddd ON THE MACHINE CONSOLE TO ALLOW MOUNT
//*
//MOUNT    EXEC PGM=IKJEFT1A,DYNAMNBR=75,TIME=100,REGION=0M
//*
//* Mount the file system on an existing, empty directory
//*
//SYSPRINT DD SYSOUT=*
//SYSTSPRT DD SYSOUT=*
//SYSTERM  DD DUMMY
//SYSTSIN  DD *
  MOUNT FILESYSTEM('SSZ.SRVR63.HFS') +
    MOUNTPOINT('/opt/tectia') +
    TYPE(HFS) +
    MODE(RDWR)
/*

Note that mounting the file system causes an operator query that must be responded to. You may want to copy the mount command into the BPXPRMxx member in PARMLIB so that the file system will be mounted each time you IPL the system.

In case of zFS, to define and format the file system before mounting it, use the CREAZFS example from SAMPLIB.

CREAZFS:

//DEFINE  EXEC PGM=IDCAMS
//SYSPRINT DD  SYSOUT=*
//SYSUDUMP DD  SYSOUT=*
//AMSDUMP  DD  SYSOUT=*
//DASD0    DD  DISP=OLD,UNIT=3390,VOL=SER=VPWRKE
//SYSIN    DD  *
 DEFINE CLUSTER (NAME(SSZ.OPT1.ZFS) VOLUMES(VPWRKE) -
 LINEAR CYLINDERS(3000 1000) SHAREOPTIONS(2))
//*
//      IF DEFINE.RC = 0 THEN
//FORMAT  EXEC PGM=IOEAGFMT,REGION=0M,
//            PARM=('-aggregate SSZ.OPT1.ZFS -compat')
//SYSPRINT DD  SYSOUT=*
//STDOUT   DD  SYSOUT=*
//STDERR   DD  SYSOUT=*
//SYSUDUMP DD  SYSOUT=*
//CEEDUMP  DD  SYSOUT=*
//      ENDIF

To mount the zFS file system, you can use the MOUNHFS sample after you have modified its file system name and type.

Option 2

If you want to install the product into an existing file system, for example the one where /usr/local is mounted, make an empty directory in that file system and create a link to it under /opt:

> mkdir /usr/local/tectia_6_3_11
> ln -s /usr/local/tectia_6_3_11 /opt/tectia