test

System Administration Guide: Virtualization Using the Solaris Operating System

Administering Projects

ProcedureHow to Define a Project and View the Current Project

This example shows how to use the projadd command to add a project entry and the projmod command to alter that entry.

  1. Become superuser or assume an equivalent role.

  2. View the default /etc/project file on your system by using projects -l.


    # projects -l
system:0::::
user.root:1::::
noproject:2::::
default:3::::
group.staff:10::::system
        projid : 0
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
user.root
        projid : 1
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
noproject
        projid : 2
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
default
        projid : 3
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
group.staff
        projid : 10
        comment: ""
        users  : (none)
        groups : (none)
        attribs:

  3. Add a project with the name booksite. Assign the project to a user who is named mark with project ID number 4113.


    # projadd -U mark -p 4113 booksite

  4. View the /etc/project file again.


    # projects -l
system
        projid : 0
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
user.root
        projid : 1
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
noproject
        projid : 2
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
default
        projid : 3
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
group.staff
        projid : 10
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
booksite
        projid : 4113
        comment: ""
        users  : mark
        groups : (none)
        attribs:

  5. Add a comment that describes the project in the comment field.


    # projmod -c `Book Auction Project' booksite

  6. View the changes in the /etc/project file.


    # projects -l
system
        projid : 0
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
user.root
        projid : 1
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
noproject
        projid : 2
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
default
        projid : 3
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
group.staff
        projid : 10
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
booksite
        projid : 4113
        comment: "Book Auction Project"
        users  : mark
        groups : (none)
        attribs:
See Also

To bind projects, tasks, and processes to a pool, see Setting Pool Attributes and Binding to a Pool.

ProcedureHow to Delete a Project From the /etc/project File

This example shows how to use the projdel command to delete a project.

  1. Become superuser or assume an equivalent role.

  2. Remove the project booksite by using the projdel command.


    # projdel booksite

  3. Display the /etc/project file.


    # projects -l
system
        projid : 0
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
user.root
        projid : 1
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
noproject
        projid : 2
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
default
        projid : 3
        comment: ""
        users  : (none)
        groups : (none)
        attribs: 
group.staff
        projid : 10
        comment: ""
        users  : (none)
        groups : (none)
        attribs:

  4. Log in as user mark and type projects to view the projects that are assigned to this user.


    # su - mark
# projects
default

How to Validate the Contents of the /etc/project File

If no editing options are given, the projmod command validates the contents of the project file.

To validate a NIS map, type the following:


# ypcat project | projmod -f —

To check the syntax of the /etc/project file, type the following:


# projmod -n

How to Obtain Project Membership Information

Use the id command with the -p flag to display the current project membership of the invoking process.


$ id -p
uid=100(mark) gid=1(other) projid=3(default)

ProcedureHow to Create a New Task

  1. Log in as a member of the destination project, booksite in this example.

  2. Create a new task in the booksite project by using the newtask command with the -v (verbose) option to obtain the system task ID.


    machine% newtask -v -p booksite
16

    The execution of newtask creates a new task in the specified project, and places the user's default shell in this task.

  3. View the current project membership of the invoking process.


    machine% id -p
uid=100(mark) gid=1(other) projid=4113(booksite)

    The process is now a member of the new project.

ProcedureHow to Move a Running Process Into a New Task

This example shows how to associate a running process with a different task and new project. To perform this action, you must either be superuser, or be the owner of the process and be a member of the new project.

  1. Become superuser or assume an equivalent role.

    Note –

    If you are the owner of the process or a member of the new project, you can skip this step.

  2. Obtain the process ID of the book_catalog process.


    # pgrep book_catalog
	8100

  3. Associate process 8100 with a new task ID in the booksite project.


    # newtask -v -p booksite -c 8100
	17

    The -c option specifies that newtask operate on the existing named process.

  4. Confirm the task to process ID mapping.


    # pgrep -T 17
	8100