Installation - Linux - FreeBSD manual

Share360 Installation on UNIX (Linux/FreeBSD)

The following chapters will provide you with step-by-step instructions for installing Share360 on UNIX (Linux/FreeBSD). When completed, you should be up and running, and ready to experience the benefits of Share360.

1. System Requirements for Share360 on UNIX (Linux/FreeBSD)

If you are not familiar with using UNIX shell commands or are not confident working in the UNIX command line mode, please refer to other resources for the shell commands used during the installation of Share360 for Linux. You can also ask your system administrator for help when you install Share360 for Linux/FreeBSD.

Share360 by Cybozu is a Web-based groupware which is downloaded from the Share360 Web page and intended to be installed on your server. Because it is accessed by client PC's through Web browsers, users will enter Share360's URL to use Share360, just like they browse Internet sites, as long as they are on your network.

  1. System Requirements for Share360 on UNIX (Linux/FreeBSD):

    A Linux-based server that is TCP/IP-enabled and which has a static IP address.

    Web Server - Apache version 1.1 and above is recommended. Each user will access the server from a client PC on a network to use Share360. If you don't already have a Web server, please obtain and install one before installing Share360.

    Client PC's, equipped with Web browsers. Client PC's only need Web browsers, such as Internet Explorer or Netscape Navigator, to access Share360. Therefore, you can use Share360 in an environment where different operating systems like Windows, Mac OS and UNIX co-exist.

    See details below:

  2. Operating System:

    Linux versions 2.X and higher (only for hardware with an Intel or an Intel-compatible CPU)

    We recommend the following distributions for Linux:

    • Red Hat Linux
    • Mandrake Linux
    • SuSE Linux
    • Turbo Linux

    Note: Share360 for Linux versions 2.X and above only work on IBM PC-AT-based machines with an Intel or an Intel-compatible CPU and do not work on Cobalt Qube products with a MIPS or MIPS-based CPU. (Cobalt Qube 3 is fully supported.) Before using versions 2.X and above of Linux, please confirm your operating environment.

    FreeBSD 2.X/3.X/4X (only for hardware with an Intel or an Intel-compatible CPU).

  3. Web Server:

    Apache version 1.1 or later on the server where you will use Share360.

    If you don't have Apache or any other Web server, you will need to obtain and install one before installing Share360.

  4. Web browser environments for client PC's:

    Share360 should only be installed on a server PC; you do not need to and should not install anything on client PC's, except for a Web browser.

    Share360 can be accessed properly with the following Web browsers.

    For the PC:

    • Internet Explorer 4.0 or later
    • Netscape Navigator 4.7 or later

    Notes: With Netscape 6.0 and later, graphic files on Share360 may not display properly. We recommend Netscape Navigator 4.7.

    For the Macintosh, we recommend Netscape Navigator 4.7.

  5. For more details on system requirements, including required hardware environments, see the System Requirements.

2. Uncompress the Archives

To uncompress the archives, follow these steps:

  1. Become a superuser.

    First, switch to the "root "user with the su command. (Put "-")

    > su -

  2. Place the file you downloaded on the server's local disk, wherever it is convenient for you.

    In this example, we assume you placed the downloaded file to /tmp.

    The name of the downloaded file should be the following: s36010usl.tar.gz (Linux Version)

    Copy the downloaded file to "/tmp" (Linux Version)
    # cp s36010usl.tar.gz /tmp

    Change directory to /tmp
    # cd /tmp

  3. Uncompress the downloaded file

    Uncompress the downloaded file with GNU tar or the gzip and tar commands.

    i) With GNU-version of tar command (For Linux)
    # tar zxvf s36010usl.tar.gz

    ii) With gzip and tar command (For Linux and FreeBSD)
    # gzip -cd s36010usl.tar.gz | tar xvf -

    Then, three files, README, s360setup, and INSTALL.txt, and the directory, s360tmp will be created.

    With the "ls -l" command, check if you have correct files and directory.

    # ls -l
    total 1180
    -rw-r--r-- 1 root cybozu 4750 May 23 11:29 README
    -rw-r--r-- 1 root cybozu 5811 May 23 16:14 INSTALL.txt
    -rwxr-xr-x 1 root cybozu 28168 May 23 16:05 s360setup
    drwxr-xr-x 9 root cybozu 4096 Oct 23 2000 s360tmp

3. Run the Setup Program

To run the Share360 Setup program in UNIX, follow these steps:

  1. Run the Share360 Setup program in the directory where the directory and files you created in Step 2. are located.

    Run s360setup in the directory where you've extracted the archive.

    # ./s360setup

  2. Share360 Setup Program

    Please read the Software License Agreement and the README file carefully before using the Share360 software.

    • Press Enter.
    • If the Setup program asks you the name of the web server process owner, please refer to this FAQ in the FAQ section.

    ======= Entering the user name of the web server process owner =======

    Enter the user name of the web server process owner, and press Enter. (Normally, it is "nobody".)

    (Q: Quit)

    User name of the web server process owner :

4. Set Up the Document Root Directory

To set up the document root directory, follow these steps:

  1. You are prompted to specify the Web server document root directory. Share360 will create the directory, s360, under the document root directory. You must specify the directory that will be the Web server root URL.

    =============== Confirmation of the Document Root Directory ===============

    /var/www/html

    Are you sure that the specified directory is configured as a document root directory?
    [Y]: Yes / N: Select a different directory / Q: Quit :

  2. Enter the absolute path of the document root directory that you specify.

    If you choose to change the install directory, you need to press N(n) in the Confirmation of the Document Root Directory step, and you will need to manually set up the document root directory.

    =============== Specify the Document Root Directory ===============

    Specify the document root directory, and press Enter.
    (Q: Quit)
    Document Root Directory :

  3. If the specified directory does not exist, the Setup program displays an error message and goes back to the Specify the Document Root Directory step.

    The specified directory is invalid. Check the directory, and specify the right one.

5. Change the Install Directory

To change the install directory of Share360, follow these steps:

  1. You are prompted to specify the install directory of Share360. Share360 will create the directory, s360, under the specified directory and copy all applications into the directory. So, you must specify a CGI-executable directory here.

    =============== Confirmation of the Install Directory ===============

    /var/www/cgi-bin/s360

    To install the files in this directory, press Y or Enter.
    To install the files in a different directory, Press N.
    [Y]: Yes / N: Select a different directory / Q: Quit :

  2. If you choose to change the install directory, you must press N(n) in the Confirmation of the Install Directory step, and you will need to manually set up the install directory of Share360.

    We highly recommend that you set up (cgi executable directory)/s360 as the install directory of Share360.

    ============== Specify the Install Directory ===============

    Specify the install directory, and press Enter.

    (Q: Quit)

    Install Directory:

  3. Enter the absolute path of the install directory that you specify.

    If the specified directory does not exist, the Setup program will ask you to create it.

    The specified directory does not exist. Would you like to create the new directory?
    Y: Create the directory / N: Select a different directory :

  4. If you want to create the specified directory as the install directory, press Y(y) and then Enter.

    If the Setup program fails to create it, it displays an error message and goes back to the Specify the Install Directory step. Under the following condition, you may fail to create the directory:

    You will see the following if the parent directory of the specified directory does not exist.

    Failed to create the directory. Check the directory path, and specify the right one.

    If it failed to create the directory, the above is shown and goes to the page to enter the install directory.

6. Select Applications

To select the components to install, follow these steps:

  1. =============== Choose the Applications ===============

    [ ] 1. Share360 Complete
    [ ] 2. Share360 Standard

    [ ] 3. Share360 Scheduler
    [ ] 4. Share360 Whereabouts
    [ ] 5. Share360 Bulletin Board
    [ ] 6. Share360 WebMail
    [ ] 7. Share360 Address Book
    [ ] 8. Share360 ToDo List
    [ ] 9. Share360 Discussions
    [ ] 10. Share360 Cabinet
    [ ] 11. Share360 Memos

    [ ] 12. Share360 Project     (Note)
    [ ] 13. Share360 Web Forms

    Enter the product number (1-13) to install, and press Enter.
    Product Number (1-13) / Enter: End of Selection / Q: Quit :

  2. Enter the product number(1-13) to install, and press Enter.

    Note that Project and Web Form is not included in Share360 Standard.

    Example of the Component Selection Status:

    [X]4. Share360 Scheduler Selected
    [ ]4. Share360 Scheduler Not Selected
    []4. Share360 Scheduler Not Selectable
    (In case pack products are selected)

  3. After determining the package or the application(s) to install, press Enter.

7. Confirm Your Selections

To confirm your selections in setting up Share360 for UNIX, follow these steps:

  1. Installation settings are displayed.

    =============== Confirmation of the Share360 Installation ===============

    Document Root Directory: /home/httpd/html

    Install Directory: /home/httpd/cgi-bin/cb4

    The following application(s) will be installed.

    All Applications of Share360

    Enter Y to start installing the above application(s).
    Y: Install the applications / N: Back to Selection of the Applications / Q: Quit:

  2. If you like the settings, press Yes (y) + Enter Key and start the installation. If you press No (n) + Enter Key, you will go back to the Selecting Applications step.

    This will start the installation and lead you to the following messages:

    Creating directories...
    Copying the program files...
    Copying the image files...
    Copying the module files...
    Copying the template files for the backup...
    Copying the template files...
    Copying the data files...
    Changing the directory permissions...

8. Finish Installation

When the installation is complete, to find the directory where LICENSE and README are stored, follow these steps:

  1. For example, select /home/httpd/cgi-bin/cb4 for an install directory.

    The installation of Share360 is completed.
    Please read the License Agreement and the README file carefully before using the software.

    LICENSE and README files can be found in :

    LICENSE: /var/www/cgi-bin/s360/LICENSE
    README : /var/www/cgi-bin/s360/README

9. Confirm That It Works

To confirm that the operation was successful, follow these steps:

  1. Please read the README file again.

    You will see README and LICENSE stored in the install directory. Please read them again.

  2. Access from your PC.

    Start a web browser and access the following URL:

    http://(server hostname or IP address)/cgi-bin/s360/office.cgi?

    • For example (with IP address): 1) http://10.0.0.1/cgi-bin/s360/office.cgi?
    • For example (with hostname): 2) http://bozuman.cybozu.co.jp/cgi-bin/s360/office.cgi?

    You will access the Login page. This is the URL you will give to all users, as this is the entry page for Share360!.

  3. If you succeed in accessing to Share360, you will see the Login page. Please click the Admin Tools > General > Admin Instructions for initial settings.

    If you cannot see the Login page properly, check the following:

    • There may be spelling mistakes of the server hostname, the directory path, or the file name.
    • The install directory you specified was not the CGI executable directory.

10. Apply Basic Settings

To apply the initial settings required to run Share360 for UNIX, follow these steps:

  1. On the Login page of Share360, please apply the basic settings referred to at Basic Setting After Installation.

  2. Enjoy the speed and the power of Share360!

11. Add Applications

To add or change the applications for UNIX, follow these steps:

  1. You can add or change the applications to use in Share360 for UNIX in System Setting > Module Activation. For example, you can perform the following functions:

    • Use applications of Share360 Standard although you just tried Scheduler.
    • Add Web Forms at a later time.

    For details, please refer to Module Activation.

12. Uninstall Share360

To uninstall Share360 from UNIX (Linux/FreeBSD), follow these steps.

  1. When you installed Share360, it wrote to two directories.

    1) Document Root - /var/www/html/s360

    • Delete this completely.

    2) Where the cgi-bin is located - usually /var/www/cgi-bin/s360

    • Delete except for the file and data directories, which should be saved if you ever want to use Share360 in the future.
    • Alternatively, you can export all the data to a different format and then delete the whole directory.

[ Return to the manuals main table of contents ]